@aparte/svelte 0.10.0 → 0.12.0

package/README.md

@@ -42,7 +42,10 @@ npm install @aparte/svelte @aparte/core svelte
 The user's message is appended automatically on send — don't add it yourself. `on:messageSent` is
 optional and only for side-effects (scroll, analytics).
 
-`@aparte/core` and `svelte` are **peer dependencies**. For any `<aparte-*>` element without a
-dedicated component, the generic `<AparteUi name="aparte-…" />` escape hatch mounts it.
+`@aparte/core` and `svelte` are **peer dependencies**.
+
+Every `<aparte-*>` tag is declared through `SvelteHTMLElements`, so `svelte-check` covers its
+attributes and its `on:` handlers. `<AparteUi name="my-widget" />` remains for an element aparté does
+not define.
 
 > ESM-only. See the docs for the full API. Part of the aparté monorepo.

package/dist/index.d.ts

@@ -14,4 +14,40 @@ export { createConversationManager } from './stores/conversationManager.js';
 export { default as AparteUi } from './AparteUi.svelte';
 export type { AparteUiProps, AparteUiHandle } from './types.js';
 export type { AparteMessage, AparteSendEventDetail, AparteActionEventDetail, AparteSegment, AparteTextSegment, AparteCodeSegment, AparteThinkingSegment } from './types.js';
+import type { HTMLAttributes } from 'svelte/elements';
+import type { AparteElementAttributes, AparteElementTagName, AparteTemplateAttrs, AparteUiEventName } from '@aparte/core';
+/**
+ * Svelte's `on:` handlers, for every event aparté dispatches.
+ *
+ * Derived from TWO sources, and it needs both. `HTMLElementEventMap` — which
+ * `@aparte/core` augments — carries the events with a detail. It deliberately omits the
+ * five that have none (`aparte-cancel`, `aparte-composer-submit`, `aparte-reset-done`,
+ * `aparte-select-open`, `aparte-select-close`), because a map entry would type
+ * `e.detail` as `null` and gain nothing.
+ *
+ * That omission was harmless while it only governed `addEventListener`. Declaring the
+ * tags here made it a regression: `SvelteHTMLElements` used to end in a catch-all index
+ * signature that accepted any `on:` name, and narrowing the tags removed it — so
+ * `on:aparte-cancel`, the STOP BUTTON, stopped type-checking. A typed surface that takes
+ * a capability away is worse than no typed surface.
+ *
+ * `AparteUiEventName` closes it: core's proxy list already enumerates every event an
+ * element dispatches on itself, those five included, and it is the list `AparteUi`
+ * forwards — so the two are the same set by construction. Still no hand-written list
+ * here, which is the property that mattered.
+ */
+type AparteEventName = Extract<keyof HTMLElementEventMap, `aparte-${string}`>;
+type AparteAnyEventName = AparteEventName | AparteUiEventName;
+/** The typed event for a name, or a detail-free `CustomEvent` when the map has none. */
+type AparteEventFor<K extends string> = K extends keyof HTMLElementEventMap ? HTMLElementEventMap[K] : CustomEvent<null>;
+type AparteSvelteHandlers = {
+    [K in AparteAnyEventName as `on:${K}`]?: (event: AparteEventFor<K>) => void;
+};
+type AparteSvelteElements = {
+    [K in AparteElementTagName]: HTMLAttributes<HTMLElement> & AparteTemplateAttrs<AparteElementAttributes[K]> & AparteSvelteHandlers;
+};
+declare module 'svelte/elements' {
+    interface SvelteHTMLElements extends AparteSvelteElements {
+    }
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAK9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EACR,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACxB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAK9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EACR,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACxB,MAAM,YAAY,CAAC;AAiBpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE1H;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,eAAe,GAAG,OAAO,CAAC,MAAM,mBAAmB,EAAE,UAAU,MAAM,EAAE,CAAC,CAAC;AAC9E,KAAK,kBAAkB,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE9D,wFAAwF;AACxF,KAAK,cAAc,CAAC,CAAC,SAAS,MAAM,IAChC,CAAC,SAAS,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAErF,KAAK,oBAAoB,GAAG;KACvB,CAAC,IAAI,kBAAkB,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI;CAC9E,CAAC;AAEF,KAAK,oBAAoB,GAAG;KACvB,CAAC,IAAI,oBAAoB,GACtB,cAAc,CAAC,WAAW,CAAC,GACzB,mBAAmB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,GAC/C,oBAAoB;CAC7B,CAAC;AAEF,OAAO,QAAQ,iBAAiB,CAAC;IAC7B,UAAU,kBAAmB,SAAQ,oBAAoB;KAAG;CAC/D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aparte/svelte",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Svelte wrapper for aparté — an ergonomic <AparteChat> component plus stores over the framework-agnostic web components. Works on Svelte 4 and 5.",
   "type": "module",
   "sideEffects": false,
@@ -51,7 +51,7 @@
     "svelte2tsx": "^0.7.61",
     "typescript": "^5.4.0",
     "vite": "^6.0.0",
-    "@aparte/core": "0.10.0"
+    "@aparte/core": "0.12.0"
   },
   "keywords": [
     "svelte",