@jini-ai/ui 0.1.0

package/dist/features/list-detail-panel/react/components/ListDetailPanel.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+import type { ListDetailItem, ListDetailItemRenderState } from '../../types.js';
+export interface ListDetailPanelProps<TItem extends ListDetailItem> {
+    /** The rows shown in the sidebar list (already filtered/scoped by the host). */
+    items: readonly TItem[];
+    /** The currently previewed row's id, or `null` for no selection. */
+    selectedId: string | null;
+    /** Fired when a row is clicked. */
+    onSelect: (id: string) => void;
+    /** Renders a row's visual content; the panel supplies the interactive wrapper. */
+    renderItem: (item: TItem, state: ListDetailItemRenderState) => ReactNode;
+    /** Renders the detail pane for the currently selected item. */
+    renderDetail: (item: TItem) => ReactNode;
+    /** Optional accessible label override for a row's button (defaults to the row's own text content). */
+    getItemAriaLabel?: (item: TItem) => string;
+    /** Slot above the list — search box, scope tabs, facet filters, a "create" button, etc. */
+    header?: ReactNode;
+    /** Shown in the sidebar when `items` is empty. */
+    emptyListContent?: ReactNode;
+    /** Shown in the detail pane when nothing is selected (including an empty list). */
+    emptyDetailContent?: ReactNode;
+    /** Replaces the sidebar list and detail pane with host-supplied loading placeholders. */
+    loading?: boolean;
+    loadingSidebarContent?: ReactNode;
+    loadingDetailContent?: ReactNode;
+    className?: string;
+    sidebarClassName?: string;
+    listClassName?: string;
+    detailClassName?: string;
+    itemClassName?: string | ((item: TItem, state: ListDetailItemRenderState) => string);
+    'data-testid'?: string;
+}
+/**
+ * Generic master-detail (list+preview) navigator shell: a sidebar list of
+ * summary rows with a selection state, and a detail pane rendering whichever
+ * row is selected. Dumb/presentational — selection state lives in
+ * {@link useListDetailSelection} (or the host's own state), not here.
+ */
+export declare function ListDetailPanel<TItem extends ListDetailItem>({ items, selectedId, onSelect, renderItem, renderDetail, getItemAriaLabel, header, emptyListContent, emptyDetailContent, loading, loadingSidebarContent, loadingDetailContent, className, sidebarClassName, listClassName, detailClassName, itemClassName, 'data-testid': testId, }: ListDetailPanelProps<TItem>): import("react").JSX.Element;
+//# sourceMappingURL=ListDetailPanel.d.ts.map

package/dist/features/list-detail-panel/react/components/ListDetailPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListDetailPanel.d.ts","sourceRoot":"","sources":["../../../../../src/features/list-detail-panel/react/components/ListDetailPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,WAAW,oBAAoB,CAAC,KAAK,SAAS,cAAc;IAChE,gFAAgF;IAChF,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;IACxB,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,kFAAkF;IAClF,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,KAAK,SAAS,CAAC;IACzE,+DAA+D;IAC/D,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC;IACzC,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;IAC3C,2FAA2F;IAC3F,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,SAAS,CAAC;IAC/B,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,KAAK,MAAM,CAAC,CAAC;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAS,cAAc,EAAE,EAC5D,KAAK,EACL,UAAU,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,OAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EAAE,MAA4B,GAC5C,EAAE,oBAAoB,CAAC,KAAK,CAAC,+BAqE7B"}

