@fleetx_io/ai-ui-dsl 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-03-27
+
+### Added
+
+- TypeScript types for block-based assistant UI: `Message`, `Conversation`, block variants (`text`, `chart`, `table`, `form`, `action`, `widget`, `tool_use`, `tool_result`, `step`, `loading`, `error`, `map`), and related helpers.
+- Streaming protocol types: `StreamEvent` variants and `StreamEventCallbacks`.
+- Delta types: `text_delta`, `input_json_delta`, `json_patch`, `html_delta`, `status_delta`, `loading_message`.
+- Pure reducers: `messageReducer`, `applyDelta`, `createEmptyMessage`, `setByPath`.
+- Type guard: `isBlockType`.
+- **ESM-only** package (`"type": "module"`), Node 20+.
+- `exports` map for the package entry point.

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2025 Satish Kumar
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @fleetx_io/ai-ui-dsl
+
+**FleetX AI UI DSL** — a domain-specific language for **block-based, streaming AI chat UIs**. Assistant replies are a `Message` made of an ordered list of **Blocks** (text, charts, tables, maps, forms, actions, tools, etc.), updated through a small streaming protocol.
+
+This npm package ships **TypeScript types** and **pure reducers** (`messageReducer`, `applyDelta`, …). It is **framework-agnostic** (no React/Vue).
+
+## Install
+
+```bash
+npm install @fleetx_io/ai-ui-dsl
+```
+
+## Core ideas
+
+1. **Block composition** — One message = a flat list of blocks; blocks are not nested.
+2. **Incremental streaming** — Each block follows `block_start → block_delta (0..N) → block_end` (or `block_error`).
+3. **Immutable reducers** — Feed `StreamEvent`s into `messageReducer`; render the resulting `Message`.
+
+### Server → client flow
+
+```
+message_start  →  create / bind Message
+block_start    →  append Block (status streaming)
+block_delta    →  applyDelta → re-render
+block_end      →  mark Block completed
+…
+message_end    →  mark Message completed
+```
+
+## Block types (summary)
+
+| Block           | `type`        | Typical streaming                          |
+| --------------- | ------------- | ------------------------------------------ |
+| Text            | `text`        | `text_delta` (append to `content`)         |
+| Chart           | `chart`       | `json_patch` on Highcharts `config`        |
+| Table           | `table`       | `json_patch` (e.g. rows)                   |
+| Form            | `form`        | Often static at start; optional `json_patch` |
+| Action          | `action`      | Static                                     |
+| Widget          | `widget`      | `html_delta` (sandboxed HTML)              |
+| Tool use/result | `tool_use` / `tool_result` | `input_json_delta` / `json_patch` |
+| Step            | `step`        | `json_patch` on steps                      |
+| Loading         | `loading`     | `loading_message`                          |
+| Error           | `error`       | Static                                     |
+| Map             | `map`         | `json_patch` markers, polylines, polygons  |
+
+## Streaming protocol (summary)
+
+**Events:** `message_start`, `block_start`, `block_delta`, `block_end`, `block_error`, `message_end` (includes `messageId`).
+
+**Deltas:** `text_delta`, `input_json_delta`, `json_patch`, `html_delta`, `status_delta`, `loading_message`. Which block uses which delta is summarized in the table above.
+
+## Usage
+
+```ts
+import {
+    createEmptyMessage,
+    messageReducer,
+    type StreamEvent,
+} from '@fleetx_io/ai-ui-dsl';
+
+let message = createEmptyMessage();
+
+for await (const event of streamEvents) {
+    message = messageReducer(message, event);
+    // renderMessage(message);
+}
+```
+
+Synchronous replay:
+
+```ts
+const events: StreamEvent[] = [
+    { type: 'message_start', message: { id: 'm1', role: 'assistant' } },
+    { type: 'block_start', block: { id: 'b1', type: 'text', content: '' } },
+    { type: 'block_delta', blockId: 'b1', delta: { type: 'text_delta', text: 'Hi' } },
+    { type: 'block_end', blockId: 'b1' },
+    { type: 'message_end', messageId: 'm1' },
+];
+
+for (const event of events) {
+    message = messageReducer(message, event);
+}
+```
+
+### Package exports
+
+The package is **ESM-only** (`"type": "module"`): use `import` in Node 20+ or bundlers (e.g. Vite). Plain CommonJS `require()` is not supported.
+
+Types: `Block`, block variants, `Message`, `Conversation`, `Delta`, `StreamEvent`, streaming callbacks, etc.
+
+Functions: `messageReducer`, `applyDelta`, `createEmptyMessage`, `setByPath`, and `isBlockType`.
+
+## UI Composer Agent (concept)
+
+A **UI Composer Agent** is an LLM layer that does **not** call tools: it takes tool results plus context and returns **`{ blocks: Block[] }`** in this DSL. An **orchestrator** then turns those blocks into an SSE stream (`block_start`, deltas, `block_end`) for the client. Composition heuristics (e.g. open with a short text block, use charts or maps instead of raw JSON in prose, end with suggested actions) are up to your server-side prompt and validation schema.
+
+## Playground
+
+Requires **Node 20+**. From the repository root:
+
+```bash
+npm install
+npm run build
+npm run playground
+```
+
+Starts a **Vite** dev server that steps through a canned `StreamEvent` script and shows the reduced `Message` state.
+
+## License
+
+ISC.

