@jini-ai/ui 0.1.1 → 0.3.0

package/dist/features/mcp-ui/surfaces/text-input.js

@@ -0,0 +1,61 @@
+/**
+ * @module features/mcp-ui/surfaces/text-input
+ *
+ * The free-text control fragment — `<input type="text">`, `<input type="number">`, or `<textarea>`
+ * depending on the props, because all three are the same field to a caller (a labelled box you type
+ * into) and differ only in how the value is read back.
+ */
+import { escapeHtml } from '../escape.js';
+import { fieldDescribedBy, fieldElementId, renderFieldLabel } from './document.js';
+function optionalAttribute(name, value) {
+    if (value === undefined)
+        return '';
+    return ` ${name}="${escapeHtml(String(value))}"`;
+}
+function booleanAttribute(name, value) {
+    return value === true ? ` ${name}` : '';
+}
+/**
+ * Resolves which HTML `type` a text control renders as. `'number'` wins over `secret` — there is no
+ * masked number input, and `TextInputProps.secret`'s own doc comment already fixes that precedence.
+ *
+ * @param props - The `inputType`/`secret` slice of {@link TextInputProps}.
+ * @returns The concrete `<input type>` value.
+ * @complexity O(1).
+ */
+function resolveInputType(props) {
+    if (props.inputType === 'number')
+        return 'number';
+    return props.secret === true ? 'password' : 'text';
+}
+/**
+ * Renders one free-text field: its label, hint, and control, wrapped in `.mcpui-field`.
+ *
+ * @param props - See {@link TextInputProps}.
+ * @returns An HTML fragment. Not a whole document — compose it with `form.ts`.
+ * @complexity O(n) in the rendered length.
+ */
+export function renderTextInput(props) {
+    const id = fieldElementId(props.name);
+    const common = ` id="${escapeHtml(id)}" name="${escapeHtml(props.name)}"` +
+        optionalAttribute('placeholder', props.placeholder) +
+        booleanAttribute('required', props.required) +
+        booleanAttribute('disabled', props.disabled) +
+        fieldDescribedBy(props);
+    const type = resolveInputType(props);
+    const isNumber = type === 'number';
+    const control = props.multiline === true && type === 'text'
+        ? `<textarea class="mcpui-textarea"${common}${optionalAttribute('rows', props.rows)}>${props.value === undefined ? '' : escapeHtml(String(props.value))}</textarea>`
+        : `<input class="mcpui-input" type="${type}"${common}` +
+            optionalAttribute('value', props.value) +
+            // A stored secret (e.g. a cloud provider's access key) must never be offered to a browser's
+            // password manager as a saveable website login — it belongs to this `ui://` surface, not a
+            // credential the browser should remember.
+            (props.secret === true ? optionalAttribute('autocomplete', 'off') : '') +
+            (isNumber
+                ? optionalAttribute('min', props.min) + optionalAttribute('max', props.max) + optionalAttribute('step', props.step)
+                : '') +
+            '>';
+    return `<div class="mcpui-field">\n${renderFieldLabel(props)}\n${control}\n</div>`;
+}
+//# sourceMappingURL=text-input.js.map

package/dist/features/mcp-ui/surfaces/text-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.js","sourceRoot":"","sources":["../../../../src/features/mcp-ui/surfaces/text-input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA6BnF,SAAS,iBAAiB,CAAC,IAAY,EAAE,KAAkC;IACzE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,IAAI,IAAI,KAAK,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAA0B;IAChE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,KAAmD;IAC3E,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GACV,QAAQ,UAAU,CAAC,EAAE,CAAC,WAAW,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;QAC1D,iBAAiB,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC;QACnD,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;QAC5C,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;QAC5C,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE1B,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,KAAK,MAAM;QACzD,CAAC,CAAC,mCAAmC,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,aAAa;QACpK,CAAC,CAAC,oCAAoC,IAAI,IAAI,MAAM,EAAE;YACpD,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;YACvC,4FAA4F;YAC5F,2FAA2F;YAC3F,0CAA0C;YAC1C,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,CAAC,QAAQ;gBACP,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;gBACnH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC;IAER,OAAO,8BAA8B,gBAAgB,CAAC,KAAK,CAAC,KAAK,OAAO,UAAU,CAAC;AACrF,CAAC"}