package/dist/features/list-detail-panel/react/components/ListDetailPanel.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useT } from '../../../i18n/index.js';
+import { findSelectedItem } from '../../rules.js';
+const join = (...classes) => classes.filter(Boolean).join(' ');
+/**
+ * Generic master-detail (list+preview) navigator shell: a sidebar list of
+ * summary rows with a selection state, and a detail pane rendering whichever
+ * row is selected. Dumb/presentational — selection state lives in
+ * {@link useListDetailSelection} (or the host's own state), not here.
+ */
+export function ListDetailPanel({ items, selectedId, onSelect, renderItem, renderDetail, getItemAriaLabel, header, emptyListContent, emptyDetailContent, loading = false, loadingSidebarContent, loadingDetailContent, className, sidebarClassName, listClassName, detailClassName, itemClassName, 'data-testid': testId = 'list-detail-panel', }) {
+    const t = useT();
+    const selectedItem = findSelectedItem(items, selectedId);
+    return (_jsxs("div", { className: join('jini-list-detail-panel', className), "data-testid": testId, children: [_jsxs("aside", { className: join('jini-list-detail-panel-sidebar', sidebarClassName), "data-testid": `${testId}-sidebar`, children: [header, loading ? (_jsx("div", { className: "jini-list-detail-panel-loading-sidebar", role: "status", "aria-busy": "true", "aria-label": t('Loading'), "data-testid": `${testId}-loading-sidebar`, children: loadingSidebarContent })) : (_jsx("div", { className: join('jini-list-detail-panel-list', listClassName), "data-testid": `${testId}-list`, children: items.length === 0
+                            ? emptyListContent
+                            : items.map((item) => {
+                                const active = item.id === selectedId;
+                                const state = { active };
+                                const resolvedItemClassName = typeof itemClassName === 'function' ? itemClassName(item, state) : itemClassName;
+                                return (_jsx("button", { type: "button", className: join('jini-list-detail-panel-item', active && 'jini-list-detail-panel-item-active', resolvedItemClassName), "aria-pressed": active, "aria-label": getItemAriaLabel?.(item), "data-active": active, "data-testid": `${testId}-item-${item.id}`, onClick: () => onSelect(item.id), children: renderItem(item, state) }, item.id));
+                            }) }))] }), _jsx("section", { className: join('jini-list-detail-panel-detail', detailClassName), "data-testid": `${testId}-detail`, children: loading ? (_jsx("div", { className: "jini-list-detail-panel-loading-detail", role: "status", "aria-busy": "true", "aria-label": t('Loading'), "data-testid": `${testId}-loading-detail`, children: loadingDetailContent })) : selectedItem ? (renderDetail(selectedItem)) : (emptyDetailContent) })] }));
+}
+//# sourceMappingURL=ListDetailPanel.js.map

package/dist/features/list-detail-panel/react/components/ListDetailPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListDetailPanel.js","sourceRoot":"","sources":["../../../../../src/features/list-detail-panel/react/components/ListDetailPanel.tsx"],"names":[],"mappings":"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"}

package/dist/features/list-detail-panel/react/hooks/useListDetailSelection.d.ts

@@ -0,0 +1,17 @@
+import type { ListDetailItem } from '../../types.js';
+export interface UseListDetailSelectionResult {
+    selectedId: string | null;
+    select: (id: string | null) => void;
+}
+/**
+ * Owns the master-detail selection state: which row is currently previewed.
+ * Runs the `resolveListDetailSelection` rule whenever `items` changes so the
+ * selection stays valid (kept if still present, else the first item, else
+ * `null` for an empty list) without the host having to re-derive it.
+ *
+ * `ListDetailPanel` itself is fully controlled (`selectedId`/`onSelect`
+ * props) — this hook is the opt-in convenience wirer a host uses instead of
+ * hand-rolling the same sync effect `DesignSystemsTab.tsx` had inline.
+ */
+export declare function useListDetailSelection<TItem extends ListDetailItem>(items: readonly TItem[], initialSelectedId?: string | null): UseListDetailSelectionResult;
+//# sourceMappingURL=useListDetailSelection.d.ts.map

package/dist/features/list-detail-panel/react/hooks/useListDetailSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListDetailSelection.d.ts","sourceRoot":"","sources":["../../../../../src/features/list-detail-panel/react/hooks/useListDetailSelection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,cAAc,EACjE,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,iBAAiB,GAAE,MAAM,GAAG,IAAW,GACtC,4BAA4B,CAc9B"}

package/dist/features/list-detail-panel/react/hooks/useListDetailSelection.js

