@mihe-dev/js 0.0.0-stage → 0.2.0

package/dist/declarations.js

@@ -0,0 +1,171 @@
+/**
+ * What an app declares about tabs, tables and charts, and how each becomes
+ * what the store holds (amendment 67, doc 08).
+ *
+ * Shared by the JavaScript API (`mihe.registerTable(…)`) and the React hooks
+ * (`useAssistantTable(…)`), so the two can't send the model different things
+ * for the same table. Each builder takes `latest`, a function returning the
+ * declaration as it is now: rows, closures and data are read at the moment of
+ * a read rather than captured at registration, so a table that re-renders
+ * every second doesn't re-register every second.
+ */
+import { summarise, thin } from "./chart.js";
+/** Long cells are cut here: a notes field should not cost a page of tokens. */
+const MAX_CELL_CHARS = 200;
+export function toCell(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "number" || typeof value === "boolean")
+        return value;
+    const text = value instanceof Date
+        ? value.toISOString()
+        : typeof value === "string"
+            ? value
+            : JSON.stringify(value);
+    return text.length > MAX_CELL_CHARS ? `${text.slice(0, MAX_CELL_CHARS)}…` : text;
+}
+/** The tabs as the store holds them. `onChange` is read at call time. */
+export function tabsDeclaration(latest) {
+    const tabs = latest();
+    return {
+        kind: "tabs",
+        label: tabs.label,
+        options: tabs.tabs.map(({ value, label }) => ({ value, label })),
+        value: tabs.value,
+        onChange: (value) => latest().onChange(value),
+    };
+}
+/**
+ * What identifies a tab set's declaration, without its closure: when this
+ * changes, the store needs the new declaration.
+ */
+export function tabsSignature(tabs) {
+    return JSON.stringify({
+        label: tabs.label,
+        tabs: tabs.tabs.map(({ value, label }) => ({ value, label })),
+        value: tabs.value,
+    });
+}
+/** The query parameters a table accepts, as the store holds them. */
+function queryParams(query) {
+    return Object.entries(query.params).map(([key, param]) => ({
+        key,
+        kind: param.kind,
+        values: param.kind === "enum" ? [...param.values] : [],
+        description: param.description ?? "",
+    }));
+}
+/**
+ * What identifies a table's declaration, without its rows or closures: when
+ * this changes, the store needs the new declaration. The rows' count is in
+ * it, because the screen context reports how many are loaded.
+ */
+export function tableSignature(table) {
+    return JSON.stringify({
+        label: table.label,
+        columns: table.columns.map(({ key, label }) => ({ key, label })),
+        rowIdName: table.rowIdName,
+        opens: table.opens?.screenId,
+        total: table.total,
+        loaded: table.rows.length,
+        query: table.query
+            ? {
+                params: queryParams(table.query),
+                canShow: table.query.show !== undefined,
+            }
+            : undefined,
+    });
+}
+/** The table as the store holds it. Rows and closures are read at call time. */
+export function tableDeclaration(latest) {
+    const table = latest();
+    // One rendering for rows read and rows found, so a search result looks
+    // exactly like a read: declared columns only, cells cut, `open` params.
+    const render = (row) => {
+        const { rowId, columns, opens } = latest();
+        const out = {};
+        for (const column of columns) {
+            const raw = column.value ? column.value(row) : row[column.key];
+            out[column.label] = toCell(raw);
+        }
+        return {
+            id: rowId(row),
+            ...(opens ? { open: opens.params(row) } : {}),
+            ...out,
+        };
+    };
+    return {
+        label: table.label,
+        columns: table.columns.map(({ key, label }) => ({ key, label })),
+        rowIdName: table.rowIdName,
+        opens: table.opens?.screenId,
+        total: table.total,
+        loadedRows: table.rows.length,
+        read: (offset, limit) => latest().rows.slice(offset, offset + limit).map(render),
+        ...(table.query
+            ? {
+                query: {
+                    params: queryParams(table.query),
+                    run: async (params) => {
+                        const query = latest().query;
+                        if (!query)
+                            throw new Error("This table can no longer be searched.");
+                        const found = await query.run(params);
+                        return {
+                            rows: found.rows.map(render),
+                            ...(found.total === undefined ? {} : { total: found.total }),
+                        };
+                    },
+                    ...(table.query.show
+                        ? { show: (params) => latest().query?.show?.(params) }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+}
+/** Each series' points, read from the chart as it is now. */
+function chartPoints(chart, key) {
+    const format = chart.x.format;
+    return chart.data.flatMap((datum) => {
+        const raw = datum[key];
+        const y = typeof raw === "number" ? raw : raw == null ? NaN : Number(raw);
+        if (!Number.isFinite(y))
+            return [];
+        const xRaw = datum[chart.x.key];
+        return [{ x: format ? format(xRaw) : String(xRaw), y }];
+    });
+}
+/**
+ * The chart as the store holds it: each series summarised here, in the
+ * browser, and the points read at call time when an exact value is wanted.
+ */
+export function chartDeclaration(latest) {
+    const chart = latest();
+    const ordered = chart.x.kind !== "category";
+    return {
+        title: chart.title,
+        xLabel: chart.x.label,
+        xKind: ordered ? "ordered" : "category",
+        series: chart.series.map((s) => {
+            const summary = summarise(chartPoints(chart, s.key), ordered);
+            return {
+                name: s.name,
+                ...(s.unit ? { unit: s.unit } : {}),
+                ...(summary ? { summary } : {}),
+            };
+        }),
+        read: (name, limit) => {
+            const current = latest();
+            return current.series
+                .filter((s) => name === undefined || s.name === name)
+                .map((s) => ({ name: s.name, points: thin(chartPoints(current, s.key), limit) }));
+        },
+    };
+}
+/** What identifies a chart's declaration: its summaries, not its closures. */
+export function chartSignature(chart) {
+    const { read: _read, ...declared } = chartDeclaration(() => chart);
+    return JSON.stringify(declared);
+}
+//# sourceMappingURL=declarations.js.map

package/dist/declarations.js.map

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

package/dist/highlight.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The highlight and focus engine (spec §12).
+ *
+ * Draws an overlay over a registered element rather than mutating the
+ * element's own styles. Two reasons: the host app's CSS is not ours to touch,
+ * and an overlay cannot leave residue if the SDK unmounts mid-tutorial.
+ *
+ * Elements are found by the `data-mihe-component` attribute that
+ * `useAssistantComponent` spreads onto them. Never by CSS selector or
+ * position — the assistant points at things the app has declared, and at
+ * nothing else.
+ */
+export declare const COMPONENT_ATTRIBUTE = "data-mihe-component";
+export declare function findComponent(componentKey: string): HTMLElement | null;
+export declare class HighlightEngine {
+    private overlay;
+    private caption;
+    private target;
+    private tracking;
+    private observer;
+    private frame;
+    /** Draw attention to a component. Returns false if it is not on the page. */
+    highlight(componentKey: string, message?: string): boolean;
+    /** Move keyboard focus into a component, highlighting it too. */
+    focus(componentKey: string, message?: string): boolean;
+    scrollTo(componentKey: string): boolean;
+    clear(): void;
+    private ensureOverlay;
+    private setCaption;
+    private position;
+    /** Coalesced, because a MutationObserver can fire many times per render. */
+    private reposition;
+    /** Escape is the universal "get this off my screen". */
+    private onKeyDown;
+    /**
+     * Any click outside the target dismisses.
+     *
+     * The overlay dims the whole page, so it reads as a modal — but it is
+     * `pointer-events: none`, so clicks reach the app underneath. Without this
+     * the user clicks away, the app responds, and the dim stays: it looks
+     * dismissible and is not. Clicks on the target itself are left alone, since
+     * that is the click the highlight is asking for and the app's own handler
+     * usually removes the highlight's reason for existing anyway.
+     */
+    /**
+     * A click ends the highlight, with one exception that has an exception.
+     *
+     * Clicking away dismisses it: the user has moved on and a ring around
+     * something they are no longer looking at is clutter.
+     *
+     * Clicking *inside* the target does not, because the target is often an
+     * input the user has just been asked to fill — losing the marker the moment
+     * they click into the field would undo the pointing.
+     *
+     * But if the target is something clicking *activates* — a button, a link —
+     * then the click was the action, and the highlight has done its job. Without
+     * this the ring survives the thing it pointed at: the assistant highlighted
+     * "Receive Stock", the user clicked, the form opened, and the outline stayed
+     * behind the dialog pointing at a button nobody needed any more.
+     */
+    private onPointerDown;
+    /**
+     * Keep the overlay glued to its target, and remove it when the target goes.
+     *
+     * Scroll and resize are listened to rather than polled; `capture: true` on
+     * scroll catches scrolling inside containers, not just the window.
+     *
+     * The MutationObserver is what makes the overlay mortal. `position` already
+     * clears when the target has left the DOM, but it only ran on scroll and
+     * resize — so a highlighted element that unmounted while the page sat still
+     * (a form closing after submit, say) left the overlay stranded over the page
+     * with no way to dismiss it.
+     */
+    private startTracking;
+    private stopTracking;
+}
+//# sourceMappingURL=highlight.d.ts.map

package/dist/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../../js/src/highlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAoBzD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAItE;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,KAAK,CAAK;IAElB,6EAA6E;IAC7E,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAc1D,iEAAiE;IACjE,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAiBtD,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAOvC,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,QAAQ,CAgBd;IAEF,4EAA4E;IAC5E,OAAO,CAAC,UAAU,CAMhB;IAEF,wDAAwD;IACxD,OAAO,CAAC,SAAS,CAEf;IAEF;;;;;;;;;OASG;IACH;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,aAAa,CAKnB;IAEF;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;CAerB"}

package/dist/highlight.js

@@ -0,0 +1,233 @@
+/**
+ * The highlight and focus engine (spec §12).
+ *
+ * Draws an overlay over a registered element rather than mutating the
+ * element's own styles. Two reasons: the host app's CSS is not ours to touch,
+ * and an overlay cannot leave residue if the SDK unmounts mid-tutorial.
+ *
+ * Elements are found by the `data-mihe-component` attribute that
+ * `useAssistantComponent` spreads onto them. Never by CSS selector or
+ * position — the assistant points at things the app has declared, and at
+ * nothing else.
+ */
+export const COMPONENT_ATTRIBUTE = "data-mihe-component";
+const OVERLAY_ID = "mihe-highlight";
+const PADDING = 6;
+/**
+ * Whether clicking this element does something, rather than merely selecting
+ * it. Buttons and links act; inputs and containers receive.
+ *
+ * Read from the element rather than from the registry's `ComponentType`
+ * because the overlay is drawn over whatever the app spread the attribute
+ * onto, which is not always the element the declaration describes — a label
+ * carrying the props for the input beside it, for instance.
+ */
+function activates(element) {
+    if (!element)
+        return false;
+    if (element.closest("button, a[href], [role='button'], [role='link']"))
+        return true;
+    return false;
+}
+export function findComponent(componentKey) {
+    return document.querySelector(`[${COMPONENT_ATTRIBUTE}="${CSS.escape(componentKey)}"]`);
+}
+export class HighlightEngine {
+    overlay = null;
+    caption = null;
+    target = null;
+    tracking = false;
+    observer = null;
+    frame = 0;
+    /** Draw attention to a component. Returns false if it is not on the page. */
+    highlight(componentKey, message) {
+        const target = findComponent(componentKey);
+        if (!target)
+            return false;
+        this.target = target;
+        this.ensureOverlay();
+        this.setCaption(message);
+        this.position();
+        this.startTracking();
+        target.scrollIntoView({ behavior: "smooth", block: "center" });
+        return true;
+    }
+    /** Move keyboard focus into a component, highlighting it too. */
+    focus(componentKey, message) {
+        const target = findComponent(componentKey);
+        if (!target)
+            return false;
+        this.highlight(componentKey, message);
+        // A wrapper may be registered rather than the input itself; focus the
+        // first focusable descendant when the element cannot take focus.
+        const focusable = target.matches("input, textarea, select, button, [tabindex]")
+            ? target
+            : target.querySelector("input, textarea, select, button, [tabindex]");
+        focusable?.focus();
+        return true;
+    }
+    scrollTo(componentKey) {
+        const target = findComponent(componentKey);
+        if (!target)
+            return false;
+        target.scrollIntoView({ behavior: "smooth", block: "center" });
+        return true;
+    }
+    clear() {
+        this.stopTracking();
+        this.overlay?.remove();
+        this.overlay = null;
+        this.caption = null;
+        this.target = null;
+    }
+    ensureOverlay() {
+        if (this.overlay)
+            return;
+        const overlay = document.createElement("div");
+        overlay.id = OVERLAY_ID;
+        // `pointer-events: none` is load-bearing: the highlight must never
+        // intercept the click it is asking the user to make.
+        Object.assign(overlay.style, {
+            position: "fixed",
+            zIndex: "2147483000",
+            pointerEvents: "none",
+            border: "2px solid #4f7cff",
+            borderRadius: "8px",
+            boxShadow: "0 0 0 9999px rgba(15, 23, 42, 0.45)",
+            transition: "top 120ms ease, left 120ms ease, width 120ms ease, height 120ms ease",
+        });
+        const caption = document.createElement("div");
+        Object.assign(caption.style, {
+            position: "absolute",
+            left: "0",
+            top: "100%",
+            marginTop: "8px",
+            maxWidth: "260px",
+            padding: "8px 10px",
+            borderRadius: "8px",
+            background: "#0f172a",
+            color: "#f8fafc",
+            font: "500 13px/1.4 system-ui, -apple-system, sans-serif",
+            display: "none",
+        });
+        overlay.appendChild(caption);
+        document.body.appendChild(overlay);
+        this.overlay = overlay;
+        this.caption = caption;
+    }
+    setCaption(message) {
+        if (!this.caption)
+            return;
+        if (message) {
+            this.caption.textContent = message;
+            this.caption.style.display = "block";
+        }
+        else {
+            this.caption.textContent = "";
+            this.caption.style.display = "none";
+        }
+    }
+    position = () => {
+        if (!this.overlay || !this.target)
+            return;
+        // The element may have unmounted since the highlight was drawn.
+        if (!this.target.isConnected) {
+            this.clear();
+            return;
+        }
+        const rect = this.target.getBoundingClientRect();
+        Object.assign(this.overlay.style, {
+            top: `${rect.top - PADDING}px`,
+            left: `${rect.left - PADDING}px`,
+            width: `${rect.width + PADDING * 2}px`,
+            height: `${rect.height + PADDING * 2}px`,
+        });
+    };
+    /** Coalesced, because a MutationObserver can fire many times per render. */
+    reposition = () => {
+        if (this.frame)
+            return;
+        this.frame = requestAnimationFrame(() => {
+            this.frame = 0;
+            this.position();
+        });
+    };
+    /** Escape is the universal "get this off my screen". */
+    onKeyDown = (event) => {
+        if (event.key === "Escape")
+            this.clear();
+    };
+    /**
+     * Any click outside the target dismisses.
+     *
+     * The overlay dims the whole page, so it reads as a modal — but it is
+     * `pointer-events: none`, so clicks reach the app underneath. Without this
+     * the user clicks away, the app responds, and the dim stays: it looks
+     * dismissible and is not. Clicks on the target itself are left alone, since
+     * that is the click the highlight is asking for and the app's own handler
+     * usually removes the highlight's reason for existing anyway.
+     */
+    /**
+     * A click ends the highlight, with one exception that has an exception.
+     *
+     * Clicking away dismisses it: the user has moved on and a ring around
+     * something they are no longer looking at is clutter.
+     *
+     * Clicking *inside* the target does not, because the target is often an
+     * input the user has just been asked to fill — losing the marker the moment
+     * they click into the field would undo the pointing.
+     *
+     * But if the target is something clicking *activates* — a button, a link —
+     * then the click was the action, and the highlight has done its job. Without
+     * this the ring survives the thing it pointed at: the assistant highlighted
+     * "Receive Stock", the user clicked, the form opened, and the outline stayed
+     * behind the dialog pointing at a button nobody needed any more.
+     */
+    onPointerDown = (event) => {
+        const node = event.target;
+        const inside = node instanceof Node && this.target?.contains(node);
+        if (inside && !activates(this.target))
+            return;
+        this.clear();
+    };
+    /**
+     * Keep the overlay glued to its target, and remove it when the target goes.
+     *
+     * Scroll and resize are listened to rather than polled; `capture: true` on
+     * scroll catches scrolling inside containers, not just the window.
+     *
+     * The MutationObserver is what makes the overlay mortal. `position` already
+     * clears when the target has left the DOM, but it only ran on scroll and
+     * resize — so a highlighted element that unmounted while the page sat still
+     * (a form closing after submit, say) left the overlay stranded over the page
+     * with no way to dismiss it.
+     */
+    startTracking() {
+        if (this.tracking)
+            return;
+        this.tracking = true;
+        window.addEventListener("scroll", this.position, { passive: true, capture: true });
+        window.addEventListener("resize", this.position, { passive: true });
+        window.addEventListener("keydown", this.onKeyDown);
+        // Capture, so the app's own handlers cannot stop it from reaching us.
+        window.addEventListener("pointerdown", this.onPointerDown, { capture: true });
+        this.observer = new MutationObserver(this.reposition);
+        this.observer.observe(document.body, { childList: true, subtree: true });
+    }
+    stopTracking() {
+        if (!this.tracking)
+            return;
+        this.tracking = false;
+        window.removeEventListener("scroll", this.position, { capture: true });
+        window.removeEventListener("resize", this.position);
+        window.removeEventListener("keydown", this.onKeyDown);
+        window.removeEventListener("pointerdown", this.onPointerDown, { capture: true });
+        this.observer?.disconnect();
+        this.observer = null;
+        if (this.frame) {
+            cancelAnimationFrame(this.frame);
+            this.frame = 0;
+        }
+    }
+}
+//# sourceMappingURL=highlight.js.map

package/dist/highlight.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @mihe-dev/js — an app-aware AI assistant for any web app (doc 08).
+ *
+ * Three things to wire up:
+ *
+ * 1. `createMihe({ url, publicKey, getUserToken, navigate })` once, at boot.
+ * 2. `mihe.setScreen(…)` on each page so the assistant knows where the user
+ *    is, keeping the returned function for when they leave.
+ * 3. `mihe.registerComponent(…)` on the elements it should be able to point
+ *    at, and `mihe.registerAction(…)` for anything it should be able to run.
+ *
+ * Then `mountWidget(mihe)` for the orb, or draw your own UI from
+ * `mihe.getState()`.
+ *
+ * The assistant reasons; your app executes. It can only navigate to screens
+ * you registered, point at components you declared, and run actions you
+ * handled — there is no path by which it drives your UI directly.
+ */
+export { Mihe, createMihe, SDK_VERSION, ASSISTANT_PANEL_ID } from "./mihe.js";
+export type { ChatMessage, MiheOptions, MiheState, VoiceControls } from "./mihe.js";
+export { chartDeclaration, chartSignature, tableDeclaration, tableSignature, tabsDeclaration, tabsSignature, } from "./declarations.js";
+export type { AssistantChart, AssistantQueryParam, AssistantTable, AssistantTableColumn, AssistantTableQuery, AssistantTabs, } from "./declarations.js";
+export { mountWidget, defineMiheAssistant, ELEMENT_NAME } from "./widget/element.js";
+export type { MiheAssistantElement, MountedWidget, WidgetOptions } from "./widget/element.js";
+export { formatValue, humanizeKey } from "./widget/format.js";
+export { appView, fillSummary, formatField, hintedView, DESCRIBE_TIMEOUT_MS } from "./card-view.js";
+export type { CardLine, CardView, DescribeProposal, ProposalDescription } from "./card-view.js";
+export { VoiceSession, voiceUrl } from "./voice.js";
+export type { VoiceEvent, VoiceState, VoiceSessionOptions } from "./voice.js";
+export { MicrophoneCapture, SpeakerQueue, toPcm16, fromPcm16 } from "./audio.js";
+export { AssistantStore } from "./store.js";
+export type { ActionHandler, ComponentDeclaration, ScreenDeclaration, ChartDeclaration, TableDeclaration, TableRow, ViewControlDeclaration, } from "./store.js";
+export { AssistantClient } from "./client.js";
+export type { ClientEvent, ClientOptions, ConnectionState, ProposalPayload, } from "./client.js";
+export { executeCommand } from "./commands.js";
+export type { CommandContext, CommandResult } from "./commands.js";
+export { formatContextReport } from "./debug.js";
+export type { ContextReport } from "./debug.js";
+export { HighlightEngine, COMPONENT_ATTRIBUTE } from "./highlight.js";
+export { PROTOCOL_VERSION, VOICE_SAMPLE_RATE } from "@mihe-dev/protocol";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../js/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEjF,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClF,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @mihe-dev/js — an app-aware AI assistant for any web app (doc 08).
+ *
+ * Three things to wire up:
+ *
+ * 1. `createMihe({ url, publicKey, getUserToken, navigate })` once, at boot.
+ * 2. `mihe.setScreen(…)` on each page so the assistant knows where the user
+ *    is, keeping the returned function for when they leave.
+ * 3. `mihe.registerComponent(…)` on the elements it should be able to point
+ *    at, and `mihe.registerAction(…)` for anything it should be able to run.
+ *
+ * Then `mountWidget(mihe)` for the orb, or draw your own UI from
+ * `mihe.getState()`.
+ *
+ * The assistant reasons; your app executes. It can only navigate to screens
+ * you registered, point at components you declared, and run actions you
+ * handled — there is no path by which it drives your UI directly.
+ */
+export { Mihe, createMihe, SDK_VERSION, ASSISTANT_PANEL_ID } from "./mihe.js";
+export { chartDeclaration, chartSignature, tableDeclaration, tableSignature, tabsDeclaration, tabsSignature, } from "./declarations.js";
+export { mountWidget, defineMiheAssistant, ELEMENT_NAME } from "./widget/element.js";
+export { formatValue, humanizeKey } from "./widget/format.js";
+export { appView, fillSummary, formatField, hintedView, DESCRIBE_TIMEOUT_MS } from "./card-view.js";
+export { VoiceSession, voiceUrl } from "./voice.js";
+export { MicrophoneCapture, SpeakerQueue, toPcm16, fromPcm16 } from "./audio.js";
+export { AssistantStore } from "./store.js";
+export { AssistantClient } from "./client.js";
+export { executeCommand } from "./commands.js";
+export { formatContextReport } from "./debug.js";
+export { HighlightEngine, COMPONENT_ATTRIBUTE } from "./highlight.js";
+export { PROTOCOL_VERSION, VOICE_SAMPLE_RATE } from "@mihe-dev/protocol";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../js/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAG3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGjG,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAWzC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQ3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}