package/dist/blocks.d.ts

@@ -0,0 +1,134 @@
+export type BlockStatus = 'streaming' | 'completed' | 'error';
+export type BaseBlock = {
+    id: string;
+    type: string;
+    status?: BlockStatus;
+    priority?: number;
+    createdAt?: number;
+    metadata?: Record<string, unknown>;
+};
+export type TextBlock = BaseBlock & {
+    type: 'text';
+    content: string;
+    format?: 'markdown' | 'plain';
+};
+export type ChartLibrary = 'highcharts';
+export type ChartBlock = BaseBlock & {
+    type: 'chart';
+    library: ChartLibrary;
+    config: Record<string, unknown>;
+    title?: string;
+};
+export type TableColumn = {
+    key: string;
+    label: string;
+};
+export type TableBlock = BaseBlock & {
+    type: 'table';
+    columns: TableColumn[];
+    rows: Record<string, unknown>[];
+};
+/**
+ * Form block whose `schema` is a standard JSON Schema (draft-07) object.
+ * The renderer interprets `properties`, `required`, `type`, `format`, `enum`,
+ * and the `x-widget` / `x-options` extensions for domain-specific controls.
+ *
+ * An optional `uiSchema` (JSON Forms UI Schema) controls layout
+ * (VerticalLayout, HorizontalLayout, Group).  When omitted the renderer
+ * auto-generates a single-column vertical layout from `schema.properties`.
+ */
+export type FormBlock = BaseBlock & {
+    type: 'form';
+    schema: Record<string, unknown>;
+    uiSchema?: Record<string, unknown>;
+    submitAction: string;
+    submitLabel?: string;
+};
+export type ActionItem = {
+    id: string;
+    label: string;
+    payload: string;
+};
+export type ActionBlock = BaseBlock & {
+    type: 'action';
+    actions: ActionItem[];
+};
+export type WidgetBlock = BaseBlock & {
+    type: 'widget';
+    html: string;
+    sandbox?: boolean;
+};
+export type ToolUseStatus = 'pending' | 'running' | 'completed';
+export type ToolUseBlock = BaseBlock & {
+    type: 'tool_use';
+    name: string;
+    input: unknown;
+    toolStatus?: ToolUseStatus;
+};
+export type ToolResultBlock = BaseBlock & {
+    type: 'tool_result';
+    toolUseId: string;
+    result: unknown;
+};
+export type StepItemStatus = 'pending' | 'running' | 'completed';
+export type StepItem = {
+    id: string;
+    title: string;
+    description?: string;
+    status: StepItemStatus;
+};
+export type StepBlock = BaseBlock & {
+    type: 'step';
+    items: StepItem[];
+};
+export type LoadingBlock = BaseBlock & {
+    type: 'loading';
+    message?: string;
+};
+export type ErrorBlock = BaseBlock & {
+    type: 'error';
+    message: string;
+    retryable?: boolean;
+};
+/** [latitude, longitude] */
+export type LatLng = [number, number];
+export type MapProvider = 'leaflet' | 'google';
+export type MapMarker = {
+    id: string;
+    position: LatLng;
+    label?: string;
+    icon?: string;
+    metadata?: Record<string, unknown>;
+};
+export type MapPolyline = {
+    id: string;
+    path: LatLng[];
+    color?: string;
+    width?: number;
+};
+export type MapPolygon = {
+    id: string;
+    path: LatLng[];
+    color?: string;
+    fillOpacity?: number;
+};
+export type MapBlockOptions = {
+    clustering?: boolean;
+    fitBounds?: boolean;
+};
+export type MapBlock = BaseBlock & {
+    type: 'map';
+    provider: MapProvider;
+    center: LatLng;
+    zoom: number;
+    markers?: MapMarker[];
+    polylines?: MapPolyline[];
+    polygons?: MapPolygon[];
+    options?: MapBlockOptions;
+};
+export type Block = TextBlock | ChartBlock | TableBlock | FormBlock | ActionBlock | WidgetBlock | ToolUseBlock | ToolResultBlock | StepBlock | LoadingBlock | ErrorBlock | MapBlock;
+export type BlockType = Block['type'];
+export declare function isBlockType<T extends BlockType>(block: Block, type: T): block is Extract<Block, {
+    type: T;
+}>;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.ts"],"names":[],"mappings":"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"}