@@ -0,0 +1,23 @@
+import { useCallback, useEffect, useState } from 'react';
+import { resolveListDetailSelection } from '../../rules.js';
+/**
+ * Owns the master-detail selection state: which row is currently previewed.
+ * Runs the `resolveListDetailSelection` rule whenever `items` changes so the
+ * selection stays valid (kept if still present, else the first item, else
+ * `null` for an empty list) without the host having to re-derive it.
+ *
+ * `ListDetailPanel` itself is fully controlled (`selectedId`/`onSelect`
+ * props) — this hook is the opt-in convenience wirer a host uses instead of
+ * hand-rolling the same sync effect `DesignSystemsTab.tsx` had inline.
+ */
+export function useListDetailSelection(items, initialSelectedId = null) {
+    const [selectedId, setSelectedId] = useState(() => resolveListDetailSelection(items, initialSelectedId));
+    useEffect(() => {
+        setSelectedId((current) => resolveListDetailSelection(items, current));
+    }, [items]);
+    const select = useCallback((id) => {
+        setSelectedId(id);
+    }, []);
+    return { selectedId, select };
+}
+//# sourceMappingURL=useListDetailSelection.js.map

package/dist/features/list-detail-panel/react/hooks/useListDetailSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListDetailSelection.js","sourceRoot":"","sources":["../../../../../src/features/list-detail-panel/react/hooks/useListDetailSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAQ5D;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAuB,EACvB,oBAAmC,IAAI;IAEvC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgB,GAAG,EAAE,CAC/D,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,CAAC,CACrD,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,EAAiB,EAAE,EAAE;QAC/C,aAAa,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC"}

package/dist/features/list-detail-panel/rules.d.ts

@@ -0,0 +1,13 @@
+import type { ListDetailItem } from './types.js';
+/**
+ * Resolve the next valid selection as `items` changes.
+ *
+ * Mirrors `DesignSystemsTab.tsx`'s master-detail sync effect: an empty list
+ * clears the selection; a current pick that's still present is kept as-is
+ * (no flicker on unrelated list updates); otherwise the first item becomes
+ * the new pick.
+ */
+export declare function resolveListDetailSelection<TItem extends ListDetailItem>(items: readonly TItem[], currentId: string | null): string | null;
+/** Find the summary item matching `selectedId`, or `null` if absent/unselected. */
+export declare function findSelectedItem<TItem extends ListDetailItem>(items: readonly TItem[], selectedId: string | null): TItem | null;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/list-detail-panel/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/list-detail-panel/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,cAAc,EACrE,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,GAAG,IAAI,CAIf;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,EAC3D,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,KAAK,GAAG,IAAI,CAGd"}

package/dist/features/list-detail-panel/rules.js

