@adia-ai/web-components 0.4.9 → 0.5.1

package/core/data-stream.d.ts

@@ -0,0 +1,56 @@
+/**
+ * data-stream — attribute-driven data ingestion, signal-backed.
+ *
+ * Public API surface: read the shared registry (`streams`) or await a
+ * stream's registration (`whenStream`). The internal MutationObserver
+ * + transport machinery (HTTP / SSE / WS / JSON / CSV / TSV / JSONL /
+ * text) is implementation-only — consumers see the signal + the events
+ * (`stream-load`, `stream-error`) on the element.
+ *
+ * @see ../USAGE.md
+ */
+
+import type { ReadonlySignal, Signal } from './signals.js';
+
+/**
+ * One entry in the shared streams registry. `signal.value` carries the
+ * parsed payload (shape depends on the transport's `parse` option).
+ * `refs` is the active subscriber count; the registry tears the entry
+ * down when it returns to 0.
+ */
+export interface StreamEntry {
+  /** Signal whose `.value` carries the parsed payload. Subscribe with `effect()`. */
+  signal: ReadonlySignal<unknown>;
+  /** Active subscriber count. */
+  refs: number;
+  /** Transport metadata — opaque to consumers. */
+  transport: unknown;
+  /** Resolved options for the stream — opaque to consumers. */
+  opts: unknown;
+}
+
+/**
+ * Read-only public view of the streams registry. App code can do:
+ *
+ *     import { streams } from '@adia-ai/web-components/core/data-stream';
+ *     streams.get('rev')?.signal.value
+ *
+ * Subscribe via `effect()` on the entry's `signal`.
+ */
+export const streams: {
+  get(id: string): StreamEntry | undefined;
+  has(id: string): boolean;
+  keys(): MapIterator<string>;
+  size(): number;
+};
+
+/**
+ * Resolves with the stream entry once it's registered. If the stream
+ * already exists, resolves synchronously on the next microtask; if not,
+ * resolves the moment the first DOM consumer (or any caller of
+ * acquireStream) creates it. Useful for cross-package adapters
+ * (streams-bridge, A2UI surfaces) that may run before the DOM source
+ * has connected. The promise never rejects — pair with AbortSignal at
+ * the caller if you need cancellation.
+ */
+export function whenStream(id: string): Promise<StreamEntry>;

package/core/element.d.ts

@@ -13,6 +13,16 @@
 import type { ReadonlySignal, Signal } from './signals.js';
 import type { TemplateResult } from './template.js';
 
+// Mirror the runtime re-exports from element.js so a single import of
+// `@adia-ai/web-components/core/element` resolves both the UIElement
+// class AND the reactive/template helpers — matches the canonical
+// pattern documented in USAGE.md and the `element.js` runtime export
+// surface. Closes FEEDBACK-05 P1 (drift caught post-v0.4.9 upgrade).
+export { signal, computed, effect, batch, untracked, isSignal } from './signals.js';
+export type { ReadonlySignal, Signal, ComputedSignal, EffectOptions, EffectDisposer } from './signals.js';
+export { html, css, repeat } from './template.js';
+export type { TemplateResult } from './template.js';
+
 /** Property declaration in a component's `static properties = { … }` map. */
 export interface PropertyConfig<T = unknown> {
   /** Coercion target — `Boolean`, `Number`, `String`, or custom. */

package/core/index.d.ts

@@ -9,3 +9,9 @@ export * from './template.js';
 export * from './element.js';
 export * from './form.js';
 export * from './register.js';
+// Mirror the explicit re-export in core/index.js — `streams` + `whenStream`
+// (the public surface of the data-stream attribute-driven ingestion module).
+// `export *` from data-stream.js would also expose internals; keep the
+// explicit form so the type barrel matches the runtime exactly.
+export { streams, whenStream } from './data-stream.js';
+export type { StreamEntry } from './data-stream.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-components",
-  "version": "0.4.9",
+  "version": "0.5.1",
   "description": "AdiaUI web components — vanilla custom elements. A2UI runtime (renderer, registry, streams, wiring) lives in @adia-ai/a2ui-runtime.",
   "type": "module",
   "types": "./index.d.ts",
@@ -58,7 +58,7 @@
     "./core/icons-phosphor.js"
   ],
   "dependencies": {
-    "@adia-ai/a2ui-runtime": "^0.4.0"
+    "@adia-ai/a2ui-runtime": "^0.5.0"
   },
   "publishConfig": {
     "access": "public",