package/dist/blocks.js

@@ -0,0 +1,6 @@
+// ─── Block Status ────────────────────────────────────────────────────────────
+// ─── Type Guards ─────────────────────────────────────────────────────────────
+export function isBlockType(block, type) {
+    return block.type === type;
+}
+//# sourceMappingURL=blocks.js.map

package/dist/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../src/blocks.ts"],"names":[],"mappings":"AAAA,gFAAgF;AA0MhF,gFAAgF;AAEhF,MAAM,UAAU,WAAW,CAAsB,KAAY,EAAE,IAAO;IAClE,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC/B,CAAC"}

package/dist/deltas.d.ts

@@ -0,0 +1,28 @@
+export type TextDelta = {
+    type: 'text_delta';
+    text: string;
+};
+export type InputJsonDelta = {
+    type: 'input_json_delta';
+    partial_json: string;
+};
+export type JsonPatchDelta = {
+    type: 'json_patch';
+    path: string;
+    value: unknown;
+};
+export type HtmlDelta = {
+    type: 'html_delta';
+    html: string;
+};
+export type StatusDelta = {
+    type: 'status_delta';
+    status: string;
+};
+export type LoadingMessageDelta = {
+    type: 'loading_message';
+    message: string;
+};
+export type Delta = TextDelta | InputJsonDelta | JsonPatchDelta | HtmlDelta | StatusDelta | LoadingMessageDelta;
+export type DeltaType = Delta['type'];
+//# sourceMappingURL=deltas.d.ts.map

package/dist/deltas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.d.ts","sourceRoot":"","sources":["../src/deltas.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAEhH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC"}

package/dist/deltas.js

@@ -0,0 +1,3 @@
+// ─── Deltas ──────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=deltas.js.map

package/dist/deltas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.js","sourceRoot":"","sources":["../src/deltas.ts"],"names":[],"mappings":"AAAA,gFAAgF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { BaseBlock, BlockStatus, TextBlock, ChartBlock, ChartLibrary, TableBlock, TableColumn, FormBlock, ActionBlock, ActionItem, WidgetBlock, ToolUseBlock, ToolUseStatus, ToolResultBlock, StepBlock, StepItem, StepItemStatus, LoadingBlock, ErrorBlock, MapBlock, LatLng, MapProvider, MapMarker, MapPolyline, MapPolygon, MapBlockOptions, Block, BlockType, } from './blocks.js';
+export { isBlockType } from './blocks.js';
+export type { Message, MessageStatus, MessageRole, Conversation, UserMessageMetadata } from './message.js';
+export type { TextDelta, InputJsonDelta, JsonPatchDelta, HtmlDelta, StatusDelta, LoadingMessageDelta, Delta, DeltaType, } from './deltas.js';
+export type { MessageStartEvent, BlockStartEvent, BlockDeltaEvent, BlockEndEvent, BlockErrorEvent, MessageEndEvent, StreamEvent, StreamEventType, StreamEventCallbacks, } from './streaming.js';
+export { applyDelta, messageReducer, createEmptyMessage, setByPath } from './reducers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACR,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAS,EACT,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,KAAK,EACL,SAAS,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3G,YAAY,EACR,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,KAAK,EACL,SAAS,GACZ,MAAM,aAAa,CAAC;AAGrB,YAAY,EACR,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,EACX,eAAe,EACf,oBAAoB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// ─── @fleetx_io/ai-ui-dsl ────────────────────────────────────────────────────
+// FleetX AI UI DSL — Block-based streaming UI protocol
+// ─────────────────────────────────────────────────────────────────────────────
+export { isBlockType } from './blocks.js';
+// Reducers & Helpers
+export { applyDelta, messageReducer, createEmptyMessage, setByPath } from './reducers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAkChF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8B1C,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/message.d.ts