package/dist/features/mcp-ui/surfaces/tokens.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @module features/mcp-ui/surfaces/tokens
+ *
+ * The design tokens every generated surface declares, and the reason they are declared *in the
+ * document* rather than referenced from a stylesheet.
+ *
+ * A surface renders in a sandboxed, opaque-origin iframe with no network and no shared stylesheet.
+ * An undeclared custom property there does not fall back to a host value — there is no host value
+ * to fall back to — it resolves to nothing, and the declaration using it is dropped. So a token
+ * referenced but not declared is not a degraded style, it is an invisible one: text with no color,
+ * a button with no background. {@link renderTokenBlock} exists so every surface's first `<style>`
+ * tag declares the complete set, always, and `var(--x, fallback)` is reserved for values that are
+ * genuinely optional rather than used as insurance against this failure.
+ *
+ * The derived tokens below are `color-mix()` expressions over the base tokens rather than second
+ * color literals. That is what makes the palette reskinnable: overriding `--jini-mcpui-accent`
+ * alone moves the accent, its hover state, its focus ring, and its tinted background together,
+ * because all four resolve through it.
+ *
+ * `@jini-ai/ui` has no package-wide custom-property design system to reuse (checked: its only two
+ * stylesheets, `react/chat/styles/reference.css` and the Remix icon font, declare no custom
+ * properties at all), so these are namespaced `--jini-mcpui-*` to stay out of the way of one if it
+ * ever lands.
+ *
+ * ## Dark mode
+ *
+ * {@link SURFACE_TOKENS_DARK} is the same key set with dark values, applied by
+ * {@link renderTokenBlock} inside a `@media (prefers-color-scheme: dark)` block that redeclares only
+ * the base tokens — never {@link DERIVED_TOKENS}. A derived token's own declaration still says
+ * `color-mix(in srgb, var(--jini-mcpui-accent) …)`; it does not need a dark-specific line because the
+ * browser resolves that `var()` against whichever `--jini-mcpui-accent` cascades on the element at
+ * used-value time, light or dark. Redeclaring a derived token per scheme would just be two ways to
+ * get the same answer with an extra place for them to drift.
+ *
+ * Currently moot: {@link FORCE_LIGHT_SURFACE_THEME} suppresses the dark block entirely, because
+ * `prefers-color-scheme` reads the OS/browser, not any real app theme — see that constant's own doc.
+ */
+/**
+ * The base palette, radius scale, and font stack.
+ *
+ * Font stacks are system-only and always will be: a sandboxed iframe has no network, so an
+ * `@import` or a `<link>` to a web font is a request that cannot be made, and the surface would
+ * render in whatever the engine falls back to after a delay.
+ */
+export declare const SURFACE_TOKENS: {
+    readonly '--jini-mcpui-bg': "#faf9f7";
+    readonly '--jini-mcpui-panel': "#fdfcfa";
+    readonly '--jini-mcpui-border': "#e1e5eb";
+    readonly '--jini-mcpui-border-strong': "#c9d0da";
+    readonly '--jini-mcpui-text': "#1a1916";
+    readonly '--jini-mcpui-text-strong': "#0d0c0a";
+    readonly '--jini-mcpui-text-muted': "#74716b";
+    readonly '--jini-mcpui-text-soft': "#989590";
+    readonly '--jini-mcpui-text-faint': "#b3b0a8";
+    readonly '--jini-mcpui-accent': "#c96442";
+    readonly '--jini-mcpui-accent-strong': "#b45a3b";
+    readonly '--jini-mcpui-danger': "#a8443a";
+    readonly '--jini-mcpui-radius-xs': "4px";
+    readonly '--jini-mcpui-radius-sm': "6px";
+    readonly '--jini-mcpui-radius-md': "8px";
+    readonly '--jini-mcpui-radius-lg': "10px";
+    readonly '--jini-mcpui-radius-xl': "12px";
+    readonly '--jini-mcpui-radius-pill': "999px";
+    readonly '--jini-mcpui-font': "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Arial, sans-serif";
+    readonly '--jini-mcpui-font-mono': "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
+};
+/** The token names a caller may override. */
+export type SurfaceTokenName = keyof typeof SURFACE_TOKENS;
+/**
+ * The dark-scheme value for every token in {@link SURFACE_TOKENS}, keyed the same way and typed as
+ * `Record<SurfaceTokenName, string>` rather than a partial — a token added to the light palette and
+ * forgotten here would not fail to compile, so the full-parity type is what catches it instead.
+ * Radius and font values are repeated verbatim: they do not change with scheme, but the record needs
+ * every key regardless, and a value can only be omitted by weakening the type that guards this file
+ * against exactly that omission.
+ */
+export declare const SURFACE_TOKENS_DARK: Record<SurfaceTokenName, string>;
+/**
+ * Whether every generated surface is pinned to the light palette regardless of the embedding
+ * browser/OS's `prefers-color-scheme`.
+ *
+ * True today because Tovu — currently this package's only consumer — has no real light/dark toggle
+ * yet (`apps/admin`'s Appearance section is a disabled "SOON" placeholder), so a surface that honors
+ * the OS preference doesn't track any actual app theme — it tracks whatever the operator's OS
+ * happens to be set to, which produces a dark card floating in an always-light admin UI. Flip this
+ * to `false` once Tovu has a real app-level theme signal to forward in; nothing else about
+ * {@link renderTokenBlock} needs to change.
+ */
+export declare const FORCE_LIGHT_SURFACE_THEME = true;
+/**
+ * Renders the `:root` declaration block for a surface document, plus — unless
+ * {@link FORCE_LIGHT_SURFACE_THEME} is set — a `prefers-color-scheme: dark` variant of it.
+ *
+ * @param overrides - Base tokens to replace, applied in both schemes. Unknown names are a compile
+ * error, not a silent no-op, because a mistyped token name would otherwise leave the real one at its
+ * default and produce a surface that looks unstyled for no visible reason. Values are emitted
+ * verbatim — a caller passing a token value is trusted the same way it is trusted with the surface's
+ * own body HTML. A caller wanting scheme-specific values is not served by this parameter; it exists
+ * for a host's brand tokens, which by design apply the same way regardless of scheme.
+ * @returns A `:root { … }` block, followed by a `@media (prefers-color-scheme: dark) { :root { … } }`
+ * block unless {@link FORCE_LIGHT_SURFACE_THEME} suppresses it, ready to paste into the first
+ * `<style>` tag.
+ * @complexity O(n) in the number of tokens.
+ */
+export declare function renderTokenBlock(overrides?: Partial<Record<SurfaceTokenName, string>>): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/features/mcp-ui/surfaces/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/features/mcp-ui/surfaces/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAwBjB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAqBhE,CAAC;AA4BF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAM,GAAG,MAAM,CAiBlG"}

