@aparte/react 0.9.0 → 0.11.0

package/README.md

@@ -27,7 +27,9 @@ function Chat() {
 The user's message is appended automatically on send — don't add it yourself. `onMessageSent` is
 optional and only for side-effects (scroll, analytics).
 
-`@aparte/core`, `react` and `react-dom` are **peer dependencies**. For any `<aparte-*>` element
-without a dedicated component, the generic `<AparteUi name="aparte-…" />` escape hatch mounts it.
+`@aparte/core`, `react` and `react-dom` are **peer dependencies**.
+
+Every `<aparte-*>` tag is a **typed JSX intrinsic** — real attributes, checked by the compiler, no
+registration. `<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

@@ -13,18 +13,44 @@ export { useConversationManager } from './hooks/useConversationManager.js';
 export type { UseConversationManager } from './hooks/useConversationManager.js';
 export { AparteUi } from './components/AparteUi.js';
 export type { AparteUiProps, AparteUiHandle } from './components/AparteUi.js';
-export type { AparteMessage, AparteSendEventDetail, AparteActionEventDetail, AparteSegment, AparteTextSegment, AparteCodeSegment, AparteThinkingSegment, AparteTerminalSegment, } from './types.js';
-interface AparteIntrinsicElements {
-    'aparte-chat-viewport': any;
-    'aparte-chat-bubble': any;
-    'aparte-chat-status': any;
-    'aparte-composer': any;
-    'aparte-composer-attachments': any;
-    'aparte-composer-add-attachment': any;
-    'aparte-composer-input': any;
-    'aparte-composer-send': any;
-    'aparte-composer-toolbar': any;
-}
+export type { AparteMessage, AparteSendEventDetail, AparteActionEventDetail, AparteSegment, AparteTextSegment, AparteCodeSegment, AparteThinkingSegment, } from './types.js';
+import type { AparteElementAttributes, AparteElementTagName, AparteTemplateAttrs } from '@aparte/core';
+import type * as React from 'react';
+/**
+ * One attribute, as React must write it.
+ *
+ * A presence attribute becomes `'' | undefined`, not `boolean`, and that is not
+ * pedantry: React stringifies what it sets on a custom element, so `disabled={false}`
+ * would render `disabled="false"` — and an element that tests `hasAttribute` reads
+ * that as ON. The wrapper's own bubble rendering already uses this idiom
+ * (`streaming={isAwaitingReply(m) ? '' : undefined}`); the type now enforces it.
+ *
+ * A numeric attribute accepts a number or the string it will become, because both
+ * read naturally in JSX.
+ */
+/**
+ * An aparté tag in JSX: the standard HTML props, plus the element's own attributes.
+ *
+ * `Omit` puts the ELEMENT's contract first where the two collide, and one collision is
+ * real: `<aparte-chat-bubble role="assistant">` is the message role, while React types
+ * `role` as an `AriaRole` union. Intersecting them would leave no assignable value at
+ * all, so the element wins and ARIA's narrower type steps aside.
+ */
+type AparteTagProps<T> = Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, keyof T> & AparteTemplateAttrs<T>;
+/**
+ * Derived from `AparteElementAttributes` rather than listed, so the set cannot drift:
+ * an element added to core is typed here the moment it is added to that registry, and
+ * one removed from it stops being valid JSX. Listing them by hand is what let nine of
+ * eighteen be the whole story.
+ *
+ * Events are not here on purpose. React has no prop form for a custom event, so a
+ * consumer reaches them by ref — and `HTMLElementEventMap` is already augmented by
+ * `@aparte/core`, so `el.addEventListener('aparte-select-change', e => e.detail.value)`
+ * is typed with nothing further from this package.
+ */
+type AparteIntrinsicElements = {
+    [K in AparteElementTagName]: AparteTagProps<AparteElementAttributes[K]>;
+};
 declare global {
     namespace JSX {
         interface IntrinsicElements extends AparteIntrinsicElements {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAKlE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE9E,YAAY,EACR,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AASpB,UAAU,uBAAuB;IAE7B,sBAAsB,EAAE,GAAG,CAAC;IAE5B,oBAAoB,EAAE,GAAG,CAAC;IAE1B,oBAAoB,EAAE,GAAG,CAAC;IAE1B,iBAAiB,EAAE,GAAG,CAAC;IAEvB,6BAA6B,EAAE,GAAG,CAAC;IAEnC,gCAAgC,EAAE,GAAG,CAAC;IAEtC,uBAAuB,EAAE,GAAG,CAAC;IAE7B,sBAAsB,EAAE,GAAG,CAAC;IAE5B,yBAAyB,EAAE,GAAG,CAAC;CAClC;AAED,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAkB,SAAQ,uBAAuB;SAAG;KACjE;CACJ;AAED,OAAO,QAAQ,OAAO,CAAC;IAEnB,UAAU,GAAG,CAAC;QACV,UAAU,iBAAkB,SAAQ,uBAAuB;SAAG;KACjE;CACJ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAKlE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE9E,YAAY,EACR,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGvG,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAgBpC;;;;;;;;;;;GAWG;AACH;;;;;;;GAOG;AACH,KAAK,cAAc,CAAC,CAAC,IACjB,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,GACpF,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,KAAK,uBAAuB,GAAG;KAC1B,CAAC,IAAI,oBAAoB,GAAG,cAAc,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAkB,SAAQ,uBAAuB;SAAG;KACjE;CACJ;AAED,OAAO,QAAQ,OAAO,CAAC;IAEnB,UAAU,GAAG,CAAC;QACV,UAAU,iBAAkB,SAAQ,uBAAuB;SAAG;KACjE;CACJ"}

package/dist/types.d.ts

@@ -4,5 +4,5 @@
  * WITHOUT `targetId`, which the composer actually sends (multi-instance scoping);
  * re-export the canonical one so the field isn't silently dropped from the type.
  */
-export type { AparteMessage, AparteSegment, AparteTextSegment, AparteCodeSegment, AparteThinkingSegment, AparteTerminalSegment, AparteSendEventDetail, AparteActionEventDetail, } from '@aparte/core';
+export type { AparteMessage, AparteSegment, AparteTextSegment, AparteCodeSegment, AparteThinkingSegment, AparteSendEventDetail, AparteActionEventDetail, } from '@aparte/core';
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EACR,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GAC1B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EACR,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GAC1B,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aparte/react",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "React 18+ wrapper for aparté — an ergonomic <AparteChat> component plus hooks over the framework-agnostic web components.",
   "type": "module",
   "sideEffects": false,
@@ -39,7 +39,7 @@
     "react-dom": "^19.2.7",
     "typescript": "^5.4.0",
     "vite": "^6.0.0",
-    "@aparte/core": "0.9.0"
+    "@aparte/core": "0.11.0"
   },
   "keywords": [
     "react",