@aparte/plugin-model-selector 0.10.0 → 0.11.0

package/README.md

@@ -16,9 +16,25 @@ import '@aparte/plugin-model-selector'; // registers <aparte-model-selector>
 <aparte-model-selector auto-select persist searchable></aparte-model-selector>
 ```
 
-`@aparte/core` is the only **peer dependency**. Importing the package registers the
+`@aparte/core` is the only required **peer dependency**. Importing the package registers the
 `<aparte-model-selector>` element as a side effect.
 
+## Typed in your framework
+
+The element is typed by this package rather than by the framework wrappers, through one
+subpath per framework — so you get the binding exactly when you have the plugin:
+
+```ts
+import '@aparte/plugin-model-selector/react';   // or /vue, or /svelte — types only, no runtime
+```
+
+```ts
+// Angular needs a class claiming the selector, so it gets a directive:
+import { AparteModelSelectorDirective } from '@aparte/plugin-model-selector/angular';
+```
+
+`react`, `vue`, `svelte` and `@angular/core` are **optional** peers.
+
 | Attribute     | Effect                                                    |
 |---------------|-----------------------------------------------------------|
 | `auto-select` | Select the first available model on mount                 |

package/dist/angular.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `<aparte-model-selector>` as an Angular directive. Import it into a standalone
+ * component:
+ *
+ * ```ts
+ * import { AparteModelSelectorDirective } from '@aparte/plugin-model-selector/angular';
+ * // @Component({ imports: [AparteModelSelectorDirective], … })
+ * ```
+ *
+ * ## Why this entry point exists at all
+ *
+ * The other three frameworks learn a tag from a declaration merge, so `./react`, `./vue`
+ * and `./svelte` carry no runtime — 0.04 kB each. Angular cannot: its template compiler
+ * needs a CLASS claiming the selector, and `[persist]="true"` on a custom element writes
+ * a property, which on an attribute-driven element is a silent no-op. So this one is real
+ * code, and real code in an Angular library has to be compiled in partial-Ivy mode —
+ * which is why the build runs `ngc` for these two files and Vite for everything else.
+ *
+ * It lives here rather than in `@aparte/angular` for the reason that governs all four:
+ * a wrapper types what it depends on, and it depends on no plugin. A third-party plugin's
+ * author cannot add a directive to our wrapper, so shipping ours from there would give
+ * aparté's packages a privilege theirs could never have.
+ *
+ * `@angular/core` is an OPTIONAL peer: install this package without Angular and nothing
+ * here is reachable, which is the point — you get the binding only if you can use it.
+ */
+export { AparteModelSelectorDirective, APARTE_ELEMENT_DIRECTIVES } from './generated/element.directives.js';
+//# sourceMappingURL=angular.d.ts.map

package/dist/angular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular.d.ts","sourceRoot":"","sources":["../src/angular.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/angular.js

@@ -0,0 +1,27 @@
+/**
+ * `<aparte-model-selector>` as an Angular directive. Import it into a standalone
+ * component:
+ *
+ * ```ts
+ * import { AparteModelSelectorDirective } from '@aparte/plugin-model-selector/angular';
+ * // @Component({ imports: [AparteModelSelectorDirective], … })
+ * ```
+ *
+ * ## Why this entry point exists at all
+ *
+ * The other three frameworks learn a tag from a declaration merge, so `./react`, `./vue`
+ * and `./svelte` carry no runtime — 0.04 kB each. Angular cannot: its template compiler
+ * needs a CLASS claiming the selector, and `[persist]="true"` on a custom element writes
+ * a property, which on an attribute-driven element is a silent no-op. So this one is real
+ * code, and real code in an Angular library has to be compiled in partial-Ivy mode —
+ * which is why the build runs `ngc` for these two files and Vite for everything else.
+ *
+ * It lives here rather than in `@aparte/angular` for the reason that governs all four:
+ * a wrapper types what it depends on, and it depends on no plugin. A third-party plugin's
+ * author cannot add a directive to our wrapper, so shipping ours from there would give
+ * aparté's packages a privilege theirs could never have.
+ *
+ * `@angular/core` is an OPTIONAL peer: install this package without Angular and nothing
+ * here is reachable, which is the point — you get the binding only if you can use it.
+ */
+export { AparteModelSelectorDirective, APARTE_ELEMENT_DIRECTIVES } from './generated/element.directives.js';

package/dist/aparte-model-selector.d.ts

@@ -1,19 +1,29 @@
+import { type AparteConfig, type AparteConfigAware } from '@aparte/core';
 /**
- * Aparté Model Selector
+ * Selects an AI provider and a model. Renders an `<aparte-select>` with providers
+ * grouped into `<aparte-optgroup>`s — a single provider renders a flat list — which is
+ * what makes the BYOK pattern possible without core knowing about any vendor.
  *
- * Web Component for selecting an AI provider + model. Renders an `aparte-select`
- * primitive with providers grouped into `aparte-optgroup`s (a single provider
- * renders a flat list). Enables the BYOK (Bring Your Own Key) pattern.
+ * These tags sat at the top of the file, above the imports and a helper, so nothing
+ * read them: TypeScript associates only the comment adjacent to the declaration. This
+ * package ships no manifest of its own today (only `@aparte/core` runs `cem analyze`),
+ * so the loss was invisible to tooling — but it is also what an editor shows on hover,
+ * and what a typed framework wrapper is written from.
  *
  * @element aparte-model-selector
- * @attr {boolean} auto-select - Auto-select the first model (default: false)
- * @attr {boolean} persist - Persist the selection through the config
- * @attr {boolean} searchable - Enable search in the dropdown
- * @attr {string} placeholder - Override the placeholder text
+ * @attr {boolean} auto-select - Selects the first model as soon as one is available.
+ * @attr {boolean} persist - Writes the selection back through the config, so it survives a reload.
+ * @attr {boolean} searchable - Adds the dropdown's filter field.
+ * @attr {string} placeholder - Overrides the text shown while nothing is selected.
+ *
+ * @fires {CustomEvent<AparteModelChangeEventDetail>} aparte-model-change - The provider or the model changed; carries both ids.
  *
- * @fires aparte-model-change - Fired when the selected model changes
+ * @example
+ * <!-- Mount it in the composer's toolbar; it reads the models the config already knows. -->
+ * <aparte-composer-toolbar>
+ *   <aparte-model-selector searchable placeholder="Pick a model"></aparte-model-selector>
+ * </aparte-composer-toolbar>
  */
-import { type AparteConfig, type AparteConfigAware } from '@aparte/core';
 export declare class AparteModelSelector extends HTMLElement implements AparteConfigAware {
     private _currentProviderId;
     private _currentModelId;

package/dist/aparte-model-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-model-selector.d.ts","sourceRoot":"","sources":["../src/aparte-model-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAIH,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAOzB,MAAM,cAAc,CAAC;AAoBtB,qBAAa,mBAAoB,SAAQ,WAAY,YAAW,iBAAiB;IAC7E,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA0B;IAEjD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,CAAoC;IAEhD,OAAO,CAAC,kBAAkB,CAA6B;IAGvD,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,qBAAqB,CAA2D;IAExF,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxC,uEAAuE;IACvE,OAAO,CAAC,kBAAkB;IAgC1B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAMhB,oBAAoB,IAAI,IAAI;IAM5B;;;;;;;;OAQG;IACH,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAqB7C,wBAAwB,IAAI,IAAI;IAUhC,2BAA2B;IAC3B,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,wBAAwB;IACxB,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,0CAA0C;IAC1C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;YAgBzC,sBAAsB;YAmDtB,iBAAiB;IA2C/B,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,WAAW;IA2HnB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,uBAAuB;CAWlC;AAOD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,uBAAuB,EAAE,mBAAmB,CAAC;KAChD;CACJ"}
+{"version":3,"file":"aparte-model-selector.d.ts","sourceRoot":"","sources":["../src/aparte-model-selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAOzB,MAAM,cAAc,CAAC;AAoBtB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,mBAAoB,SAAQ,WAAY,YAAW,iBAAiB;IAC7E,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA0B;IAEjD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,CAAoC;IAEhD,OAAO,CAAC,kBAAkB,CAA6B;IAGvD,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,qBAAqB,CAA2D;IAExF,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxC,uEAAuE;IACvE,OAAO,CAAC,kBAAkB;IAgC1B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAMhB,oBAAoB,IAAI,IAAI;IAM5B;;;;;;;;OAQG;IACH,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAqB7C,wBAAwB,IAAI,IAAI;IAUhC,2BAA2B;IAC3B,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,wBAAwB;IACxB,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,0CAA0C;IAC1C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;YAgBzC,sBAAsB;YAmDtB,iBAAiB;IA2C/B,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,WAAW;IA2HnB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,uBAAuB;CAWlC;AAOD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,uBAAuB,EAAE,mBAAmB,CAAC;KAChD;CACJ"}