@jini-ai/ui 0.1.0

package/dist/hooks/useStableHandler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Identity-stable delegate for an event handler that closes over fresh state
+ * every render. The returned function never changes, so it can be passed to
+ * React.memo children without invalidating them, while calls always reach the
+ * latest committed closure (the ref is updated in an effect, i.e. post-commit
+ * — safe for event handlers, which only fire after commit; do not call the
+ * result during render).
+ */
+export declare function useStableHandler<Args extends unknown[], Result>(handler: (...args: Args) => Result): (...args: Args) => Result;
+//# sourceMappingURL=useStableHandler.d.ts.map

package/dist/hooks/useStableHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableHandler.d.ts","sourceRoot":"","sources":["../../src/hooks/useStableHandler.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC7D,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GACjC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAM3B"}

package/dist/hooks/useStableHandler.js

@@ -0,0 +1,17 @@
+import { useCallback, useEffect, useRef } from 'react';
+/**
+ * Identity-stable delegate for an event handler that closes over fresh state
+ * every render. The returned function never changes, so it can be passed to
+ * React.memo children without invalidating them, while calls always reach the
+ * latest committed closure (the ref is updated in an effect, i.e. post-commit
+ * — safe for event handlers, which only fire after commit; do not call the
+ * result during render).
+ */
+export function useStableHandler(handler) {
+    const ref = useRef(handler);
+    useEffect(() => {
+        ref.current = handler;
+    });
+    return useCallback((...args) => ref.current(...args), []);
+}
+//# sourceMappingURL=useStableHandler.js.map

package/dist/hooks/useStableHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableHandler.js","sourceRoot":"","sources":["../../src/hooks/useStableHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAkC;IAElC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,CAAC,GAAG,IAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+export * from './features/i18n/index.js';
+export * from './features/observability/index.js';
+export * from './features/connectors/index.js';
+export * from './features/progress-card/index.js';
+export * from './features/browser-chrome/index.js';
+export * from './features/sketch-editor/index.js';
+export * from './features/asset-grid/index.js';
+export * from './features/asset-tree-browser/index.js';
+export * from './features/viewer-shell/index.js';
+export * from './features/version-manager/index.js';
+export * from './features/html-viewer/index.js';
+export * from './features/settings-dialog/index.js';
+export * from './features/settings-dialog/tabs/appearance/index.js';
+export * from './features/settings-dialog/tabs/notifications/index.js';
+export * from './features/settings-dialog/tabs/language/index.js';
+export * from './features/settings-dialog/tabs/instructions/index.js';
+export * from './features/settings-dialog/tabs/privacy/index.js';
+export * from './features/settings-dialog/tabs/integrations/index.js';
+export * from './features/list-detail-panel/index.js';
+export * from './features/schedule-picker/index.js';
+export * from './features/mention-autocomplete/index.js';
+export * from './features/memory/index.js';
+export * from './features/source-config-list/index.js';
+export * from './features/resource-dashboard/index.js';
+export * from './features/iframe-pool/index.js';
+export * from './features/command-palette/index.js';
+export * from './features/tab-launcher-menu/index.js';
+export * from './features/revision-review/index.js';
+export * from './features/file-dropzone/index.js';
+export * from './utils/index.js';
+export * from './utils/timezone.js';
+export * from './utils/zip.js';
+export * from './utils/sse.js';
+export * from './utils/copy-to-clipboard.js';
+export * from './utils/appearance.js';
+export * from './utils/dom-subscriptions.js';
+export * from './utils/auto-open-file.js';
+export * from './utils/localized-url.js';
+export * from './utils/markdown-scroll-sync.js';
+export * from './utils/polygon-selection.js';
+export * from './utils/scroll-tabs-with-wheel.js';
+export * from './utils/color-math.js';
+export * from './utils/design-md.js';
+export * from './react/hooks/useInView.js';
+export * from './react/hooks/useCoalescedCallback.js';
+export * from './react/hooks/useStableHandler.js';
+export * from './react/hooks/useDebouncedValue.js';
+export * from './react/hooks/useResizableSplitPane.js';
+export * from './react/hooks/useBrandFonts.js';
+export * from './react/hooks/useEdgeAutoScroll.js';
+export * from './browser/useModalWindowDragGuard.js';
+export * from './browser/index.js';
+export * from './react/components/Icon.js';
+export * from './react/components/RemixIcon.js';
+export * from './react/components/AgentIcon.js';
+export * from './react/components/Toast.js';
+export * from './react/components/Loading.js';
+export * from './react/components/TooltipLayer.js';
+export * from './react/components/CustomSelect.js';
+export * from './react/components/KitErrorBoundary.js';
+export * from './react/components/LanguageMenu.js';
+export * from './react/components/WorkingDirPicker.js';
+export * from './react/components/AppChromeHeader.js';
+export * from './react/components/ExportDiagnosticsButton.js';
+export * from './react/components/PaletteTweaks.js';
+export * from './react/components/OptionCards.js';
+export * from './react/components/CompactToggle.js';
+export * from './react/components/ToggleRow.js';
+export * from './react/components/StatCard.js';
+export * from './react/components/Notice.js';
+export * from './react/components/ImportChoice.js';
+export * from './react/components/FileImportPanel.js';
+export * from './react/components/OnboardingPanelHeader.js';
+export * from './react/components/OnboardingChipField.js';
+export * from './react/components/OnboardingDropdown.js';
+export * from './react/components/BrandLogo.js';
+export * from './react/components/HeaderActionsMenu.js';
+export * from './react/components/EdgeScrollZones.js';
+export * from './react/components/PillButton.js';
+export * from './react/components/PopoverMenu.js';
+export * from './react/components/PopoverItem.js';
+export * from './react/components/EditorIcon.js';
+export * from './react/components/TokenChip.js';
+export * from './react/components/ValueChip.js';
+export * from './react/components/ComponentKitPreview.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,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,mDAAmD,CAAC;AAClE,cAAc,uDAAuD,CAAC;AACtE,cAAc,kDAAkD,CAAC;AACjE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,sCAAsC,CAAC;AAErD,cAAc,oBAAoB,CAAC;AAEnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC"}