@@ -0,0 +1,22 @@
+/**
+ * Resolve the next valid selection as `items` changes.
+ *
+ * Mirrors `DesignSystemsTab.tsx`'s master-detail sync effect: an empty list
+ * clears the selection; a current pick that's still present is kept as-is
+ * (no flicker on unrelated list updates); otherwise the first item becomes
+ * the new pick.
+ */
+export function resolveListDetailSelection(items, currentId) {
+    if (items.length === 0)
+        return null;
+    if (currentId !== null && items.some((item) => item.id === currentId))
+        return currentId;
+    return items[0].id;
+}
+/** Find the summary item matching `selectedId`, or `null` if absent/unselected. */
+export function findSelectedItem(items, selectedId) {
+    if (selectedId === null)
+        return null;
+    return items.find((item) => item.id === selectedId) ?? null;
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/list-detail-panel/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/features/list-detail-panel/rules.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAuB,EACvB,SAAwB;IAExB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,SAAS,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACxF,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;AACtB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAC9B,KAAuB,EACvB,UAAyB;IAEzB,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,IAAI,IAAI,CAAC;AAC9D,CAAC"}

package/dist/features/list-detail-panel/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generic "master-detail (list+preview) navigator" primitive — a sidebar list
+ * of summary items with a selection state, and a detail pane rendering
+ * whichever item is selected. Host-injected for the actual data/rendering of
+ * both summary rows and detail content; this feature only owns the
+ * selection-interaction chrome and the selection-validity rule.
+ *
+ * Origin: `DesignSystemsTab.tsx` in the real OD source (the confirmed
+ * instance of this shape — see `packages/ui/source-map.md` for why
+ * `PluginsView.tsx`'s detail modal and `ProjectView.tsx`'s composition were
+ * verified NOT to share it despite the surface-level "conceptually related"
+ * flag in `foundry/docs/jini-port/recon/r6-god-component-internals.md`).
+ */
+/** The minimum shape a summary item must carry: a stable identity. */
+export interface ListDetailItem {
+    id: string;
+}
+/** Render-time state handed to a row's `renderItem` callback. */
+export interface ListDetailItemRenderState {
+    active: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/list-detail-panel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/list-detail-panel/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/features/list-detail-panel/types.js

@@ -0,0 +1,15 @@
+/**
+ * Generic "master-detail (list+preview) navigator" primitive — a sidebar list
+ * of summary items with a selection state, and a detail pane rendering
+ * whichever item is selected. Host-injected for the actual data/rendering of
+ * both summary rows and detail content; this feature only owns the
+ * selection-interaction chrome and the selection-validity rule.
+ *
+ * Origin: `DesignSystemsTab.tsx` in the real OD source (the confirmed
+ * instance of this shape — see `packages/ui/source-map.md` for why
+ * `PluginsView.tsx`'s detail modal and `ProjectView.tsx`'s composition were
+ * verified NOT to share it despite the surface-level "conceptually related"
+ * flag in `foundry/docs/jini-port/recon/r6-god-component-internals.md`).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/list-detail-panel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/list-detail-panel/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/features/memory/async-commit-guard.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Orders asynchronous state commits for one mutable resource. Start each
+ * competing read with `begin()` and only commit when its revision is still
+ * current; local writes call `invalidate()` to make every earlier read stale.
+ * `capture()` is for reads coordinated by another hook that already owns their
+ * own call ordering, but still needs to observe local-write invalidation.
+ *
+ * A write has TWO moments that can make an in-flight read's captured
+ * revision stale, and both must call `invalidate()`:
+ *   1. The optimistic start (the local value changes immediately).
+ *   2. The settle (success OR failure — the write's server round-trip
+ *      finishes, so any read whose OWN round-trip is still in flight at that
+ *      point could still resolve with pre-write data afterward).
+ * Invalidating only at start leaves a window open: a read that begins AFTER
+ * the write starts but resolves AFTER the write settles will still observe a
+ * captured revision that predates the settle, and nothing will have moved
+ * the guard forward again to catch it. (This exact gap shipped once in
+ * useMemoryConfig's hydrate() — invalidate() was only called at toggle
+ * start, not in the write's onSettled callback — before being caught in
+ * review and fixed. Ported with that fix already applied — see
+ * `packages/ui/source-map.md`.)
+ */
+export interface AsyncCommitGuard {
+    begin: () => number;
+    capture: () => number;
+    invalidate: () => void;
+    isCurrent: (revision: number) => boolean;
+}
+export declare function createAsyncCommitGuard(): AsyncCommitGuard;
+//# sourceMappingURL=async-commit-guard.d.ts.map

package/dist/features/memory/async-commit-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-commit-guard.d.ts","sourceRoot":"","sources":["../../../src/features/memory/async-commit-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAUzD"}

package/dist/features/memory/async-commit-guard.js

@@ -0,0 +1,12 @@
+export function createAsyncCommitGuard() {
+    let currentRevision = 0;
+    return {
+        begin: () => ++currentRevision,
+        capture: () => currentRevision,
+        invalidate: () => {
+            currentRevision += 1;
+        },
+        isCurrent: (revision) => revision === currentRevision,
+    };
+}
+//# sourceMappingURL=async-commit-guard.js.map

package/dist/features/memory/async-commit-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-commit-guard.js","sourceRoot":"","sources":["../../../src/features/memory/async-commit-guard.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,sBAAsB;IACpC,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,eAAe;QAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe;QAC9B,UAAU,EAAE,GAAG,EAAE;YACf,eAAe,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,eAAe;KACtD,CAAC;AACJ,CAAC"}

package/dist/features/memory/constants.d.ts

@@ -0,0 +1,42 @@
+import type { CSSProperties } from 'react';
+import type { DraftEntry, MemoryType } from './types.js';
+export declare const TYPES: MemoryType[];
+export declare const EMPTY_DRAFT: DraftEntry;
+export declare const FIELD_LABEL_STYLE: CSSProperties;
+/**
+ * Click-to-prefill examples shown above the editor when creating a new
+ * memory. Three starters cover the most common reasons a person writes a
+ * memory by hand: tell the assistant about themselves, lock in a repeated
+ * UI/output preference, or pin the current project. Plain-English strings
+ * (not dictionary keys) per this package's i18n convention — the caller
+ * wraps each in `t()` at the render site, so `t(starter.name)` doubles as
+ * both the passthrough default and the translation-dictionary key.
+ */
+export declare const STARTERS: ReadonlyArray<{
+    type: MemoryType;
+    name: string;
+    description: string;
+    body: string;
+}>;
+export declare const MEMORY_CONNECTOR_APP_IDS: readonly ["notion", "figma", "linear", "google_drive", "github", "slack"];
+export declare const MEMORY_CONNECTOR_APP_LABELS: Record<(typeof MEMORY_CONNECTOR_APP_IDS)[number], string>;
+/** Looks up a label for a connector id that ISN'T statically known to be one
+ *  of `MEMORY_CONNECTOR_APP_IDS` — e.g. a `connectorId` string arriving from
+ *  an API response. Returns undefined for an id this app doesn't recognize,
+ *  unlike `MEMORY_CONNECTOR_APP_LABELS[id]` directly, which requires (and is
+ *  typed to guarantee) a known id. */
+export declare function connectorAppLabel(connectorId: string): string | undefined;
+/**
+ * Placeholder `provider` label for a memory-connector catalogue row this
+ * client has only an id for (no full connector detail has loaded yet).
+ * The pinned source hardcoded `'composio'` here — that's a specific
+ * third-party OAuth-integration vendor OD's real deployment happens to use,
+ * not a generic concept, so this package uses a neutral placeholder instead;
+ * a host resolving real connector details overwrites it via
+ * `applyConnectorStatuses`/discovery merge before it's ever shown as the
+ * sole source of truth.
+ */
+export declare const DEFAULT_CONNECTOR_PROVIDER = "connector-catalog";
+export declare const CONNECTOR_CALLBACK_MESSAGE_TYPE = "jini:connector-connected";
+export declare const MEMORY_CONNECTOR_PENDING_AUTH_STORAGE_KEY = "jini:memory:pending-connector-auth";
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/memory/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/memory/constants.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKzD,eAAO,MAAM,KAAK,EAAE,UAAU,EAAoE,CAAC;AAEnG,eAAO,MAAM,WAAW,EAAE,UAKzB,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,aAQ/B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,aAAa,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,CAmBA,CAAC;AAEF,eAAO,MAAM,wBAAwB,2EAA4E,CAAC;AAMlH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAOjG,CAAC;AAEF;;;;sCAIsC;AACtC,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D,eAAO,MAAM,+BAA+B,6BAA6B,CAAC;AAE1E,eAAO,MAAM,yCAAyC,uCAAuC,CAAC"}

package/dist/features/memory/constants.js

@@ -0,0 +1,87 @@
+// All manually-selectable memory types. `profile` (the structured singleton)
+// and `rule` (verified checks the POST loop enforces) join the original four
+// so the editor type-picker and the saved-memory filter pills surface them.
+export const TYPES = ['profile', 'user', 'feedback', 'project', 'reference', 'rule'];
+export const EMPTY_DRAFT = {
+    name: '',
+    description: '',
+    type: 'user',
+    body: '',
+};
+// Small uppercase caption used above each form field. Centralised so
+// every field renders with the same color/letter-spacing/baseline; this
+// is what gives the editor a settings-form rhythm rather than a stack
+// of unlabelled inputs.
+export const FIELD_LABEL_STYLE = {
+    display: 'block',
+    fontSize: 10,
+    fontWeight: 600,
+    letterSpacing: 0.5,
+    textTransform: 'uppercase',
+    color: 'var(--text-muted, #888)',
+    marginBottom: 4,
+};
+/**
+ * Click-to-prefill examples shown above the editor when creating a new
+ * memory. Three starters cover the most common reasons a person writes a
+ * memory by hand: tell the assistant about themselves, lock in a repeated
+ * UI/output preference, or pin the current project. Plain-English strings
+ * (not dictionary keys) per this package's i18n convention — the caller
+ * wraps each in `t()` at the render site, so `t(starter.name)` doubles as
+ * both the passthrough default and the translation-dictionary key.
+ */
+export const STARTERS = [
+    {
+        type: 'user',
+        name: 'About me',
+        description: 'Tell the assistant about yourself',
+        body: 'I prefer concise answers with code examples.',
+    },
+    {
+        type: 'feedback',
+        name: 'A preference I repeat often',
+        description: 'Lock in a UI or output preference',
+        body: 'Always use dark mode for generated UI.',
+    },
+    {
+        type: 'project',
+        name: 'This project',
+        description: 'Pin context about the current project',
+        body: 'This project targets a mobile-first responsive layout.',
+    },
+];
+export const MEMORY_CONNECTOR_APP_IDS = ['notion', 'figma', 'linear', 'google_drive', 'github', 'slack'];
+// Keyed by the id union itself (not a general `Record<string, string>`) so
+// adding an id above without a label here is a type error, not a silent
+// runtime fallback — this is what makes the `?? id` guard callers used to
+// need provably unnecessary.
+export const MEMORY_CONNECTOR_APP_LABELS = {
+    notion: 'Notion',
+    figma: 'Figma',
+    linear: 'Linear',
+    google_drive: 'Google Drive',
+    github: 'GitHub',
+    slack: 'Slack',
+};
+/** Looks up a label for a connector id that ISN'T statically known to be one
+ *  of `MEMORY_CONNECTOR_APP_IDS` — e.g. a `connectorId` string arriving from
+ *  an API response. Returns undefined for an id this app doesn't recognize,
+ *  unlike `MEMORY_CONNECTOR_APP_LABELS[id]` directly, which requires (and is
+ *  typed to guarantee) a known id. */
+export function connectorAppLabel(connectorId) {
+    return MEMORY_CONNECTOR_APP_LABELS[connectorId];
+}
+/**
+ * Placeholder `provider` label for a memory-connector catalogue row this
+ * client has only an id for (no full connector detail has loaded yet).
+ * The pinned source hardcoded `'composio'` here — that's a specific
+ * third-party OAuth-integration vendor OD's real deployment happens to use,
+ * not a generic concept, so this package uses a neutral placeholder instead;
+ * a host resolving real connector details overwrites it via
+ * `applyConnectorStatuses`/discovery merge before it's ever shown as the
+ * sole source of truth.
+ */
+export const DEFAULT_CONNECTOR_PROVIDER = 'connector-catalog';
+export const CONNECTOR_CALLBACK_MESSAGE_TYPE = 'jini:connector-connected';
+export const MEMORY_CONNECTOR_PENDING_AUTH_STORAGE_KEY = 'jini:memory:pending-connector-auth';
+//# sourceMappingURL=constants.js.map

package/dist/features/memory/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/memory/constants.ts"],"names":[],"mappings":"AAMA,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,KAAK,GAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAEnG,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,EAAE;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,qEAAqE;AACrE,wEAAwE;AACxE,sEAAsE;AACtE,wBAAwB;AACxB,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,yBAAyB;IAChC,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAKhB;IACH;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,8CAA8C;KACrD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,wCAAwC;KAC/C;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,wDAAwD;KAC/D;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAElH,2EAA2E;AAC3E,wEAAwE;AACxE,0EAA0E;AAC1E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,2BAA2B,GAA8D;IACpG,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;sCAIsC;AACtC,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAQ,2BAAkE,CAAC,WAAW,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE9D,MAAM,CAAC,MAAM,+BAA+B,GAAG,0BAA0B,CAAC;AAE1E,MAAM,CAAC,MAAM,yCAAyC,GAAG,oCAAoC,CAAC"}

package/dist/features/memory/dependencies.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The only file in this feature allowed to touch a concrete transport
+ * adapter. Everything else in the slice depends on `ports.ts`.
+ *
+ * Split, deliberately, into two different defaults:
+ *
+ * - `memoryConfigPort`/`memoryEntriesPort`/`memoryExtractionsPort` bind REAL
+ *   `fetch`-based adapters against a plain `/api/memory*` REST surface (list/
+ *   tree/entry CRUD, config PATCH, extraction history CRUD). Unlike
+ *   `features/connectors`' data port — which fakes its transport by design,
+ *   because the real one is a specific third-party OAuth-catalog vendor's
+ *   API shape — this is a generic JSON/REST contract with no vendor coupling,
+ *   and the pinned source's one open bug (`fetchMemoryList()` trusting an
+ *   under-validated response — see the fix below and
+ *   `packages/ui/source-map.md`) only exists to fix in a real, testable
+ *   adapter. A host is still free to supply its own binding; this default
+ *   just isn't a fake.
+ * - `memoryConnectorsPort` binds a fake/in-memory connector catalogue (same
+ *   reasoning as `features/connectors`' own fake — the real catalogue is a
+ *   vendor-specific OAuth discovery transport this package doesn't assume),
+ *   plus REAL browser-only bridges for the two pieces that touch only
+ *   generic browser APIs: pending-authorization persistence (sessionStorage)
+ *   and the cross-tab "connectors changed" signal (a `CustomEvent`).
+ *   `saveMemoryEntry` on this port is the same real HTTP adapter the entries
+ *   cluster uses — saving a connector suggestion is an ordinary memory write,
+ *   not a connector-transport concern.
+ */
+import type { Connector } from '../connectors/index.js';
+import type { MemoryConfigPort, MemoryConnectorsPort, MemoryEntriesPort, MemoryExtractionsPort } from './ports.js';
+import type { ConnectorMemorySuggestionResponse, MemoryListResponse } from './types.js';
+export declare const memoryConfigPort: MemoryConfigPort;
+/**
+ * `entries` drives the saved-memory list; `rootDir`/`index`/`enabled` are
+ * consumed directly (no fallback) by `useMemoryEntries.reload()` and
+ * `useMemoryConfig.hydrate()`.
+ *
+ * BUG FIX (ported from the pinned source with this fix applied — see
+ * `packages/ui/source-map.md`): the pinned source validated only `entries`
+ * here, even though `hydrate()`/`reload()` read `enabled`/`rootDir`/`index`
+ * off this same response with no fallback. A malformed `200` like
+ * `{ entries: [] }` passed validation and then silently hydrated those other
+ * fields to `undefined`. Fixed the same way `fetchMemoryEntry()` below
+ * already handles a missing required field: validate every field this
+ * shared read path's callers actually trust unconditionally, and throw
+ * instead of returning a response that looks like a legitimate empty state.
+ * The four per-hook flags are deliberately NOT added to this list — they
+ * keep their own established legacy-default semantics in `hydrate()`
+ * (`list.xEnabled !== false`), so their absence is intentionally not a
+ * transport failure.
+ */
+export declare function fetchMemoryList(): Promise<MemoryListResponse>;
+export declare const memoryEntriesPort: MemoryEntriesPort;
+export declare const memoryExtractionsPort: MemoryExtractionsPort;
+export interface FakeMemoryConnectorsPortOptions {
+    connectors?: Connector[];
+    suggestionResponse?: ConnectorMemorySuggestionResponse | null;
+    /** Simulated network latency in ms; 0 (default) resolves synchronously. */
+    latencyMs?: number;
+}
+/**
+ * An in-memory test/demo double for the connector-catalogue transport (same
+ * rationale as `features/connectors`' own `createFakeConnectorsPort`). Real
+ * memory writes still go through the real `saveMemoryEntry` HTTP adapter
+ * above — only the connector catalogue/status/suggest transport is faked.
+ */
+export declare function createFakeMemoryConnectorsPort(options?: FakeMemoryConnectorsPortOptions): MemoryConnectorsPort;
+export declare const memoryConnectorsPort: MemoryConnectorsPort;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/features/memory/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/features/memory/dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,SAAS,EAA6C,MAAM,wBAAwB,CAAC;AAEnG,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,iCAAiC,EAKjC,kBAAkB,EAInB,MAAM,YAAY,CAAC;AA6CpB,eAAO,MAAM,gBAAgB,EAAE,gBAE9B,CAAC;AAIF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CASnE;AA+CD,eAAO,MAAM,iBAAiB,EAAE,iBAO/B,CAAC;AAqBF,eAAO,MAAM,qBAAqB,EAAE,qBAInC,CAAC;AAIF,MAAM,WAAW,+BAA+B;IAC9C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,iCAAiC,GAAG,IAAI,CAAC;IAC9D,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,+BAAoC,GAAG,oBAAoB,CA0ClH;AAsCD,eAAO,MAAM,oBAAoB,EAAE,oBAAuD,CAAC"}