@@ -0,0 +1,36 @@
+import type { Block } from './blocks.js';
+export type MessageStatus = 'streaming' | 'completed' | 'error';
+export type MessageRole = 'user' | 'assistant' | 'system';
+/**
+ * Convention for `Message.metadata` on **user** turns sent to the agent (`POST` body `messages`).
+ * Other keys may be added; `type` discriminates the shape.
+ */
+export type UserMessageMetadata = {
+    type: 'text';
+} | {
+    type: 'form_submission';
+    /** Same intent as FormBlock.submitAction (e.g. `report-generator`). */
+    formId: string;
+    data: Record<string, unknown>;
+    /** Assistant message id that contained the submitted form. */
+    sourceMessageId?: string;
+};
+export type Message = {
+    id: string;
+    role: MessageRole;
+    blocks: Block[];
+    status: MessageStatus;
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+};
+export type Conversation = {
+    id: string;
+    title?: string;
+    messages: Message[];
+    createdAt: number;
+    updatedAt: number;
+    /** Sidebar section label, e.g. "Today" */
+    group?: string;
+    metadata?: Record<string, unknown>;
+};
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAIN,MAAM,MAAM,OAAO,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC"}

package/dist/message.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":""}

package/dist/reducers.d.ts

@@ -0,0 +1,27 @@
+import type { Block } from './blocks.js';
+import type { Delta } from './deltas.js';
+import type { Message } from './message.js';
+import type { StreamEvent } from './streaming.js';
+/**
+ * Set a value at a dot-notation path on an object, supporting bracket syntax
+ * for array indices (e.g. "items[0].status", "config.series[0].data").
+ *
+ * Mutates `target` in place and returns it for convenience.
+ */
+export declare function setByPath(target: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
+/**
+ * Apply a single Delta to a Block, returning a **new** block (immutable).
+ */
+export declare function applyDelta(block: Block, delta: Delta): Block;
+/**
+ * Pure reducer: given the current Message state and a StreamEvent,
+ * returns the next Message state.
+ *
+ * This is the core state machine for processing a streaming response.
+ */
+export declare function messageReducer(state: Message, event: StreamEvent): Message;
+/**
+ * Create an empty Message suitable as the initial state for `messageReducer`.
+ */
+export declare function createEmptyMessage(id?: string): Message;
+//# sourceMappingURL=reducers.d.ts.map

package/dist/reducers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducers.d.ts","sourceRoot":"","sources":["../src/reducers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAsD,MAAM,aAAa,CAAC;AAC7F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AAInE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAehH;AAqBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAwC5D;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAqC1E;AAWD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAQvD"}

package/dist/reducers.js

@@ -0,0 +1,136 @@
+// ─── JSON Path Helpers ───────────────────────────────────────────────────────
+/**
+ * Set a value at a dot-notation path on an object, supporting bracket syntax
+ * for array indices (e.g. "items[0].status", "config.series[0].data").
+ *
+ * Mutates `target` in place and returns it for convenience.
+ */
+export function setByPath(target, path, value) {
+    const segments = parsePath(path);
+    let current = target;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const seg = segments[i];
+        if (current[seg] === undefined || current[seg] === null) {
+            const nextSeg = segments[i + 1];
+            current[seg] = typeof nextSeg === 'number' ? [] : {};
+        }
+        current = current[seg];
+    }
+    current[segments[segments.length - 1]] = value;
+    return target;
+}
+function parsePath(path) {
+    const segments = [];
+    const parts = path.split('.');
+    for (const part of parts) {
+        const bracketMatch = part.match(/^([^\[]*)\[(\d+)\]$/);
+        if (bracketMatch) {
+            if (bracketMatch[1])
+                segments.push(bracketMatch[1]);
+            segments.push(Number(bracketMatch[2]));
+        }
+        else {
+            segments.push(part);
+        }
+    }
+    return segments;
+}
+// ─── Delta Reducers ──────────────────────────────────────────────────────────
+/**
+ * Apply a single Delta to a Block, returning a **new** block (immutable).
+ */
+export function applyDelta(block, delta) {
+    switch (delta.type) {
+        case 'text_delta': {
+            const b = block;
+            return { ...b, content: (b.content ?? '') + delta.text };
+        }
+        case 'input_json_delta': {
+            const b = block;
+            const buffer = (b._inputBuffer ?? '') + delta.partial_json;
+            try {
+                return { ...b, input: JSON.parse(buffer), _inputBuffer: buffer };
+            }
+            catch {
+                return { ...b, _inputBuffer: buffer };
+            }
+        }
+        case 'json_patch': {
+            const clone = structuredClone(block);
+            setByPath(clone, delta.path, delta.value);
+            return clone;
+        }
+        case 'html_delta': {
+            const b = block;
+            return { ...b, html: (b.html ?? '') + delta.html };
+        }
+        case 'status_delta': {
+            return { ...block, status: delta.status };
+        }
+        case 'loading_message': {
+            const b = block;
+            return { ...b, message: delta.message };
+        }
+        default:
+            return block;
+    }
+}
+// ─── Message Reducer ─────────────────────────────────────────────────────────
+/**
+ * Pure reducer: given the current Message state and a StreamEvent,
+ * returns the next Message state.
+ *
+ * This is the core state machine for processing a streaming response.
+ */
+export function messageReducer(state, event) {
+    switch (event.type) {
+        case 'message_start':
+            return {
+                ...state,
+                id: event.message.id,
+                role: event.message.role,
+                status: 'streaming',
+            };
+        case 'block_start':
+            return {
+                ...state,
+                blocks: [...state.blocks, { ...event.block, status: 'streaming' }],
+            };
+        case 'block_delta':
+            return applyBlockDelta(state, event);
+        case 'block_end':
+            return {
+                ...state,
+                blocks: state.blocks.map((b) => (b.id === event.blockId ? { ...b, status: 'completed' } : b)),
+            };
+        case 'block_error':
+            return {
+                ...state,
+                blocks: state.blocks.map((b) => (b.id === event.blockId ? { ...b, status: 'error' } : b)),
+            };
+        case 'message_end':
+            return { ...state, status: 'completed' };
+        default:
+            return state;
+    }
+}
+function applyBlockDelta(state, event) {
+    return {
+        ...state,
+        blocks: state.blocks.map((b) => (b.id === event.blockId ? applyDelta(b, event.delta) : b)),
+    };
+}
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create an empty Message suitable as the initial state for `messageReducer`.
+ */
+export function createEmptyMessage(id) {
+    return {
+        id: id ?? '',
+        role: 'assistant',
+        blocks: [],
+        status: 'streaming',
+        createdAt: Date.now(),
+    };
+}
+//# sourceMappingURL=reducers.js.map

package/dist/reducers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducers.js","sourceRoot":"","sources":["../src/reducers.ts"],"names":[],"mappings":"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"}

package/dist/streaming.d.ts

@@ -0,0 +1,42 @@
+import type { BaseBlock } from './blocks.js';
+import type { Delta } from './deltas.js';
+export type MessageStartEvent = {
+    type: 'message_start';
+    message: {
+        id: string;
+        role: string;
+    };
+};
+export type BlockStartEvent = {
+    type: 'block_start';
+    block: BaseBlock & Record<string, unknown>;
+};
+export type BlockDeltaEvent = {
+    type: 'block_delta';
+    blockId: string;
+    delta: Delta;
+};
+export type BlockEndEvent = {
+    type: 'block_end';
+    blockId: string;
+};
+export type BlockErrorEvent = {
+    type: 'block_error';
+    blockId: string;
+    error: string;
+};
+export type MessageEndEvent = {
+    type: 'message_end';
+    messageId: string;
+};
+export type StreamEvent = MessageStartEvent | BlockStartEvent | BlockDeltaEvent | BlockEndEvent | BlockErrorEvent | MessageEndEvent;
+export type StreamEventType = StreamEvent['type'];
+export interface StreamEventCallbacks {
+    onMessageStart?: (event: MessageStartEvent) => void;
+    onBlockStart?: (event: BlockStartEvent) => void;
+    onBlockDelta?: (event: BlockDeltaEvent) => void;
+    onBlockEnd?: (event: BlockEndEvent) => void;
+    onBlockError?: (event: BlockErrorEvent) => void;
+    onMessageEnd?: (event: MessageEndEvent) => void;
+}
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GACjB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,aAAa,GACb,eAAe,GACf,eAAe,CAAC;AAEtB,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAIlD,MAAM,WAAW,oBAAoB;IACjC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD"}

package/dist/streaming.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@fleetx_io/ai-ui-dsl",
+    "version": "1.0.0",
+    "description": "A Domain Specific Language for describing rich, streaming AI chat interfaces via composable Blocks.",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "sideEffects": false,
+    "scripts": {
+        "build": "tsc",
+        "playground": "npm run dev -w playground",
+        "playground:build": "npm run build -w playground",
+        "publish": "npm run build && npm publish --access public",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "workspaces": [
+        "playground"
+    ],
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "files": [
+        "dist",
+        "package.json",
+        "README.md",
+        "LICENSE",
+        "CHANGELOG.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "keywords": [
+        "UI",
+        "AI",
+        "Chat",
+        "Interfaces",
+        "DSL",
+        "streaming",
+        "AI chat interfaces",
+        "composable blocks",
+        "fleetx"
+    ],
+    "author": "Satish Kumar <satish@fleetx.io>",
+    "license": "ISC",
+    "devDependencies": {
+        "@types/node": "^25.3.3",
+        "typescript": "^5.9.3",
+        "prettier": "2.0.5"
+    }
+}