package/dist/index.js

@@ -0,0 +1,90 @@
+// @jini-ai/ui — generic, product-neutral UI primitives.
+// See packages/ui/README.md for scope and packages/ui/source-map.md for
+// provenance (multiple porting tasks land content here in parallel; see
+// that file's per-section breakdown).
+export * from './features/i18n/index.js';
+export * from './features/observability/index.js';
+export * from './features/connectors/index.js';
+export * from './features/progress-card/index.js';
+export * from './features/browser-chrome/index.js';
+export * from './features/sketch-editor/index.js';
+export * from './features/asset-grid/index.js';
+export * from './features/asset-tree-browser/index.js';
+export * from './features/viewer-shell/index.js';
+export * from './features/version-manager/index.js';
+export * from './features/html-viewer/index.js';
+export * from './features/settings-dialog/index.js';
+export * from './features/settings-dialog/tabs/appearance/index.js';
+export * from './features/settings-dialog/tabs/notifications/index.js';
+export * from './features/settings-dialog/tabs/language/index.js';
+export * from './features/settings-dialog/tabs/instructions/index.js';
+export * from './features/settings-dialog/tabs/privacy/index.js';
+export * from './features/settings-dialog/tabs/integrations/index.js';
+export * from './features/list-detail-panel/index.js';
+export * from './features/schedule-picker/index.js';
+export * from './features/mention-autocomplete/index.js';
+export * from './features/memory/index.js';
+export * from './features/source-config-list/index.js';
+export * from './features/resource-dashboard/index.js';
+export * from './features/iframe-pool/index.js';
+export * from './features/command-palette/index.js';
+export * from './features/tab-launcher-menu/index.js';
+export * from './features/revision-review/index.js';
+export * from './features/file-dropzone/index.js';
+export * from './utils/index.js';
+export * from './utils/timezone.js';
+export * from './utils/zip.js';
+export * from './utils/sse.js';
+export * from './utils/copy-to-clipboard.js';
+export * from './utils/appearance.js';
+export * from './utils/dom-subscriptions.js';
+export * from './utils/auto-open-file.js';
+export * from './utils/localized-url.js';
+export * from './utils/markdown-scroll-sync.js';
+export * from './utils/polygon-selection.js';
+export * from './utils/scroll-tabs-with-wheel.js';
+export * from './utils/color-math.js';
+export * from './utils/design-md.js';
+export * from './react/hooks/useInView.js';
+export * from './react/hooks/useCoalescedCallback.js';
+export * from './react/hooks/useStableHandler.js';
+export * from './react/hooks/useDebouncedValue.js';
+export * from './react/hooks/useResizableSplitPane.js';
+export * from './react/hooks/useBrandFonts.js';
+export * from './react/hooks/useEdgeAutoScroll.js';
+export * from './browser/useModalWindowDragGuard.js';
+export * from './browser/index.js';
+export * from './react/components/Icon.js';
+export * from './react/components/RemixIcon.js';
+export * from './react/components/AgentIcon.js';
+export * from './react/components/Toast.js';
+export * from './react/components/Loading.js';
+export * from './react/components/TooltipLayer.js';
+export * from './react/components/CustomSelect.js';
+export * from './react/components/KitErrorBoundary.js';
+export * from './react/components/LanguageMenu.js';
+export * from './react/components/WorkingDirPicker.js';
+export * from './react/components/AppChromeHeader.js';
+export * from './react/components/ExportDiagnosticsButton.js';
+export * from './react/components/PaletteTweaks.js';
+export * from './react/components/OptionCards.js';
+export * from './react/components/CompactToggle.js';
+export * from './react/components/ToggleRow.js';
+export * from './react/components/StatCard.js';
+export * from './react/components/Notice.js';
+export * from './react/components/ImportChoice.js';
+export * from './react/components/FileImportPanel.js';
+export * from './react/components/OnboardingPanelHeader.js';
+export * from './react/components/OnboardingChipField.js';
+export * from './react/components/OnboardingDropdown.js';
+export * from './react/components/BrandLogo.js';
+export * from './react/components/HeaderActionsMenu.js';
+export * from './react/components/EdgeScrollZones.js';
+export * from './react/components/PillButton.js';
+export * from './react/components/PopoverMenu.js';
+export * from './react/components/PopoverItem.js';
+export * from './react/components/EditorIcon.js';
+export * from './react/components/TokenChip.js';
+export * from './react/components/ValueChip.js';
+export * from './react/components/ComponentKitPreview.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,wDAAwD;AACxD,wEAAwE;AACxE,wEAAwE;AACxE,sCAAsC;AAEtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,mDAAmD,CAAC;AAClE,cAAc,uDAAuD,CAAC;AACtE,cAAc,kDAAkD,CAAC;AACjE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,sCAAsC,CAAC;AAErD,cAAc,oBAAoB,CAAC;AAEnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC"}

