Add @extends annotation support for single-file components #244

Copilot · 2025-11-25T03:46:41Z

Single-file components (.cfm/.bxm) were hardcoded to extend cbwire.models.Component, preventing inheritance from custom base classes like BaseWire.

Changes

SingleFileComponentBuilder.cfc: Parse // @extends('path.to.BaseWire') annotation from script block, validate path contains only alphanumeric/dots/underscores
EmptySingleFileComponent.cfc/.bx: Replace hardcoded extends with {{ EXTENDS_PATH }} placeholder
Tests: Added CFML and BoxLang test cases

Usage

<cfoutput>
    <div>Counter: #count#</div>
</cfoutput>

<cfscript>
// @extends('wires.BaseWire')
// @startWire
    data = { "count": 0 };
// @endWire
</cfscript>

Supports single quotes, double quotes, or no quotes. Defaults to cbwire.models.Component when annotation is absent.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

downloads.ortussolutions.com
- Triggering command: /usr/bin/curl curl -fsSL REDACTED -o /tmp/commandbox.zip (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

This section details on the original issue you should resolve

<issue_title>Add the ability to extend other components such as a BaseWire using the // @extends('path.to.BaseWire') comment annotation</issue_title>
<issue_description>There is a limitation currently with single-file components (wires that are defined within either a .bxm or .cfm file) in that you are unable to extend your component/wire with something other than "cbwire.models.Component". This limitation has to do with the face that single file components are parsed and broken up into their separate class/component and template files from the models/SingleFileComponentBuilder.cfc component, and this component always populates extends with "cbwire.models.Component".

We need to add the ability to extend any functionality from a single file component using a syntax similar to the one below.

Single-file component (Counter.cfm)
<cfoutput>
    <div>Counter goes here</div>
</cfoutput>

<cfscript>
// @extends('wires.BaseWire')
// @startWire

// @endWire
</cfscript>
In BoxLang this would be:
<bx:output>
    <div>Counter goes here</div>
</bx:output>

<bx:script>
// @extends('wires.BaseWire')
// @startWire

// @endWire
</bx:script>
If // @extends() is not provided, then we want to keep the existing functionality of extending 'cbwire.models.Component' by default.

</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes Add @extends annotation support for single-file components #243

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: grantcopley <1197835+grantcopley@users.noreply.github.com>

github-actions · 2025-11-25T06:06:41Z