package/dist/features/mcp-ui/surfaces/tokens.js

@@ -0,0 +1,165 @@
+/**
+ * @module features/mcp-ui/surfaces/tokens
+ *
+ * The design tokens every generated surface declares, and the reason they are declared *in the
+ * document* rather than referenced from a stylesheet.
+ *
+ * A surface renders in a sandboxed, opaque-origin iframe with no network and no shared stylesheet.
+ * An undeclared custom property there does not fall back to a host value — there is no host value
+ * to fall back to — it resolves to nothing, and the declaration using it is dropped. So a token
+ * referenced but not declared is not a degraded style, it is an invisible one: text with no color,
+ * a button with no background. {@link renderTokenBlock} exists so every surface's first `<style>`
+ * tag declares the complete set, always, and `var(--x, fallback)` is reserved for values that are
+ * genuinely optional rather than used as insurance against this failure.
+ *
+ * The derived tokens below are `color-mix()` expressions over the base tokens rather than second
+ * color literals. That is what makes the palette reskinnable: overriding `--jini-mcpui-accent`
+ * alone moves the accent, its hover state, its focus ring, and its tinted background together,
+ * because all four resolve through it.
+ *
+ * `@jini-ai/ui` has no package-wide custom-property design system to reuse (checked: its only two
+ * stylesheets, `react/chat/styles/reference.css` and the Remix icon font, declare no custom
+ * properties at all), so these are namespaced `--jini-mcpui-*` to stay out of the way of one if it
+ * ever lands.
+ *
+ * ## Dark mode
+ *
+ * {@link SURFACE_TOKENS_DARK} is the same key set with dark values, applied by
+ * {@link renderTokenBlock} inside a `@media (prefers-color-scheme: dark)` block that redeclares only
+ * the base tokens — never {@link DERIVED_TOKENS}. A derived token's own declaration still says
+ * `color-mix(in srgb, var(--jini-mcpui-accent) …)`; it does not need a dark-specific line because the
+ * browser resolves that `var()` against whichever `--jini-mcpui-accent` cascades on the element at
+ * used-value time, light or dark. Redeclaring a derived token per scheme would just be two ways to
+ * get the same answer with an extra place for them to drift.
+ *
+ * Currently moot: {@link FORCE_LIGHT_SURFACE_THEME} suppresses the dark block entirely, because
+ * `prefers-color-scheme` reads the OS/browser, not any real app theme — see that constant's own doc.
+ */
+/**
+ * The base palette, radius scale, and font stack.
+ *
+ * Font stacks are system-only and always will be: a sandboxed iframe has no network, so an
+ * `@import` or a `<link>` to a web font is a request that cannot be made, and the surface would
+ * render in whatever the engine falls back to after a delay.
+ */
+export const SURFACE_TOKENS = {
+    '--jini-mcpui-bg': '#faf9f7',
+    '--jini-mcpui-panel': '#fdfcfa',
+    '--jini-mcpui-border': '#e1e5eb',
+    '--jini-mcpui-border-strong': '#c9d0da',
+    '--jini-mcpui-text': '#1a1916',
+    '--jini-mcpui-text-strong': '#0d0c0a',
+    '--jini-mcpui-text-muted': '#74716b',
+    '--jini-mcpui-text-soft': '#989590',
+    '--jini-mcpui-text-faint': '#b3b0a8',
+    '--jini-mcpui-accent': '#c96442',
+    '--jini-mcpui-accent-strong': '#b45a3b',
+    // Desaturated and earthy, in the same family as the accent rather than a saturated pure red — a
+    // destructive action should read as serious, not as an alarm the eye learns to discount.
+    '--jini-mcpui-danger': '#a8443a',
+    '--jini-mcpui-radius-xs': '4px',
+    '--jini-mcpui-radius-sm': '6px',
+    '--jini-mcpui-radius-md': '8px',
+    '--jini-mcpui-radius-lg': '10px',
+    '--jini-mcpui-radius-xl': '12px',
+    '--jini-mcpui-radius-pill': '999px',
+    '--jini-mcpui-font': "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Arial, sans-serif",
+    '--jini-mcpui-font-mono': "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+};
+/**
+ * The dark-scheme value for every token in {@link SURFACE_TOKENS}, keyed the same way and typed as
+ * `Record<SurfaceTokenName, string>` rather than a partial — a token added to the light palette and
+ * forgotten here would not fail to compile, so the full-parity type is what catches it instead.
+ * Radius and font values are repeated verbatim: they do not change with scheme, but the record needs
+ * every key regardless, and a value can only be omitted by weakening the type that guards this file
+ * against exactly that omission.
+ */
+export const SURFACE_TOKENS_DARK = {
+    '--jini-mcpui-bg': '#1a1917',
+    '--jini-mcpui-panel': '#222120',
+    '--jini-mcpui-border': '#333128',
+    '--jini-mcpui-border-strong': '#46433c',
+    '--jini-mcpui-text': '#e8e4dc',
+    '--jini-mcpui-text-strong': '#f2ede4',
+    '--jini-mcpui-text-muted': '#9a9690',
+    '--jini-mcpui-text-soft': '#6e6b65',
+    '--jini-mcpui-text-faint': '#4e4b46',
+    '--jini-mcpui-accent': '#d97a56',
+    '--jini-mcpui-accent-strong': '#e8896a',
+    '--jini-mcpui-danger': '#e0685f',
+    '--jini-mcpui-radius-xs': SURFACE_TOKENS['--jini-mcpui-radius-xs'],
+    '--jini-mcpui-radius-sm': SURFACE_TOKENS['--jini-mcpui-radius-sm'],
+    '--jini-mcpui-radius-md': SURFACE_TOKENS['--jini-mcpui-radius-md'],
+    '--jini-mcpui-radius-lg': SURFACE_TOKENS['--jini-mcpui-radius-lg'],
+    '--jini-mcpui-radius-xl': SURFACE_TOKENS['--jini-mcpui-radius-xl'],
+    '--jini-mcpui-radius-pill': SURFACE_TOKENS['--jini-mcpui-radius-pill'],
+    '--jini-mcpui-font': SURFACE_TOKENS['--jini-mcpui-font'],
+    '--jini-mcpui-font-mono': SURFACE_TOKENS['--jini-mcpui-font-mono'],
+};
+/**
+ * Tokens computed from the base set. Never overridable, by design — a caller that could override
+ * `--jini-mcpui-danger-strong` independently could also desynchronize it from `--jini-mcpui-danger`,
+ * which is the exact failure this indirection removes.
+ */
+const DERIVED_TOKENS = {
+    '--jini-mcpui-accent-hover': 'color-mix(in srgb, var(--jini-mcpui-accent) 88%, #000)',
+    '--jini-mcpui-accent-tint': 'color-mix(in srgb, var(--jini-mcpui-accent) 10%, transparent)',
+    '--jini-mcpui-accent-ring': 'color-mix(in srgb, var(--jini-mcpui-accent) 35%, transparent)',
+    '--jini-mcpui-danger-hover': 'color-mix(in srgb, var(--jini-mcpui-danger) 88%, #000)',
+    '--jini-mcpui-danger-tint': 'color-mix(in srgb, var(--jini-mcpui-danger) 10%, transparent)',
+    '--jini-mcpui-danger-ring': 'color-mix(in srgb, var(--jini-mcpui-danger) 35%, transparent)',
+    '--jini-mcpui-surface-shadow': '0 1px 2px color-mix(in srgb, var(--jini-mcpui-text) 8%, transparent)',
+};
+/**
+ * The dark-scheme override for `--jini-mcpui-surface-shadow`. Not folded into
+ * {@link SURFACE_TOKENS_DARK}/{@link DERIVED_TOKENS}'s usual var()-cascades-automatically trick,
+ * because that trick relies on the derived expression staying correct across schemes, and this one
+ * does not: `color-mix(in srgb, var(--jini-mcpui-text) 8%, transparent)` reads as a near-invisible
+ * dark tint in light mode but as a near-invisible *light* tint in dark mode, where `--jini-mcpui-text`
+ * itself is light. A drop shadow should stay dark ink at low opacity in both schemes, so this is a
+ * fixed value the dark media block below applies as a second, later declaration of the same property.
+ */
+const DARK_SURFACE_SHADOW = '0 1px 2px rgba(0, 0, 0, 0.32)';
+/**
+ * Whether every generated surface is pinned to the light palette regardless of the embedding
+ * browser/OS's `prefers-color-scheme`.
+ *
+ * True today because Tovu — currently this package's only consumer — has no real light/dark toggle
+ * yet (`apps/admin`'s Appearance section is a disabled "SOON" placeholder), so a surface that honors
+ * the OS preference doesn't track any actual app theme — it tracks whatever the operator's OS
+ * happens to be set to, which produces a dark card floating in an always-light admin UI. Flip this
+ * to `false` once Tovu has a real app-level theme signal to forward in; nothing else about
+ * {@link renderTokenBlock} needs to change.
+ */
+export const FORCE_LIGHT_SURFACE_THEME = true;
+/**
+ * Renders the `:root` declaration block for a surface document, plus — unless
+ * {@link FORCE_LIGHT_SURFACE_THEME} is set — a `prefers-color-scheme: dark` variant of it.
+ *
+ * @param overrides - Base tokens to replace, applied in both schemes. Unknown names are a compile
+ * error, not a silent no-op, because a mistyped token name would otherwise leave the real one at its
+ * default and produce a surface that looks unstyled for no visible reason. Values are emitted
+ * verbatim — a caller passing a token value is trusted the same way it is trusted with the surface's
+ * own body HTML. A caller wanting scheme-specific values is not served by this parameter; it exists
+ * for a host's brand tokens, which by design apply the same way regardless of scheme.
+ * @returns A `:root { … }` block, followed by a `@media (prefers-color-scheme: dark) { :root { … } }`
+ * block unless {@link FORCE_LIGHT_SURFACE_THEME} suppresses it, ready to paste into the first
+ * `<style>` tag.
+ * @complexity O(n) in the number of tokens.
+ */
+export function renderTokenBlock(overrides = {}) {
+    const declare = (entries) => entries.map(([name, value]) => `  ${name}: ${value};`).join('\n');
+    const light = declare([
+        ...Object.entries({ ...SURFACE_TOKENS, ...overrides }),
+        ...Object.entries(DERIVED_TOKENS),
+    ]);
+    const lightBlock = `:root {\n${light}\n}`;
+    if (FORCE_LIGHT_SURFACE_THEME)
+        return lightBlock;
+    const dark = declare([
+        ...Object.entries({ ...SURFACE_TOKENS_DARK, ...overrides }),
+        ['--jini-mcpui-surface-shadow', DARK_SURFACE_SHADOW],
+    ]);
+    return `${lightBlock}\n@media (prefers-color-scheme: dark) {\n  :root {\n${dark}\n  }\n}`;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/features/mcp-ui/surfaces/tokens.js.map

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

package/dist/features/media-providers/constants.d.ts

@@ -0,0 +1,10 @@
+import type { MediaProviderOption } from './types.js';
+/**
+ * A small, vendor-shaped starting catalog — same convention as `execution/constants.ts`'s
+ * `DEFAULT_PROVIDER_PRESETS`. Sourced by driving Open Design's own Settings → Media providers
+ * panel directly (Playwright) and transcribing its real provider list, base URLs, and default
+ * models. Pass your own `catalog` to `MediaProvidersTab` to replace this wholesale; Zana or any
+ * other host is expected to do so once it has its own provider roster.
+ */
+export declare const DEFAULT_MEDIA_PROVIDER_CATALOG: readonly MediaProviderOption[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/media-providers/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/media-providers/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,mBAAmB,EAiFxE,CAAC"}

package/dist/features/media-providers/constants.js

@@ -0,0 +1,90 @@
+/**
+ * A small, vendor-shaped starting catalog — same convention as `execution/constants.ts`'s
+ * `DEFAULT_PROVIDER_PRESETS`. Sourced by driving Open Design's own Settings → Media providers
+ * panel directly (Playwright) and transcribing its real provider list, base URLs, and default
+ * models. Pass your own `catalog` to `MediaProvidersTab` to replace this wholesale; Zana or any
+ * other host is expected to do so once it has its own provider roster.
+ */
+export const DEFAULT_MEDIA_PROVIDER_CATALOG = [
+    {
+        id: 'nano-banana',
+        label: 'Nano Banana',
+        defaultBaseUrl: 'https://generativelanguage.googleapis.com',
+        models: ['gemini-3.1-flash-image-preview'],
+    },
+    {
+        id: 'aihubmix',
+        label: 'AIHubMix',
+        defaultBaseUrl: 'https://aihubmix.com/v1',
+        models: ['gemini-3.1-flash-image-preview'],
+    },
+    {
+        id: 'custom-image-api',
+        label: 'Custom Media API',
+        models: ['gemini-3.1-flash-image-preview'],
+    },
+    {
+        id: 'elevenlabs',
+        label: 'ElevenLabs',
+        defaultBaseUrl: 'https://api.elevenlabs.io',
+    },
+    {
+        id: 'fal-ai',
+        label: 'Fal.ai',
+        defaultBaseUrl: 'https://fal.run',
+        models: ['gemini-3.1-flash-image-preview'],
+    },
+    {
+        id: 'fishaudio',
+        label: 'FishAudio',
+        defaultBaseUrl: 'https://api.fish.audio',
+    },
+    {
+        id: 'imagerouter',
+        label: 'ImageRouter',
+        defaultBaseUrl: 'https://api.imagerouter.io/v1/openai',
+        models: ['gemini-3.1-flash-image-preview'],
+    },
+    {
+        id: 'leonardo-ai',
+        label: 'Leonardo.ai',
+        defaultBaseUrl: 'https://cloud.leonardo.ai/api/rest/v1',
+    },
+    {
+        id: 'minimax',
+        label: 'MiniMax',
+        defaultBaseUrl: 'https://api.minimaxi.chat/v1',
+    },
+    {
+        id: 'openai',
+        label: 'OpenAI',
+        defaultBaseUrl: 'https://api.openai.com/v1',
+        models: ['gpt-image-2', 'dall-e-3'],
+    },
+    {
+        id: 'openrouter',
+        label: 'OpenRouter',
+        defaultBaseUrl: 'https://openrouter.ai/api/v1',
+    },
+    {
+        id: 'senseaudio',
+        label: 'SenseAudio',
+        defaultBaseUrl: 'https://api.senseaudio.cn',
+    },
+    {
+        id: 'tavily-search',
+        label: 'Tavily Search',
+        defaultBaseUrl: 'https://api.tavily.com',
+    },
+    {
+        id: 'volcengine-ark',
+        label: 'Volcengine Ark (Doubao)',
+        defaultBaseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+    },
+    {
+        id: 'xai-grok-imagine',
+        label: 'xAI Grok Imagine',
+        defaultBaseUrl: 'https://api.x.ai/v1',
+    },
+];
+//# sourceMappingURL=constants.js.map

package/dist/features/media-providers/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/media-providers/constants.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAmC;IAC5E;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,cAAc,EAAE,2CAA2C;QAC3D,MAAM,EAAE,CAAC,gCAAgC,CAAC;KAC3C;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,cAAc,EAAE,yBAAyB;QACzC,MAAM,EAAE,CAAC,gCAAgC,CAAC;KAC3C;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,MAAM,EAAE,CAAC,gCAAgC,CAAC;KAC3C;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,cAAc,EAAE,2BAA2B;KAC5C;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,cAAc,EAAE,iBAAiB;QACjC,MAAM,EAAE,CAAC,gCAAgC,CAAC;KAC3C;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,wBAAwB;KACzC;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,cAAc,EAAE,sCAAsC;QACtD,MAAM,EAAE,CAAC,gCAAgC,CAAC;KAC3C;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,cAAc,EAAE,uCAAuC;KACxD;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,cAAc,EAAE,8BAA8B;KAC/C;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,cAAc,EAAE,2BAA2B;QAC3C,MAAM,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC;KACpC;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,cAAc,EAAE,8BAA8B;KAC/C;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,cAAc,EAAE,2BAA2B;KAC5C;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,cAAc,EAAE,wBAAwB;KACzC;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,yBAAyB;QAChC,cAAc,EAAE,0CAA0C;KAC3D;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,cAAc,EAAE,qBAAqB;KACtC;CACF,CAAC"}

package/dist/features/media-providers/dependencies.d.ts

@@ -0,0 +1,27 @@
+import type { MediaProvidersPort } from './ports.js';
+import type { MediaProviderMap } from './types.js';
+export interface FakeMediaProvidersPortOptions {
+    /** Seed daemon-held providers. Defaults to an empty map — REACHED, manages
+     *  nothing — not `null`. A caller who wants the "daemon unreachable"
+     *  branch must ask for it explicitly via `unreachable: true`; the two are
+     *  never interchangeable (see `MediaProvidersPort.fetchMediaProviders`). */
+    providers?: MediaProviderMap;
+    /** When true, `fetchMediaProviders` resolves `null` instead of `providers`
+     *  — the daemon was never reached. Exercises the branch
+     *  `mergeDaemonProviders` treats as "leave local state alone". */
+    unreachable?: boolean;
+    /** When set, `saveMediaProviders` REJECTS with this message instead of
+     *  persisting — the "save could not run at all" path. */
+    saveError?: string;
+    /** Simulated network latency in ms; 0 (default) resolves synchronously. */
+    latencyMs?: number;
+}
+/**
+ * An in-memory test/demo double. Per this package's established convention
+ * (see `project-locations/dependencies.ts`, `skills/dependencies.ts`), ships
+ * a fake rather than a real transport — a real host supplies its own
+ * `MediaProvidersPort` pointed at its own daemon's media-provider config
+ * endpoints.
+ */
+export declare function createFakeMediaProvidersPort(options?: FakeMediaProvidersPortOptions): MediaProvidersPort;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/features/media-providers/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/features/media-providers/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,6BAA6B;IAC5C;;;gFAG4E;IAC5E,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;sEAEkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;6DACyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,6BAAkC,GAAG,kBAAkB,CAqB5G"}

package/dist/features/media-providers/dependencies.js

@@ -0,0 +1,29 @@
+/**
+ * An in-memory test/demo double. Per this package's established convention
+ * (see `project-locations/dependencies.ts`, `skills/dependencies.ts`), ships
+ * a fake rather than a real transport — a real host supplies its own
+ * `MediaProvidersPort` pointed at its own daemon's media-provider config
+ * endpoints.
+ */
+export function createFakeMediaProvidersPort(options = {}) {
+    let providers = { ...(options.providers ?? {}) };
+    const latencyMs = options.latencyMs ?? 0;
+    const delay = (value) => latencyMs > 0 ? new Promise((resolve) => setTimeout(() => resolve(value), latencyMs)) : Promise.resolve(value);
+    const delayedRejection = (message) => latencyMs > 0
+        ? new Promise((_resolve, reject) => setTimeout(() => reject(new Error(message)), latencyMs))
+        : Promise.reject(new Error(message));
+    return {
+        fetchMediaProviders() {
+            if (options.unreachable)
+                return delay(null);
+            return delay({ ...providers });
+        },
+        saveMediaProviders(next) {
+            if (options.saveError)
+                return delayedRejection(options.saveError);
+            providers = { ...next };
+            return delay({ ...providers });
+        },
+    };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/features/media-providers/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/features/media-providers/dependencies.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAyC,EAAE;IACtF,IAAI,SAAS,GAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,CAAI,KAAQ,EAAc,EAAE,CACxC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjH,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAkB,EAAE,CAC3D,SAAS,GAAG,CAAC;QACX,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5F,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzC,OAAO;QACL,mBAAmB;YACjB,IAAI,OAAO,CAAC,WAAW;gBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,kBAAkB,CAAC,IAAsB;YACvC,IAAI,OAAO,CAAC,SAAS;gBAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAClE,SAAS,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/features/media-providers/index.d.ts

@@ -0,0 +1,10 @@
+export { DEFAULT_MEDIA_PROVIDER_CATALOG } from './constants.js';
+export { createFakeMediaProvidersPort, type FakeMediaProvidersPortOptions } from './dependencies.js';
+export type { MediaProvidersPort } from './ports.js';
+export { hasAnyConfiguredProvider, hasRecoverableFields, isEntryEmpty, isEntryPresent, isMarkerOnlyEntry, maskedKeyLabel, mergeDaemonProviders, resolveProviderBaseUrl, shouldSyncLocalProvidersToDaemon, sortProvidersByConfigured, } from './rules.js';
+export type { MediaProviderCredentials, MediaProviderMap, MediaProviderOption, MediaProvidersLoadState, MediaProvidersSaveState, } from './types.js';
+export { useMediaProvidersTab } from './react/hooks/useMediaProvidersTab.js';
+export type { MediaProviderEditPatch, UseMediaProvidersTabOptions, UseMediaProvidersTabResult, } from './react/hooks/useMediaProvidersTab.js';
+export { MediaProvidersTab } from './react/components/MediaProvidersTab.js';
+export type { MediaProvidersTabLabels, MediaProvidersTabProps } from './react/components/MediaProvidersTab.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/media-providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/media-providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,KAAK,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACrG,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/features/media-providers/index.js

@@ -0,0 +1,6 @@
+export { DEFAULT_MEDIA_PROVIDER_CATALOG } from './constants.js';
+export { createFakeMediaProvidersPort } from './dependencies.js';
+export { hasAnyConfiguredProvider, hasRecoverableFields, isEntryEmpty, isEntryPresent, isMarkerOnlyEntry, maskedKeyLabel, mergeDaemonProviders, resolveProviderBaseUrl, shouldSyncLocalProvidersToDaemon, sortProvidersByConfigured, } from './rules.js';
+export { useMediaProvidersTab } from './react/hooks/useMediaProvidersTab.js';
+export { MediaProvidersTab } from './react/components/MediaProvidersTab.js';
+//# sourceMappingURL=index.js.map

package/dist/features/media-providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/media-providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAsC,MAAM,mBAAmB,CAAC;AAErG,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AASpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAM7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/features/media-providers/ports.d.ts

@@ -0,0 +1,51 @@
+import type { MediaProviderMap } from './types.js';
+/**
+ * The daemon-side transport this tab needs: reading the server's current
+ * provider credentials and persisting the operator's local edits back to it.
+ * Genuinely host-owned — the origin called its own daemon's media-provider
+ * config endpoints (`fetchMediaProvidersFromDaemon`/`syncMediaProvidersToDaemon`
+ * in `App.tsx`). This feature ships only a fake in `dependencies.ts`; a real
+ * host supplies its own implementation (same convention as
+ * `ProjectLocationsPort`/`SkillsPort`).
+ */
+export interface MediaProvidersPort {
+    /**
+     * The server's current provider credentials. Called on mount and on
+     * reload.
+     *
+     * Resolves `null` when the daemon could not be reached at all — as opposed
+     * to reached and managing nothing (`{}`). `mergeDaemonProviders` treats
+     * those two outcomes very differently (see `rules.ts`'s doc comment):
+     * `null` leaves local edits untouched, `{}` is a real answer that can drop
+     * stale local markers. A host implementation MUST preserve this
+     * distinction rather than collapsing an unreachable daemon to `{}` — doing
+     * so would make a transient network blip read as "the server manages
+     * nothing" and wipe local edits that only `null` protects.
+     */
+    fetchMediaProviders(): Promise<MediaProviderMap | null>;
+    /**
+     * Persists `providers` as the full set of daemon-held credentials and
+     * resolves the authoritative copy afterward — same "save the whole set,
+     * get the truth back" shape as `ProjectLocationsPort.saveLocations`.
+     *
+     * REJECTS on failure — unlike `ExecutionPort.testConnection`, there is no
+     * "reached but declined" outcome worth modelling as a value here; a save
+     * either persists or it doesn't.
+     *
+     * **Callers MUST NOT overlap two of these.** Whole-map replacement carries
+     * no expected-revision, so the implementation has nothing to reject a stale
+     * write with: when two are in flight the surviving state is whichever the
+     * host happens to handle LAST, which need not be the one issued last. A
+     * caller that guards only its own RESPONSE handling still loses — the
+     * superseded REQUEST has already rewritten the host. Serialize instead, and
+     * build each payload when it is sent rather than when it is queued
+     * (`useMediaProvidersTab`'s `persist`/`flushNow` is the reference).
+     *
+     * Adding an expected-revision parameter would let the host reject staleness
+     * outright, but this port is host-implemented, so that is a breaking change
+     * and deliberately not taken; caller-side serialization closes the same race
+     * without one.
+     */
+    saveMediaProviders(providers: MediaProviderMap): Promise<MediaProviderMap>;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/features/media-providers/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/features/media-providers/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5E"}

package/dist/features/media-providers/ports.js

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

package/dist/features/media-providers/ports.js.map

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