package/dist/react/components/AgentIcon.d.ts

@@ -0,0 +1,15 @@
+interface Props {
+    id: string;
+    size?: number;
+    className?: string;
+    /** Base path assets are served from. Defaults to `/agent-icons`. */
+    basePath?: string;
+}
+/**
+ * Renders a coding-agent's brand mark by id, with a graceful initial-letter
+ * fallback for ids the host hasn't shipped artwork for. Assets are expected
+ * to live under `${basePath}/<id>.<ext>` (default basePath `/agent-icons`).
+ */
+export declare function AgentIcon({ id, size, className, basePath }: Props): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=AgentIcon.d.ts.map

package/dist/react/components/AgentIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentIcon.d.ts","sourceRoot":"","sources":["../../../src/react/components/AgentIcon.tsx"],"names":[],"mappings":"AAEA,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkDD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,IAAS,EAAE,SAAS,EAAE,QAAyB,EAAE,EAAE,KAAK,+BAkDvF"}

package/dist/react/components/AgentIcon.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Coding-agent CLIs that ship a bundled brand asset under the host's
+// `<basePath>/` (e.g. a public `/agent-icons/` directory). SVG is preferred
+// (resolution-independent, single file ≤ a few KB); PNG is the fallback for
+// vendors that don't publish an SVG mark. New brand: drop the optimised file
+// in that folder and add the id here.
+const ICON_EXT = {
+    amr: 'svg',
+    claude: 'svg',
+    codex: 'svg',
+    gemini: 'svg',
+    opencode: 'svg',
+    'cursor-agent': 'svg',
+    copilot: 'svg',
+    qwen: 'svg',
+    qoder: 'svg',
+    deepseek: 'svg',
+    reasonix: 'svg',
+    mimo: 'svg',
+    hermes: 'svg',
+    'grok-build': 'svg',
+    kimi: 'svg',
+    pi: 'svg',
+    kiro: 'svg',
+    kilo: 'svg',
+    vibe: 'svg',
+    antigravity: 'svg',
+    aider: 'png',
+    'trae-cli': 'png',
+    devin: 'png',
+};
+// SVG marks that are single-color silhouettes (no baked brand colors).
+// Rendered as a CSS-masked `<span>` so `background-color: currentColor`
+// can paint them in whatever text color the surrounding theme resolves
+// to — light text under dark theme, dark text under light theme. The
+// SVG file itself uses an explicit dark fill (baked) instead of
+// `currentColor`, so if anything outside this component ever loads
+// the asset through `<img>` it still renders as a legible dark mark
+// rather than collapsing to the SVG document's default black-on-…-black.
+const MONO_ICONS = new Set([
+    'cursor-agent',
+    'opencode',
+    'hermes',
+    'mimo',
+    'kilo',
+    'grok-build',
+]);
+/**
+ * Renders a coding-agent's brand mark by id, with a graceful initial-letter
+ * fallback for ids the host hasn't shipped artwork for. Assets are expected
+ * to live under `${basePath}/<id>.<ext>` (default basePath `/agent-icons`).
+ */
+export function AgentIcon({ id, size = 36, className, basePath = '/agent-icons' }) {
+    const cls = 'agent-icon' + (className ? ' ' + className : '');
+    const ext = ICON_EXT[id];
+    if (ext) {
+        if (ext === 'svg' && MONO_ICONS.has(id)) {
+            const src = `${basePath}/${id}.svg`;
+            const style = {
+                width: size,
+                height: size,
+                WebkitMaskImage: `url("${src}")`,
+                maskImage: `url("${src}")`,
+            };
+            return (_jsx("span", { className: cls + ' agent-icon-mono', style: style, "aria-hidden": "true" }));
+        }
+        return (_jsx("img", { src: `${basePath}/${id}.${ext}`, alt: "", width: size, height: size, className: cls, "aria-hidden": "true", draggable: false }));
+    }
+    // Fallback for brands we don't ship artwork for. A neutral rounded
+    // square with the initial letter — reads as "no official mark yet"
+    // without inventing brand artwork we can't license.
+    const initial = (id.match(/[a-z]/i)?.[0] ?? '?').toUpperCase();
+    return (_jsx("span", { className: cls + ' agent-icon-fallback', style: {
+            width: size,
+            height: size,
+            fontSize: Math.round(size * 0.42),
+            lineHeight: 1,
+        }, "aria-hidden": "true", children: initial }));
+}
+//# sourceMappingURL=AgentIcon.js.map

package/dist/react/components/AgentIcon.js.map

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

package/dist/react/components/AppChromeHeader.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+interface Props {
+    actions?: ReactNode;
+    children?: ReactNode;
+    fileActionsBefore?: ReactNode;
+    onBack?: () => void;
+    backLabel?: string;
+    showTrafficSpace?: boolean;
+}
+export declare const APP_CHROME_FILE_ACTIONS_ID = "app-chrome-file-actions";
+export declare const APP_CHROME_FILE_ACTIONS_SELECTOR = "[data-app-chrome-file-actions=\"true\"]";
+export declare function AppChromeHeader({ actions, children, fileActionsBefore, onBack, backLabel, showTrafficSpace, }: Props): import("react").JSX.Element;
+export declare function SettingsIconButton({ onClick, title, ariaLabel, }: {
+    onClick: () => void;
+    title: string;
+    ariaLabel: string;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=AppChromeHeader.d.ts.map

package/dist/react/components/AppChromeHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppChromeHeader.d.ts","sourceRoot":"","sources":["../../../src/react/components/AppChromeHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,UAAU,KAAK;IACb,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AACpE,eAAO,MAAM,gCAAgC,4CAA0C,CAAC;AAExF,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,MAAM,EACN,SAAkB,EAClB,gBAAuB,GACxB,EAAE,KAAK,+BA4BP;AAED,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,KAAK,EACL,SAAS,GACV,EAAE;IACD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,+BAcA"}

package/dist/react/components/AppChromeHeader.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { RemixIcon } from './RemixIcon';
+export const APP_CHROME_FILE_ACTIONS_ID = 'app-chrome-file-actions';
+export const APP_CHROME_FILE_ACTIONS_SELECTOR = '[data-app-chrome-file-actions="true"]';
+export function AppChromeHeader({ actions, children, fileActionsBefore, onBack, backLabel = 'Back', showTrafficSpace = true, }) {
+    return (_jsxs("header", { className: "app-chrome-header", children: [showTrafficSpace ? _jsx("div", { className: "app-chrome-traffic-space", "aria-hidden": true }) : null, onBack ? (_jsx("button", { type: "button", className: "app-chrome-back jini-tooltip", onClick: onBack, title: backLabel, "data-tooltip": backLabel, "data-tooltip-placement": "bottom", "aria-label": backLabel, children: _jsx(RemixIcon, { name: "arrow-left-line", size: 16 }) })) : null, children ? _jsx("div", { className: "app-chrome-content", children: children }) : null, _jsx("div", { className: "app-chrome-drag", "aria-hidden": true }), fileActionsBefore ? _jsx("div", { className: "app-chrome-file-actions-before", children: fileActionsBefore }) : null, _jsx("div", { id: APP_CHROME_FILE_ACTIONS_ID, className: "app-chrome-file-actions", "data-app-chrome-file-actions": "true" }), actions ? _jsx("div", { className: "app-chrome-actions", children: actions }) : null] }));
+}
+export function SettingsIconButton({ onClick, title, ariaLabel, }) {
+    return (_jsx("button", { type: "button", className: "settings-icon-btn jini-tooltip", onClick: onClick, title: title, "data-tooltip": title, "data-tooltip-placement": "bottom", "aria-label": ariaLabel, children: _jsx(RemixIcon, { name: "settings-line", size: 18 }) }));
+}
+//# sourceMappingURL=AppChromeHeader.js.map

package/dist/react/components/AppChromeHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppChromeHeader.js","sourceRoot":"","sources":["../../../src/react/components/AppChromeHeader.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAWxC,MAAM,CAAC,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AACpE,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAuC,CAAC;AAExF,MAAM,UAAU,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,MAAM,EACN,SAAS,GAAG,MAAM,EAClB,gBAAgB,GAAG,IAAI,GACjB;IACN,OAAO,CACL,kBAAQ,SAAS,EAAC,mBAAmB,aAClC,gBAAgB,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,0BAA0B,wBAAe,CAAC,CAAC,CAAC,IAAI,EAClF,MAAM,CAAC,CAAC,CAAC,CACR,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,8BAA8B,EACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,kBACF,SAAS,4BACA,QAAQ,gBACnB,SAAS,YAErB,KAAC,SAAS,IAAC,IAAI,EAAC,iBAAiB,EAAC,IAAI,EAAE,EAAE,GAAI,GACvC,CACV,CAAC,CAAC,CAAC,IAAI,EACP,QAAQ,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,oBAAoB,YAAE,QAAQ,GAAO,CAAC,CAAC,CAAC,IAAI,EACvE,cAAK,SAAS,EAAC,iBAAiB,wBAAe,EAC9C,iBAAiB,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,gCAAgC,YAAE,iBAAiB,GAAO,CAAC,CAAC,CAAC,IAAI,EACrG,cACE,EAAE,EAAE,0BAA0B,EAC9B,SAAS,EAAC,yBAAyB,kCACN,MAAM,GACnC,EACD,OAAO,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,oBAAoB,YAAE,OAAO,GAAO,CAAC,CAAC,CAAC,IAAI,IAC9D,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,KAAK,EACL,SAAS,GAKV;IACC,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,gCAAgC,EAC1C,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,kBACE,KAAK,4BACI,QAAQ,gBACnB,SAAS,YAErB,KAAC,SAAS,IAAC,IAAI,EAAC,eAAe,EAAC,IAAI,EAAE,EAAE,GAAI,GACrC,CACV,CAAC;AACJ,CAAC"}

package/dist/react/components/BrandLogo.d.ts

@@ -0,0 +1,77 @@
+export type LogoStage = 'brand' | 'custom' | 'favicon' | 'letter';
+export interface BrandLogoProps {
+    /** Opaque id resolved to a logo URL via `resolveBrandLogoUrl`, when supplied. */
+    brandId?: string;
+    logoSrc?: string | null;
+    host?: string;
+    name: string;
+    faviconSize: number;
+    className?: string;
+    fallbackClassName?: string;
+    /** Builds a logo URL for `brandId`. Omit to skip the brand-service stage entirely. */
+    resolveBrandLogoUrl?: (brandId: string) => string;
+    /** Builds a favicon URL for `host`. Defaults to Google's public favicon service. */
+    resolveFaviconUrl?: (host: string, size: number) => string;
+}
+export declare function buildFaviconUrl(host: string, size: number): string;
+/** The monogram shown when no image source is resolvable. */
+export declare function brandMonogram(name: string): string;
+/** The stage to start at, given which sources are available. */
+export declare function firstLogoStage(opts: {
+    canUseBrandStage: boolean;
+    logoSrc?: string | null | undefined;
+    host?: string | undefined;
+}): LogoStage;
+/** The next stage to try after the current one fails to load. */
+export declare function advanceLogoStage(stage: LogoStage, opts: {
+    logoSrc?: string | null | undefined;
+    host?: string | undefined;
+}): LogoStage;
+/** The image `src` for the current stage, or `null` when the letter fallback applies. */
+export declare function resolveLogoSrc(opts: {
+    stage: LogoStage;
+    brandId?: string | undefined;
+    resolveBrandLogoUrl?: ((brandId: string) => string) | undefined;
+    logoSrc?: string | null | undefined;
+    host?: string | undefined;
+    faviconSize: number;
+    resolveFaviconUrl: (host: string, size: number) => string;
+}): string | null;
+export interface UseLogoStageResult {
+    stage: LogoStage;
+    /** Advance to the next fallback stage (wired to the <img>'s onError). */
+    fallback: () => void;
+}
+/**
+ * Holds the current fallback stage. Resets to `first` whenever the resolvable
+ * inputs change, and exposes `fallback` to advance one stage on load failure.
+ */
+export declare function useLogoStage(params: {
+    first: LogoStage;
+    logoSrc?: string | null | undefined;
+    host?: string | undefined;
+    canUseBrandStage: boolean;
+}): UseLogoStageResult;
+/** Memoized image `src` for a stage; recomputes only when its inputs change. */
+export declare function useResolvedLogoSrc(opts: {
+    stage: LogoStage;
+    brandId?: string | undefined;
+    resolveBrandLogoUrl?: ((brandId: string) => string) | undefined;
+    logoSrc?: string | null | undefined;
+    host?: string | undefined;
+    faviconSize: number;
+    resolveFaviconUrl: (host: string, size: number) => string;
+}): string | null;
+export interface UseBrandLogoResult {
+    /** The resolved image source, or `null` to render the monogram fallback. */
+    src: string | null;
+    /** Advance to the next fallback stage (wired to the <img>'s onError). */
+    fallback: () => void;
+}
+/**
+ * Composes the whole fallback chain — stage derivation, the load/fallback state
+ * machine, and src resolution — so {@link BrandLogo} is a dumb render.
+ */
+export declare function useBrandLogo(props: BrandLogoProps): UseBrandLogoResult;
+export declare function BrandLogo(props: BrandLogoProps): import("react").JSX.Element;
+//# sourceMappingURL=BrandLogo.d.ts.map

package/dist/react/components/BrandLogo.d.ts.map

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

package/dist/react/components/BrandLogo.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// BrandLogo — a resilient brand/site logo with a fallback chain: a
+// host-resolved brand-service URL (when a `brandId` + resolver are supplied),
+// else an explicit `logoSrc`, else a favicon lookup for `host`, else a
+// monogram initial. Each stage that fails to load (`onError`) advances to the
+// next, so a broken brand-service image or a dead favicon never renders the
+// browser's broken-image glyph.
+import { useCallback, useEffect, useMemo, useState } from 'react';
+// ---------------------------------------------------------------------------
+// Pure helpers — no React, directly unit-testable.
+// ---------------------------------------------------------------------------
+export function buildFaviconUrl(host, size) {
+    return `https://www.google.com/s2/favicons?domain=${encodeURIComponent(host)}&sz=${size}`;
+}
+/** The monogram shown when no image source is resolvable. */
+export function brandMonogram(name) {
+    return name.slice(0, 1).toUpperCase();
+}
+/** The stage to start at, given which sources are available. */
+export function firstLogoStage(opts) {
+    return opts.canUseBrandStage ? 'brand' : opts.logoSrc ? 'custom' : opts.host ? 'favicon' : 'letter';
+}
+/** The next stage to try after the current one fails to load. */
+export function advanceLogoStage(stage, opts) {
+    if (stage === 'brand')
+        return opts.logoSrc ? 'custom' : opts.host ? 'favicon' : 'letter';
+    if (stage === 'custom')
+        return 'favicon';
+    return 'letter';
+}
+/** The image `src` for the current stage, or `null` when the letter fallback applies. */
+export function resolveLogoSrc(opts) {
+    const { stage, brandId, resolveBrandLogoUrl, logoSrc, host, faviconSize, resolveFaviconUrl } = opts;
+    if (stage === 'brand' && brandId && resolveBrandLogoUrl)
+        return resolveBrandLogoUrl(brandId);
+    if (stage === 'custom' && logoSrc)
+        return logoSrc;
+    if (stage === 'favicon' && host)
+        return resolveFaviconUrl(host, faviconSize);
+    return null;
+}
+/**
+ * Holds the current fallback stage. Resets to `first` whenever the resolvable
+ * inputs change, and exposes `fallback` to advance one stage on load failure.
+ */
+export function useLogoStage(params) {
+    const { first, logoSrc, host, canUseBrandStage } = params;
+    const [stage, setStage] = useState(first);
+    useEffect(() => {
+        setStage(first);
+    }, [first, canUseBrandStage, logoSrc, host]);
+    const fallback = useCallback(() => {
+        setStage((current) => advanceLogoStage(current, { logoSrc, host }));
+    }, [logoSrc, host]);
+    return { stage, fallback };
+}
+/** Memoized image `src` for a stage; recomputes only when its inputs change. */
+export function useResolvedLogoSrc(opts) {
+    const { stage, brandId, resolveBrandLogoUrl, logoSrc, host, faviconSize, resolveFaviconUrl } = opts;
+    return useMemo(() => resolveLogoSrc({ stage, brandId, resolveBrandLogoUrl, logoSrc, host, faviconSize, resolveFaviconUrl }), [stage, brandId, resolveBrandLogoUrl, logoSrc, host, faviconSize, resolveFaviconUrl]);
+}
+/**
+ * Composes the whole fallback chain — stage derivation, the load/fallback state
+ * machine, and src resolution — so {@link BrandLogo} is a dumb render.
+ */
+export function useBrandLogo(props) {
+    const { brandId, logoSrc, host, faviconSize, resolveBrandLogoUrl, resolveFaviconUrl = buildFaviconUrl, } = props;
+    const canUseBrandStage = Boolean(brandId && resolveBrandLogoUrl);
+    const first = firstLogoStage({ canUseBrandStage, logoSrc, host });
+    const { stage, fallback } = useLogoStage({ first, logoSrc, host, canUseBrandStage });
+    const src = useResolvedLogoSrc({
+        stage,
+        brandId,
+        resolveBrandLogoUrl,
+        logoSrc,
+        host,
+        faviconSize,
+        resolveFaviconUrl,
+    });
+    return { src, fallback };
+}
+// ---------------------------------------------------------------------------
+// Component — dumb render, all logic delegated above.
+// ---------------------------------------------------------------------------
+export function BrandLogo(props) {
+    const { name, className, fallbackClassName } = props;
+    const { src, fallback } = useBrandLogo(props);
+    if (!src) {
+        return (_jsx("span", { className: fallbackClassName, "aria-hidden": true, children: brandMonogram(name) }));
+    }
+    return (_jsx("img", { className: className, src: src, alt: "", loading: "lazy", referrerPolicy: "no-referrer", onError: fallback }));
+}
+//# sourceMappingURL=BrandLogo.js.map

package/dist/react/components/BrandLogo.js.map

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

package/dist/react/components/CompactToggle.d.ts

@@ -0,0 +1,10 @@
+export interface CompactToggleProps {
+    label: string;
+    hint?: string;
+    checked: boolean;
+    disabled?: boolean;
+    onChange: (value: boolean) => void;
+    className?: string;
+}
+export declare function CompactToggle({ label, hint, checked, onChange, disabled, className, }: CompactToggleProps): import("react").JSX.Element;
+//# sourceMappingURL=CompactToggle.d.ts.map

package/dist/react/components/CompactToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactToggle.d.ts","sourceRoot":"","sources":["../../../src/react/components/CompactToggle.tsx"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,EAAE,kBAAkB,+BAqBpB"}

package/dist/react/components/CompactToggle.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function CompactToggle({ label, hint, checked, onChange, disabled, className, }) {
+    return (_jsxs("button", { type: "button", className: [
+            'compact-toggle',
+            checked ? 'on' : '',
+            disabled ? 'disabled' : '',
+            className,
+        ].filter(Boolean).join(' '), onClick: () => {
+            if (!disabled)
+                onChange(!checked);
+        }, "aria-pressed": checked, disabled: disabled, title: hint, children: [_jsx("span", { className: "compact-toggle-label", children: label }), _jsx("span", { className: "compact-toggle-switch", "aria-hidden": true })] }));
+}
+//# sourceMappingURL=CompactToggle.js.map

package/dist/react/components/CompactToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactToggle.js","sourceRoot":"","sources":["../../../src/react/components/CompactToggle.tsx"],"names":[],"mappings":";AAgBA,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,GACU;IACnB,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE;YACT,gBAAgB;YAChB,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACnB,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;YAC1B,SAAS;SACV,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAC3B,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC,QAAQ;gBAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,kBACa,OAAO,EACrB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,IAAI,aAEX,eAAM,SAAS,EAAC,sBAAsB,YAAE,KAAK,GAAQ,EACrD,eAAM,SAAS,EAAC,uBAAuB,wBAAe,IAC/C,CACV,CAAC;AACJ,CAAC"}