@ds-mo/ui 12.9.0 → 13.0.0

package/dist/lib/utils/button-render.d.ts

@@ -0,0 +1,17 @@
+import { type ButtonSize, type ButtonVariant } from './button-types';
+interface ButtonContentOptions {
+    namespace: 'button-filled' | 'button-unfilled';
+    variant: ButtonVariant;
+    size: ButtonSize;
+    label: string;
+    icon: string;
+    hasMenu: boolean;
+    isLoading: boolean;
+    dot?: {
+        visible: boolean;
+        background: string;
+    };
+}
+/** One content renderer shared by both semantic button components. */
+export declare function renderButtonContent(options: ButtonContentOptions): any[];
+export {};

package/dist/lib/utils/button-types.d.ts

@@ -0,0 +1,10 @@
+import type { ControlWidth } from './control-width';
+export type ButtonVariant = 'icon' | 'label' | 'icon-label';
+export type ButtonSize = 'lg' | 'md' | 'sm' | 'xs';
+export type ButtonWidth = ControlWidth;
+export type ButtonPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+export type ButtonNativeType = 'button' | 'submit' | 'reset';
+export declare const BUTTON_ICON_SIZE: Record<ButtonSize, ButtonSize>;
+export declare function buttonShowsIcon(variant: ButtonVariant): boolean;
+export declare function buttonShowsLabel(variant: ButtonVariant): boolean;
+export declare function buttonShowsChevron(variant: ButtonVariant, hasMenu: boolean): boolean;

package/dist/lib/utils/choice-list.d.ts

@@ -0,0 +1,25 @@
+export interface ChoiceOption {
+    label: string;
+    value: string;
+    subtext?: string;
+    /** Rendered only when every option in the complete list supplies an icon. */
+    icon?: string;
+    isInactive?: boolean;
+}
+export interface ChoiceSection {
+    header?: string;
+    options: ChoiceOption[];
+    divider?: boolean;
+}
+export type ChoiceBackground = 'faint' | 'medium' | 'bold' | 'strong' | 'translucent' | 'inverted' | 'media' | 'always-dark';
+export declare function resolveChoiceSections(options: ChoiceOption[], sections: ChoiceSection[]): ChoiceSection[];
+export declare function flattenChoiceSections(sections: ChoiceSection[]): ChoiceOption[];
+/** A choice list has one stable row layout: every option has an icon, or none do. */
+export declare function choiceListUsesIcons(options: ChoiceOption[]): boolean;
+/** Once one option needs supporting text, every row keeps the same two-line structure. */
+export declare function choiceListUsesSubtext(options: ChoiceOption[]): boolean;
+export declare function filterChoiceSections(sections: ChoiceSection[], searchTerm: string): ChoiceSection[];
+export declare function enabledChoiceIndexes(options: ChoiceOption[]): number[];
+export declare function moveChoiceIndex(options: ChoiceOption[], currentIndex: number, direction: 1 | -1): number;
+export declare function findChoiceTypeaheadMatch(options: ChoiceOption[], query: string, currentIndex: number): number;
+export declare function choiceBackgroundClassMap(background: ChoiceBackground | undefined): Record<string, boolean>;

package/dist/lib/utils/control-press.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Transfers an eligible button pointer press to its elevated wrapper.
+ *
+ * The wrapper cannot rely on `:active`: Chromium also activates ancestors of a
+ * disabled native button. Window-level release cleanup preserves the native
+ * release-outside behavior without changing pointer capture or click delivery.
+ */
+export declare function beginElevatedControlPress(event: PointerEvent, eligible: boolean): void;

package/dist/lib/utils/form-association.d.ts

@@ -0,0 +1,22 @@
+export type FormControlState = File | FormData | string | null;
+export interface SetFormControlValueOptions {
+    inactive?: boolean;
+    state?: FormControlState;
+}
+export interface SetRepeatedFormControlValueOptions {
+    inactive?: boolean;
+    state?: FormControlState;
+}
+/**
+ * Set one form-associated value while consistently omitting inactive controls.
+ * Pass `state` only when restoration differs from the submitted value.
+ */
+export declare function setFormControlValue(internals: ElementInternals, value: File | string | null, options?: SetFormControlValueOptions): void;
+/**
+ * Submit repeated values under one field name and preserve a serialized array
+ * for browser form-state restoration.
+ */
+export declare function setRepeatedFormControlValue(internals: ElementInternals, name: string | null | undefined, values: readonly (number | string)[], options?: SetRepeatedFormControlValueOptions): void;
+export declare function restoreStringFormState(state: FormControlState, fallback?: string): string;
+export declare function restoreStringArrayFormState(state: FormControlState): string[];
+export declare function restoreNumberArrayFormState(state: FormControlState, maximumValues?: number): number[];

package/dist/lib/utils/index.d.ts

@@ -12,6 +12,10 @@ export type { ScrollEdgeFadeEdge, ScrollEdgeFadeOptions, ScrollEdgeFadeSize, Scr
 export { TOKEN_DEFAULTS, TOKEN_CSS_LENGTHS } from './token-defaults';
 export type { TokenDefaultKey } from './token-defaults';
 export { DEFAULT_REQUIRED_MESSAGE, setRequiredValidity } from './required-validity';
+export { restoreNumberArrayFormState, restoreStringArrayFormState, restoreStringFormState, setFormControlValue, setRepeatedFormControlValue, } from './form-association';
+export type { FormControlState, SetFormControlValueOptions, SetRepeatedFormControlValueOptions, } from './form-association';
+export { resolveSafeUrl } from './safe-url';
+export type { ResolveSafeUrlOptions, SafeUrlProtocol } from './safe-url';
 export { controlWidthClass } from './control-width';
 export type { ControlWidth } from './control-width';
 export { CONTROL_SUPPORTING_TEXT_VARIANT, CONTROL_TEXT_VARIANT } from './control-text';

package/dist/lib/utils/index.js

@@ -357,6 +357,63 @@ function setRequiredValidity(internals, missing, message) {
   internals.setValidity(missing ? { valueMissing: true } : {}, missing ? message : "");
 }
 
+// src/wc/utils/form-association.ts
+function setFormControlValue(internals, value, options = {}) {
+  const submission = options.inactive ? null : value;
+  if (options.state === void 0) {
+    internals.setFormValue(submission);
+    return;
+  }
+  internals.setFormValue(submission, options.state);
+}
+function setRepeatedFormControlValue(internals, name, values, options = {}) {
+  if (options.inactive || !name || values.length === 0) {
+    internals.setFormValue(null);
+    return;
+  }
+  const data = new FormData();
+  values.forEach((value) => data.append(name, String(value)));
+  internals.setFormValue(data, options.state ?? JSON.stringify(values));
+}
+function restoreStringFormState(state, fallback = "") {
+  return typeof state === "string" ? state : fallback;
+}
+function restoreStringArrayFormState(state) {
+  if (typeof state !== "string") return [];
+  try {
+    const restored = JSON.parse(state);
+    return Array.isArray(restored) ? restored.filter((value) => typeof value === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function restoreNumberArrayFormState(state, maximumValues) {
+  if (typeof state !== "string") return [];
+  try {
+    const restored = JSON.parse(state);
+    if (!Array.isArray(restored)) return [];
+    const values = restored.map((value) => typeof value === "number" ? value : Number(value)).filter((value) => Number.isFinite(value));
+    return maximumValues === void 0 ? values : values.slice(0, maximumValues);
+  } catch {
+    return [];
+  }
+}
+
+// src/wc/utils/safe-url.ts
+var DEFAULT_PROTOCOLS = ["http:", "https:"];
+function resolveSafeUrl(value, options = {}) {
+  const candidate = value?.trim();
+  if (!candidate) return void 0;
+  const baseUrl = options.baseUrl ?? (typeof document === "undefined" ? void 0 : document.baseURI);
+  try {
+    const url = baseUrl === void 0 ? new URL(candidate) : new URL(candidate, baseUrl);
+    const protocols = options.protocols ?? DEFAULT_PROTOCOLS;
+    return protocols.includes(url.protocol) ? url.href : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
 // src/wc/utils/control-width.ts
 function controlWidthClass(width) {
   return {
@@ -415,11 +472,17 @@ export {
   resolveCssTimeMs,
   resolveMetricTrend,
   resolveMotionTimeMs,
+  resolveSafeUrl,
   resolveScrollEdgeFadeSize,
+  restoreNumberArrayFormState,
+  restoreStringArrayFormState,
+  restoreStringFormState,
   scrollEdgeFadeClassMap,
   scrollEdgeFadeMaskImage,
   scrollEdgeFadeMaskStyle,
   scrollEdgeFadeSizeStyle,
+  setFormControlValue,
+  setRepeatedFormControlValue,
   setRequiredValidity,
   truncateSvgTextToWidth
 };

package/dist/lib/utils/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/wc/components/Icon/icon-cache.ts", "../../../src/wc/utils/resolve-css-length-px.ts", "../../../src/wc/utils/format-compact-number.ts", "../../../src/wc/utils/format-percentage.ts", "../../../src/wc/utils/metric-change.ts", "../../../src/wc/utils/truncate-svg-text.ts", "../../../src/wc/utils/resolve-css-time-ms.ts", "../../../src/wc/utils/scroll-edge-fade.ts", "../../../src/wc/utils/token-defaults.ts", "../../../src/wc/utils/required-validity.ts", "../../../src/wc/utils/control-width.ts", "../../../src/wc/utils/control-text.ts", "../../../src/wc/utils/choice-popup-alignment.ts"],
-  "sourcesContent": ["/**\n * Shared SVG glyph cache for ds-icon.\n *\n * Keyed on a global symbol so every module instance (the compiled Stencil chunk\n * inside dist/components and any direct source import, e.g. via `@ds-mo/ui/utils`)\n * reads and writes the same cache. Without this, `registerIcons` called from an\n * app would fill a different Map than the one ds-icon resolves from.\n */\nconst CACHE_KEY = Symbol.for('ds-mo.icon-svg-cache');\n\ntype IconCacheMap = Map<string, string>;\n\ntype GlobalWithIconCache = { [CACHE_KEY]?: IconCacheMap };\n\nexport function iconCacheKey(name: string, flag: boolean): string {\n  return flag ? `flag:${name}` : `system:${name}`;\n}\n\nexport function iconCache(): IconCacheMap {\n  const g = globalThis as GlobalWithIconCache;\n  return (g[CACHE_KEY] ??= new Map());\n}\n\n/**\n * Pre-register glyphs so ds-icon renders them synchronously \u2014 no lazy-chunk\n * fetch, no first-paint pop-in. Import the SVG strings from `@ds-mo/icons`\n * in the app (statically, so they ship in the app's own bundle):\n *\n * ```ts\n * import { Bell } from '@ds-mo/icons/svg/Bell';\n * import { FlagUnitedStates } from '@ds-mo/icons/svg/flags/FlagUnitedStates';\n * import { registerIcons } from '@ds-mo/ui/utils';\n *\n * registerIcons({ Bell });\n * registerIcons({ FlagUnitedStates });\n * ```\n *\n * Icons that are not registered still work \u2014 they lazy-load on first render\n * and stay cached afterwards.\n */\nexport function registerIcons(icons: Record<string, string>, options?: { flag?: boolean }): void {\n  const cache = iconCache();\n  for (const [name, svg] of Object.entries(icons)) {\n    const flag = options?.flag ?? name.startsWith('Flag');\n    cache.set(iconCacheKey(name, flag), svg);\n  }\n}\n", "const lengthPxCache = new Map<string, number>();\n\nlet probeEl: HTMLElement | null = null;\n\nfunction getProbeElement(): HTMLElement | null {\n  if (typeof document === 'undefined') return null;\n\n  if (!probeEl) {\n    probeEl = document.createElement('div');\n    probeEl.setAttribute('aria-hidden', 'true');\n    probeEl.style.cssText =\n      'position:absolute;visibility:hidden;pointer-events:none;top:0;left:0;width:0;height:0;overflow:hidden;';\n    document.documentElement.appendChild(probeEl);\n  }\n\n  return probeEl;\n}\n\n/** Clear session cache (tests only). */\nexport function clearCssLengthPxCache(): void {\n  lengthPxCache.clear();\n}\n\n/**\n * Resolve a CSS length to pixels for layout math.\n * Numbers pass through; `var(--dimension-*)`, `calc(...)`, and `16px` resolve via a hidden probe.\n */\nexport function resolveCssLengthPx(\n  value: number | string | undefined,\n  fallback: number | string,\n): number {\n  const resolved = value === undefined || value === null || value === '' ? fallback : value;\n  if (typeof resolved === 'number') return resolved;\n\n  const trimmed = resolved.trim();\n  if (!trimmed) return resolveCssLengthPx(fallback, 0);\n\n  const cached = lengthPxCache.get(trimmed);\n  if (cached !== undefined) return cached;\n\n  if (/^-?\\d+(\\.\\d+)?$/.test(trimmed)) {\n    const n = Number(trimmed);\n    lengthPxCache.set(trimmed, n);\n    return n;\n  }\n\n  const pxMatch = trimmed.match(/^(-?\\d+(\\.\\d+)?)px$/);\n  if (pxMatch) {\n    const px = parseFloat(pxMatch[1]);\n    lengthPxCache.set(trimmed, px);\n    return px;\n  }\n\n  const cssLength = /^--[\\w-]+$/.test(trimmed) ? `var(${trimmed})` : trimmed;\n\n  const probe = getProbeElement();\n  if (!probe) {\n    return typeof fallback === 'number' ? fallback : 0;\n  }\n\n  probe.style.width = cssLength;\n  const px = probe.getBoundingClientRect().width;\n  probe.style.width = '';\n  // A stylesheet can finish loading after a custom element's first layout\n  // pass (notably in WebKit). Do not permanently cache the probe's temporary\n  // zero when the length depends on a custom property; a later call must be\n  // able to resolve the now-available token.\n  if (px !== 0 || !cssLength.includes('var(')) {\n    lengthPxCache.set(trimmed, px);\n  }\n  return px;\n}\n", "const COMPACT_UNITS: { threshold: number; suffix: string }[] = [\n  { threshold: 1_000_000_000, suffix: 'b' },\n  { threshold: 1_000_000, suffix: 'm' },\n  { threshold: 1_000, suffix: 'k' },\n];\n\n/** Compact large numbers for display: 1000 -> \"1k\", 1500 -> \"1.5k\", 110100 -> \"110.1k\", 1000000 -> \"1m\". */\nexport function formatCompactNumber(value: number, locale?: string): string {\n  if (locale) {\n    return new Intl.NumberFormat(locale, {\n      notation: 'compact',\n      compactDisplay: 'short',\n      maximumFractionDigits: 1,\n    }).format(value);\n  }\n  const sign = value < 0 ? '-' : '';\n  const abs = Math.abs(value);\n  if (abs < 1000) return String(value);\n\n  for (let i = 0; i < COMPACT_UNITS.length; i++) {\n    const unit = COMPACT_UNITS[i];\n    if (abs < unit.threshold) continue;\n\n    let scaled = Math.round((abs / unit.threshold) * 10) / 10;\n    // Carry over, e.g. 999.96k rounds to \"1000k\" \u2014 bump to the next unit instead.\n    if (scaled >= 1000 && i > 0) {\n      const next = COMPACT_UNITS[i - 1];\n      scaled = Math.round((abs / next.threshold) * 10) / 10;\n      return `${sign}${scaled}${next.suffix}`;\n    }\n    return `${sign}${scaled}${unit.suffix}`;\n  }\n  return String(value);\n}\n", "export type PercentageDecimals = 1 | 2;\n\n/** Format a ratio as a locale-aware percentage with an exact, supported precision. */\nexport function formatPercentage(\n  ratio: number,\n  decimals: PercentageDecimals = 1,\n  locale?: string,\n): string {\n  const precision = decimals === 2 ? 2 : 1;\n  const value = Number.isFinite(ratio) ? ratio : 0;\n\n  return new Intl.NumberFormat(locale, {\n    style: 'percent',\n    minimumFractionDigits: precision,\n    maximumFractionDigits: precision,\n  }).format(value);\n}\n", "import { formatCompactNumber } from './format-compact-number';\n\nexport type MetricTrendDirection = 'up' | 'down';\n\n/**\n * How a change should read to the user. Deliberately separate from direction:\n * a metric can fall and read positive, or move and read neutral, so the arrow\n * and the sentiment are independent.\n */\nexport type MetricTrendTone = 'positive' | 'negative' | 'neutral';\n\n/** Display-ready trend for an overview score or metric. */\nexport interface MetricTrend {\n  direction: MetricTrendDirection;\n  /** Formatted change, for example `9` or `32%`. */\n  value: string;\n  tone: MetricTrendTone;\n}\n\nexport interface MetricChange {\n  /** Signed difference, current minus previous. */\n  delta: number;\n  /** Magnitude of the difference. */\n  absolute: number;\n  /**\n   * Magnitude as a share of the previous value, so `0.32` means 32 percent.\n   * Zero when the previous value is zero, because the change has no base to\n   * measure against and an infinite increase is not reportable.\n   */\n  ratio: number;\n  /** `null` when the values match or either side is missing. */\n  direction: MetricTrendDirection | null;\n}\n\nexport interface ResolveMetricTrendOptions {\n  /** Lower is better, so a decrease reads positive. Collisions, costs, defects. */\n  inverted?: boolean;\n  /** Report the change without a positive or negative reading. */\n  neutral?: boolean;\n  /** Report the change as a share of the previous value rather than a magnitude. */\n  display?: 'absolute' | 'percentage';\n  locale?: string;\n}\n\nconst NO_CHANGE: MetricChange = { delta: 0, absolute: 0, ratio: 0, direction: null };\n\nfunction isUsable(value: number | null | undefined): value is number {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\n/**\n * Compare a metric against its previous period.\n *\n * Reports magnitudes only \u2014 whether a rise is good news is a product decision,\n * so callers pair this with `resolveMetricTrend` or map `direction` themselves.\n */\nexport function computeMetricChange(\n  current: number | null | undefined,\n  previous: number | null | undefined,\n): MetricChange {\n  if (!isUsable(current) || !isUsable(previous)) return NO_CHANGE;\n\n  // Trim floating-point noise so 0.3 - 0.1 does not report a change of 0.199\u2026\n  const delta = Number.parseFloat((current - previous).toFixed(10));\n  if (delta === 0) return NO_CHANGE;\n\n  const absolute = Math.abs(delta);\n  const ratio = previous === 0 ? 0 : Math.abs(delta / previous);\n\n  return { delta, absolute, ratio, direction: delta > 0 ? 'up' : 'down' };\n}\n\n/**\n * Build a display-ready trend, or `null` when there is nothing to report so the\n * caller can omit the trend entirely rather than render a zero.\n *\n * Percentages are formatted without decimals to match the product's overview\n * bar; `formatPercentage` is not used because it requires one or two decimals.\n */\nexport function resolveMetricTrend(\n  current: number | null | undefined,\n  previous: number | null | undefined,\n  options: ResolveMetricTrendOptions = {},\n): MetricTrend | null {\n  const { inverted = false, neutral = false, display = 'absolute', locale } = options;\n  const change = computeMetricChange(current, previous);\n  if (!change.direction) return null;\n\n  // A rise reads positive by default and negative when lower is better.\n  const rose = change.direction === 'up';\n  const tone: MetricTrendTone = neutral\n    ? 'neutral'\n    : rose !== inverted\n      ? 'positive'\n      : 'negative';\n\n  const value = display === 'percentage'\n    ? new Intl.NumberFormat(locale, { style: 'percent', maximumFractionDigits: 0 }).format(change.ratio)\n    : formatCompactNumber(change.absolute, locale);\n\n  return { direction: change.direction, value, tone };\n}\n", "/**\n * Binary-searches the longest prefix of `text` (plus an ellipsis) that fits within `maxWidth`\n * px when rendered by `el`, using the SVG `getComputedTextLength()` API for exact measurement \u2014\n * `text-overflow: ellipsis` doesn't apply to raw SVG `<text>` nodes.\n *\n * Mutates `el.textContent` during measurement; the caller's next render (driven by the\n * returned string going into state) overwrites it with the final value.\n */\nexport function truncateSvgTextToWidth(el: SVGTextElement, text: string, maxWidth: number): string {\n  el.textContent = text;\n  if (maxWidth <= 0 || el.getComputedTextLength() <= maxWidth) return text;\n\n  let lo = 0;\n  let hi = text.length;\n  while (lo < hi) {\n    const mid = Math.ceil((lo + hi) / 2);\n    el.textContent = `${text.slice(0, mid)}\u2026`;\n    if (el.getComputedTextLength() <= maxWidth) {\n      lo = mid;\n    } else {\n      hi = mid - 1;\n    }\n  }\n  return lo > 0 ? `${text.slice(0, lo)}\u2026` : '\u2026';\n}\n", "/** Parse a CSS <time> value (or motion shorthand's first token) to milliseconds. */\nexport function parseCssTimeMs(value: string, fallback: number): number {\n  const firstToken = value.trim().split(/\\s+/)[0] ?? '';\n  const num = parseFloat(firstToken);\n  if (Number.isNaN(num)) return fallback;\n  if (/ms\\s*$/.test(firstToken)) return num;\n  if (/s\\s*$/.test(firstToken)) return num * 1000;\n  return num;\n}\n\nfunction extractCssCustomProp(ref: string): string | null {\n  const varMatch = ref.match(/^var\\(\\s*(--[^),]+)/);\n  if (varMatch) return varMatch[1].trim();\n  if (ref.startsWith('--')) return ref.trim();\n  return null;\n}\n\nfunction readTokenTimeMs(token: string, fallback: number): number {\n  if (typeof document === 'undefined') return fallback;\n\n  const prop = extractCssCustomProp(token);\n  if (!prop) return parseCssTimeMs(token, fallback);\n\n  const raw = getComputedStyle(document.documentElement).getPropertyValue(prop).trim();\n  return parseCssTimeMs(raw, fallback);\n}\n\n/**\n * Resolve a duration to milliseconds for JS timers aligned with CSS motion tokens.\n * Accepts numbers (ms), raw times (`200ms`, `0.75s`), or `var(--effect-*)` references.\n */\nexport function resolveCssTimeMs(\n  value: number | string | undefined,\n  fallbackToken: string,\n): number {\n  if (typeof value === 'number') return value;\n\n  const token = typeof value === 'string' && value.trim() ? value.trim() : fallbackToken;\n  const prop = extractCssCustomProp(token);\n\n  if (prop) {\n    return readTokenTimeMs(token, readTokenTimeMs(fallbackToken, 200));\n  }\n\n  return parseCssTimeMs(token, readTokenTimeMs(fallbackToken, 200));\n}\n\n/** Whether the user has requested reduced non-essential motion. */\nexport function prefersReducedMotion(): boolean {\n  return typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function' &&\n    window.matchMedia('(prefers-reduced-motion: reduce)').matches;\n}\n\n/**\n * Resolve an animation-coupled duration. Returns zero under reduced motion so\n * JS cleanup stays synchronized with CSS that removes the corresponding motion.\n */\nexport function resolveMotionTimeMs(\n  value: number | string | undefined,\n  fallbackToken: string,\n): number {\n  return prefersReducedMotion() ? 0 : resolveCssTimeMs(value, fallbackToken);\n}\n", "/** CSS custom property for scroll-edge fade depth (dimension token or length). */\nexport const SCROLL_EDGE_FADE_SIZE_VAR = '--ds-scroll-edge-fade-size';\n\nexport const SCROLL_EDGE_FADE_DEFAULT_SIZE = 'var(--dimension-size-600)';\n\nexport type ScrollEdgeFadeEdge = 'top' | 'bottom' | 'left' | 'right';\n\nexport type ScrollEdgeFadeSizeToken =\n  | 'size-000'\n  | 'size-050'\n  | 'size-075'\n  | 'size-100'\n  | 'size-150'\n  | 'size-200'\n  | 'size-250'\n  | 'size-300'\n  | 'size-400'\n  | 'size-500'\n  | 'size-600'\n  | 'size-800';\n\nexport type ScrollEdgeFadeSize = ScrollEdgeFadeSizeToken | (string & {});\n\nconst SIZE_VALUE: Record<ScrollEdgeFadeSizeToken, string> = {\n  'size-000': 'var(--dimension-size-000)',\n  'size-050': 'var(--dimension-size-050)',\n  'size-075': 'var(--dimension-size-075)',\n  'size-100': 'var(--dimension-size-100)',\n  'size-150': 'var(--dimension-size-150)',\n  'size-200': 'var(--dimension-size-200)',\n  'size-250': 'var(--dimension-size-250)',\n  'size-300': 'var(--dimension-size-300)',\n  'size-400': 'var(--dimension-size-400)',\n  'size-500': 'var(--dimension-size-500)',\n  'size-600': 'var(--dimension-size-600)',\n  'size-800': 'var(--dimension-size-800)',\n};\n\nconst SIZE_REF = `var(${SCROLL_EDGE_FADE_SIZE_VAR}, ${SCROLL_EDGE_FADE_DEFAULT_SIZE})`;\n\nexport interface ScrollEdgeFadeOptions {\n  /** One or more edges to fade. */\n  edges: ScrollEdgeFadeEdge | ScrollEdgeFadeEdge[];\n  /**\n   * Reveal and hide configured fades from the container's own scroll position.\n   * Uses CSS scroll-driven animations with a static-fade fallback; no listener required.\n   */\n  scrollAware?: boolean;\n  /**\n   * When true, removes the complete mask. Pass a map to remove only configured\n   * edges that are flush when scroll state already lives in JavaScript.\n   */\n  atEnd?: boolean | Partial<Record<ScrollEdgeFadeEdge, boolean>>;\n  /** Force the mask off regardless of scroll position (`ds-fade` `visible={false}`). */\n  hidden?: boolean;\n}\n\n/** Resolve a dimension size token name or raw CSS length for `--ds-scroll-edge-fade-size`. */\nexport function resolveScrollEdgeFadeSize(\n  size: ScrollEdgeFadeSize = 'size-600',\n  height?: string,\n): string {\n  if (height) return height;\n  return Object.prototype.hasOwnProperty.call(SIZE_VALUE, size)\n    ? SIZE_VALUE[size as ScrollEdgeFadeSizeToken]\n    : size;\n}\n\n/** Inline style map setting fade depth on a scroll container. */\nexport function scrollEdgeFadeSizeStyle(\n  size: ScrollEdgeFadeSize = 'size-600',\n  height?: string,\n): Record<string, string> {\n  return {\n    [SCROLL_EDGE_FADE_SIZE_VAR]: resolveScrollEdgeFadeSize(size, height),\n  };\n}\n\n/**\n * Alpha mask for a scroll container edge \u2014 content fades to transparent so\n * textured backgrounds (shell gradients, images) show through.\n */\nexport function scrollEdgeFadeMaskImage(edge: ScrollEdgeFadeEdge): string {\n  switch (edge) {\n    case 'top':\n      return `linear-gradient(to bottom, transparent 0, #000 ${SIZE_REF}, #000 100%)`;\n    case 'bottom':\n      return `linear-gradient(to bottom, #000 0, #000 calc(100% - ${SIZE_REF}), transparent 100%)`;\n    case 'left':\n      return `linear-gradient(to right, transparent 0, #000 ${SIZE_REF}, #000 100%)`;\n    case 'right':\n      return `linear-gradient(to right, #000 0, #000 calc(100% - ${SIZE_REF}), transparent 100%)`;\n  }\n}\n\n/** Inline style map for a masked scroll region (single edge). */\nexport function scrollEdgeFadeMaskStyle(\n  edge: ScrollEdgeFadeEdge,\n  size: ScrollEdgeFadeSize = 'size-600',\n  height?: string,\n): Record<string, string> {\n  const mask = scrollEdgeFadeMaskImage(edge);\n  return {\n    ...scrollEdgeFadeSizeStyle(size, height),\n    WebkitMaskImage: mask,\n    maskImage: mask,\n    WebkitMaskSize: '100% 100%',\n    maskSize: '100% 100%',\n  };\n}\n\n/** Class map for `scroll-edge-fade` modifiers \u2014 pair with `scroll-edge-fade.css`. */\nexport function scrollEdgeFadeClassMap(opts: ScrollEdgeFadeOptions): Record<string, boolean> {\n  const edges = Array.isArray(opts.edges) ? opts.edges : [opts.edges];\n  const classes: Record<string, boolean> = {\n    'scroll-edge-fade': true,\n    'scroll-edge-fade--scroll-aware': opts.scrollAware === true,\n    'scroll-edge-fade--hidden': opts.hidden === true,\n  };\n\n  for (const edge of edges) {\n    classes[`scroll-edge-fade--${edge}`] = true;\n  }\n\n  const { atEnd } = opts;\n  if (atEnd === true) {\n    classes['scroll-edge-fade--at-end'] = true;\n  } else if (atEnd && typeof atEnd === 'object') {\n    for (const edge of edges) {\n      if (atEnd[edge]) {\n        classes[`scroll-edge-fade--${edge}-at-edge`] = true;\n      }\n    }\n  }\n\n  return classes;\n}\n\n/** Whether a scroll container is flush with the given edge (within `threshold` px). */\nexport function isScrollAtEdge(\n  el: HTMLElement,\n  edge: ScrollEdgeFadeEdge,\n  threshold = 2,\n): boolean {\n  switch (edge) {\n    case 'top':\n      return el.scrollTop <= threshold;\n    case 'bottom':\n      return el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;\n    case 'left':\n      return el.scrollLeft <= threshold;\n    case 'right':\n      return el.scrollWidth - el.scrollLeft - el.clientWidth <= threshold;\n  }\n}\n", "import {\n  dimensionIconographyMd,\n  dimensionIconographySm,\n  dimensionIconographyXs,\n  dimensionMenuWidthXs,\n  dimensionPanelWidth2xs,\n  dimensionPanelWidthLg,\n  dimensionPanelWidthMd,\n  dimensionRadius025,\n  dimensionSize200,\n  dimensionSize300,\n  dimensionSize400,\n  dimensionSize600,\n  dimensionSize800,\n  dimensionSpace100,\n  dimensionSpace050,\n  dimensionSpace200,\n  dimensionSpace300,\n  dimensionSpace400,\n  typographyLineheightLg,\n  typographyLineheightMd,\n  typographyLineheightSm,\n  typographyLineheightXl,\n  typographyLineheightXs,\n  effectAnimationDelayLong2,\n  effectAnimationDelayMedium1,\n  effectAnimationDelayMedium3,\n  effectAnimationDelayInstant,\n  effectAnimationDelayShort2,\n  effectAnimationDurationMedium1,\n  effectAnimationDurationShort3,\n  effectMotionShort2,\n  effectMotionShort3,\n} from '@ds-mo/tokens/ts';\n\n/** TokoMo CSS custom-property names for shared component defaults (runtime resolution). */\nexport const TOKEN_DEFAULTS = {\n  space050: dimensionSpace050,\n  space100: dimensionSpace100,\n  space200: dimensionSpace200,\n  space300: dimensionSpace300,\n  space400: dimensionSpace400,\n  radius025: dimensionRadius025,\n  size200: dimensionSize200,\n  size300: dimensionSize300,\n  size400: dimensionSize400,\n  size600: dimensionSize600,\n  size800: dimensionSize800,\n  iconographyMd: dimensionIconographyMd,\n  iconographySm: dimensionIconographySm,\n  iconographyXs: dimensionIconographyXs,\n  panelWidth2xs: dimensionPanelWidth2xs,\n  panelWidthMd: dimensionPanelWidthMd,\n  panelWidthLg: dimensionPanelWidthLg,\n  menuWidthXs: dimensionMenuWidthXs,\n  lineheightLg: typographyLineheightLg,\n  lineheightMd: typographyLineheightMd,\n  lineheightSm: typographyLineheightSm,\n  lineheightXl: typographyLineheightXl,\n  lineheightXs: typographyLineheightXs,\n  motionShort2: effectMotionShort2,\n  motionShort3: effectMotionShort3,\n  animationDurationShort3: effectAnimationDurationShort3,\n  animationDurationMedium1: effectAnimationDurationMedium1,\n  animationDelayInstant: effectAnimationDelayInstant,\n  animationDelayMedium1: effectAnimationDelayMedium1,\n  animationDelayMedium3: effectAnimationDelayMedium3,\n  animationDelayShort2: effectAnimationDelayShort2,\n  animationDelayLong2: effectAnimationDelayLong2,\n  /** Unmeasured menu height fallback: 20\u00D7 base (160px at default scale). */\n  menuFallbackHeight: 'calc(var(--dimension-size-base) * 20)',\n  /** Unmeasured tooltip width fallback: size-800 + size-200 (80px). */\n  tooltipFallbackWidth: 'calc(var(--dimension-size-800) + var(--dimension-size-200))',\n  /** Fill-mode donut diameter floor: 16\u00D7 size-base (128px). */\n  donutFillMin: 'calc(var(--dimension-size-base) * 16)',\n  /** Fill-mode donut diameter ceiling: 24\u00D7 size-base (192px). */\n  donutFillMax: 'calc(var(--dimension-size-base) * 24)',\n} as const;\n\nexport type TokenDefaultKey = keyof typeof TOKEN_DEFAULTS;\n\n/** Valid CSS length strings for overlay offset props \u2014 bind on `sideOffset` / `alignOffset` in hosts. */\nexport const TOKEN_CSS_LENGTHS = {\n  space050: `var(${dimensionSpace050})`,\n  space200: `var(${dimensionSpace200})`,\n  menuWidthXs: `var(${dimensionMenuWidthXs})`,\n} as const;\n", "/**\n * Shared \"required field\" validity contract for form-associated custom\n * elements (Checkbox, Radio, Switch, Input, Select, SelectMulti, \u2026).\n *\n * Each control computes its own `missing` condition (what counts as empty\n * differs: unchecked, no value, no selection, \u2026) and its own form value, then\n * calls `setRequiredValidity` instead of hand-rolling the `setValidity` call\n * and the default message string.\n *\n * @see AGENTS.md \u2014 \"Required-field validity\"\n */\n\nexport const DEFAULT_REQUIRED_MESSAGE = 'This field is required.';\n\n/** Sets or clears the `valueMissing` validity flag on a form-associated element. */\nexport function setRequiredValidity(\n  internals: ElementInternals,\n  missing: boolean,\n  message: string,\n): void {\n  internals.setValidity(missing ? { valueMissing: true } : {}, missing ? message : '');\n}\n", "/** Shared width fit for interactive controls (buttons, select, \u2026). */\nexport type ControlWidth = 'hug' | 'fill';\n\n/** Host / control class map for `width=\"hug\" | \"fill\"`. */\nexport function controlWidthClass(width: ControlWidth): Record<string, boolean> {\n  return {\n    'ds-control-width--hug': width === 'hug',\n    'ds-control-width--fill': width === 'fill',\n  };\n}\n", "import type { TextVariant } from '../components/Text/text-types';\n\n/** Shared public control sizes. Typography is derived; it is not a separate density API. */\nexport type ControlSize = 'lg' | 'md' | 'sm' | 'xs';\n\n/** Complete text variant selected internally by each control size. */\nexport const CONTROL_TEXT_VARIANT: Record<ControlSize, TextVariant> = {\n  lg: 'text-body-large',\n  md: 'text-body-medium',\n  sm: 'text-body-small',\n  xs: 'text-caption',\n};\n\n/** Supporting copy paired with each control density in two-line choice rows. */\nexport const CONTROL_SUPPORTING_TEXT_VARIANT: Record<ControlSize, TextVariant> = {\n  lg: 'text-body-medium',\n  md: 'text-body-small',\n  sm: 'text-caption',\n  xs: 'text-caption',\n};\n", "import type { AnchoredAlign } from './anchored-position';\n\n/**\n * `choice-cell` aligns the first/last interactive row edge with the anchor,\n * allowing the popup frame to extend by the section inset. `popup-frame`\n * aligns the popup frame itself and is reserved for deliberate custom geometry.\n */\nexport type ChoicePopupAnchorAlignment = 'choice-cell' | 'popup-frame';\n\nexport interface ChoicePopupAlignOffsetInput {\n  align: AnchoredAlign;\n  alignOffsetPx: number;\n  sectionInsetPx: number;\n  anchorAlignment?: ChoicePopupAnchorAlignment;\n}\n\n/**\n * Resolve the cross-axis offset for a choice popup. Authored `alignOffsetPx`\n * remains an additive nudge after the shared inner-cell alignment is applied.\n */\nexport function resolveChoicePopupAlignOffset({\n  align,\n  alignOffsetPx,\n  sectionInsetPx,\n  anchorAlignment = 'choice-cell',\n}: ChoicePopupAlignOffsetInput): number {\n  if (anchorAlignment === 'popup-frame' || align === 'center') return alignOffsetPx;\n  return alignOffsetPx + (align === 'start' ? -sectionInsetPx : sectionInsetPx);\n}\n\n/** Minimum popup width that keeps both choice-cell edges aligned to a trigger. */\nexport function choicePopupMinWidth(anchorWidth: number, sectionInsetPx: number): number {\n  return anchorWidth + sectionInsetPx * 2;\n}\n"],
-  "mappings": "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",
+  "sources": ["../../../src/wc/components/Icon/icon-cache.ts", "../../../src/wc/utils/resolve-css-length-px.ts", "../../../src/wc/utils/format-compact-number.ts", "../../../src/wc/utils/format-percentage.ts", "../../../src/wc/utils/metric-change.ts", "../../../src/wc/utils/truncate-svg-text.ts", "../../../src/wc/utils/resolve-css-time-ms.ts", "../../../src/wc/utils/scroll-edge-fade.ts", "../../../src/wc/utils/token-defaults.ts", "../../../src/wc/utils/required-validity.ts", "../../../src/wc/utils/form-association.ts", "../../../src/wc/utils/safe-url.ts", "../../../src/wc/utils/control-width.ts", "../../../src/wc/utils/control-text.ts", "../../../src/wc/utils/choice-popup-alignment.ts"],
+  "sourcesContent": ["/**\n * Shared SVG glyph cache for ds-icon.\n *\n * Keyed on a global symbol so every module instance (the compiled Stencil chunk\n * inside dist/components and any direct source import, e.g. via `@ds-mo/ui/utils`)\n * reads and writes the same cache. Without this, `registerIcons` called from an\n * app would fill a different Map than the one ds-icon resolves from.\n */\nconst CACHE_KEY = Symbol.for('ds-mo.icon-svg-cache');\n\ntype IconCacheMap = Map<string, string>;\n\ntype GlobalWithIconCache = { [CACHE_KEY]?: IconCacheMap };\n\nexport function iconCacheKey(name: string, flag: boolean): string {\n  return flag ? `flag:${name}` : `system:${name}`;\n}\n\nexport function iconCache(): IconCacheMap {\n  const g = globalThis as GlobalWithIconCache;\n  return (g[CACHE_KEY] ??= new Map());\n}\n\n/**\n * Pre-register glyphs so ds-icon renders them synchronously \u2014 no lazy-chunk\n * fetch, no first-paint pop-in. Import the SVG strings from `@ds-mo/icons`\n * in the app (statically, so they ship in the app's own bundle):\n *\n * ```ts\n * import { Bell } from '@ds-mo/icons/svg/Bell';\n * import { FlagUnitedStates } from '@ds-mo/icons/svg/flags/FlagUnitedStates';\n * import { registerIcons } from '@ds-mo/ui/utils';\n *\n * registerIcons({ Bell });\n * registerIcons({ FlagUnitedStates });\n * ```\n *\n * Icons that are not registered still work \u2014 they lazy-load on first render\n * and stay cached afterwards.\n */\nexport function registerIcons(icons: Record<string, string>, options?: { flag?: boolean }): void {\n  const cache = iconCache();\n  for (const [name, svg] of Object.entries(icons)) {\n    const flag = options?.flag ?? name.startsWith('Flag');\n    cache.set(iconCacheKey(name, flag), svg);\n  }\n}\n", "const lengthPxCache = new Map<string, number>();\n\nlet probeEl: HTMLElement | null = null;\n\nfunction getProbeElement(): HTMLElement | null {\n  if (typeof document === 'undefined') return null;\n\n  if (!probeEl) {\n    probeEl = document.createElement('div');\n    probeEl.setAttribute('aria-hidden', 'true');\n    probeEl.style.cssText =\n      'position:absolute;visibility:hidden;pointer-events:none;top:0;left:0;width:0;height:0;overflow:hidden;';\n    document.documentElement.appendChild(probeEl);\n  }\n\n  return probeEl;\n}\n\n/** Clear session cache (tests only). */\nexport function clearCssLengthPxCache(): void {\n  lengthPxCache.clear();\n}\n\n/**\n * Resolve a CSS length to pixels for layout math.\n * Numbers pass through; `var(--dimension-*)`, `calc(...)`, and `16px` resolve via a hidden probe.\n */\nexport function resolveCssLengthPx(\n  value: number | string | undefined,\n  fallback: number | string,\n): number {\n  const resolved = value === undefined || value === null || value === '' ? fallback : value;\n  if (typeof resolved === 'number') return resolved;\n\n  const trimmed = resolved.trim();\n  if (!trimmed) return resolveCssLengthPx(fallback, 0);\n\n  const cached = lengthPxCache.get(trimmed);\n  if (cached !== undefined) return cached;\n\n  if (/^-?\\d+(\\.\\d+)?$/.test(trimmed)) {\n    const n = Number(trimmed);\n    lengthPxCache.set(trimmed, n);\n    return n;\n  }\n\n  const pxMatch = trimmed.match(/^(-?\\d+(\\.\\d+)?)px$/);\n  if (pxMatch) {\n    const px = parseFloat(pxMatch[1]);\n    lengthPxCache.set(trimmed, px);\n    return px;\n  }\n\n  const cssLength = /^--[\\w-]+$/.test(trimmed) ? `var(${trimmed})` : trimmed;\n\n  const probe = getProbeElement();\n  if (!probe) {\n    return typeof fallback === 'number' ? fallback : 0;\n  }\n\n  probe.style.width = cssLength;\n  const px = probe.getBoundingClientRect().width;\n  probe.style.width = '';\n  // A stylesheet can finish loading after a custom element's first layout\n  // pass (notably in WebKit). Do not permanently cache the probe's temporary\n  // zero when the length depends on a custom property; a later call must be\n  // able to resolve the now-available token.\n  if (px !== 0 || !cssLength.includes('var(')) {\n    lengthPxCache.set(trimmed, px);\n  }\n  return px;\n}\n", "const COMPACT_UNITS: { threshold: number; suffix: string }[] = [\n  { threshold: 1_000_000_000, suffix: 'b' },\n  { threshold: 1_000_000, suffix: 'm' },\n  { threshold: 1_000, suffix: 'k' },\n];\n\n/** Compact large numbers for display: 1000 -> \"1k\", 1500 -> \"1.5k\", 110100 -> \"110.1k\", 1000000 -> \"1m\". */\nexport function formatCompactNumber(value: number, locale?: string): string {\n  if (locale) {\n    return new Intl.NumberFormat(locale, {\n      notation: 'compact',\n      compactDisplay: 'short',\n      maximumFractionDigits: 1,\n    }).format(value);\n  }\n  const sign = value < 0 ? '-' : '';\n  const abs = Math.abs(value);\n  if (abs < 1000) return String(value);\n\n  for (let i = 0; i < COMPACT_UNITS.length; i++) {\n    const unit = COMPACT_UNITS[i];\n    if (abs < unit.threshold) continue;\n\n    let scaled = Math.round((abs / unit.threshold) * 10) / 10;\n    // Carry over, e.g. 999.96k rounds to \"1000k\" \u2014 bump to the next unit instead.\n    if (scaled >= 1000 && i > 0) {\n      const next = COMPACT_UNITS[i - 1];\n      scaled = Math.round((abs / next.threshold) * 10) / 10;\n      return `${sign}${scaled}${next.suffix}`;\n    }\n    return `${sign}${scaled}${unit.suffix}`;\n  }\n  return String(value);\n}\n", "export type PercentageDecimals = 1 | 2;\n\n/** Format a ratio as a locale-aware percentage with an exact, supported precision. */\nexport function formatPercentage(\n  ratio: number,\n  decimals: PercentageDecimals = 1,\n  locale?: string,\n): string {\n  const precision = decimals === 2 ? 2 : 1;\n  const value = Number.isFinite(ratio) ? ratio : 0;\n\n  return new Intl.NumberFormat(locale, {\n    style: 'percent',\n    minimumFractionDigits: precision,\n    maximumFractionDigits: precision,\n  }).format(value);\n}\n", "import { formatCompactNumber } from './format-compact-number';\n\nexport type MetricTrendDirection = 'up' | 'down';\n\n/**\n * How a change should read to the user. Deliberately separate from direction:\n * a metric can fall and read positive, or move and read neutral, so the arrow\n * and the sentiment are independent.\n */\nexport type MetricTrendTone = 'positive' | 'negative' | 'neutral';\n\n/** Display-ready trend for an overview score or metric. */\nexport interface MetricTrend {\n  direction: MetricTrendDirection;\n  /** Formatted change, for example `9` or `32%`. */\n  value: string;\n  tone: MetricTrendTone;\n}\n\nexport interface MetricChange {\n  /** Signed difference, current minus previous. */\n  delta: number;\n  /** Magnitude of the difference. */\n  absolute: number;\n  /**\n   * Magnitude as a share of the previous value, so `0.32` means 32 percent.\n   * Zero when the previous value is zero, because the change has no base to\n   * measure against and an infinite increase is not reportable.\n   */\n  ratio: number;\n  /** `null` when the values match or either side is missing. */\n  direction: MetricTrendDirection | null;\n}\n\nexport interface ResolveMetricTrendOptions {\n  /** Lower is better, so a decrease reads positive. Collisions, costs, defects. */\n  inverted?: boolean;\n  /** Report the change without a positive or negative reading. */\n  neutral?: boolean;\n  /** Report the change as a share of the previous value rather than a magnitude. */\n  display?: 'absolute' | 'percentage';\n  locale?: string;\n}\n\nconst NO_CHANGE: MetricChange = { delta: 0, absolute: 0, ratio: 0, direction: null };\n\nfunction isUsable(value: number | null | undefined): value is number {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\n/**\n * Compare a metric against its previous period.\n *\n * Reports magnitudes only \u2014 whether a rise is good news is a product decision,\n * so callers pair this with `resolveMetricTrend` or map `direction` themselves.\n */\nexport function computeMetricChange(\n  current: number | null | undefined,\n  previous: number | null | undefined,\n): MetricChange {\n  if (!isUsable(current) || !isUsable(previous)) return NO_CHANGE;\n\n  // Trim floating-point noise so 0.3 - 0.1 does not report a change of 0.199\u2026\n  const delta = Number.parseFloat((current - previous).toFixed(10));\n  if (delta === 0) return NO_CHANGE;\n\n  const absolute = Math.abs(delta);\n  const ratio = previous === 0 ? 0 : Math.abs(delta / previous);\n\n  return { delta, absolute, ratio, direction: delta > 0 ? 'up' : 'down' };\n}\n\n/**\n * Build a display-ready trend, or `null` when there is nothing to report so the\n * caller can omit the trend entirely rather than render a zero.\n *\n * Percentages are formatted without decimals to match the product's overview\n * bar; `formatPercentage` is not used because it requires one or two decimals.\n */\nexport function resolveMetricTrend(\n  current: number | null | undefined,\n  previous: number | null | undefined,\n  options: ResolveMetricTrendOptions = {},\n): MetricTrend | null {\n  const { inverted = false, neutral = false, display = 'absolute', locale } = options;\n  const change = computeMetricChange(current, previous);\n  if (!change.direction) return null;\n\n  // A rise reads positive by default and negative when lower is better.\n  const rose = change.direction === 'up';\n  const tone: MetricTrendTone = neutral\n    ? 'neutral'\n    : rose !== inverted\n      ? 'positive'\n      : 'negative';\n\n  const value = display === 'percentage'\n    ? new Intl.NumberFormat(locale, { style: 'percent', maximumFractionDigits: 0 }).format(change.ratio)\n    : formatCompactNumber(change.absolute, locale);\n\n  return { direction: change.direction, value, tone };\n}\n", "/**\n * Binary-searches the longest prefix of `text` (plus an ellipsis) that fits within `maxWidth`\n * px when rendered by `el`, using the SVG `getComputedTextLength()` API for exact measurement \u2014\n * `text-overflow: ellipsis` doesn't apply to raw SVG `<text>` nodes.\n *\n * Mutates `el.textContent` during measurement; the caller's next render (driven by the\n * returned string going into state) overwrites it with the final value.\n */\nexport function truncateSvgTextToWidth(el: SVGTextElement, text: string, maxWidth: number): string {\n  el.textContent = text;\n  if (maxWidth <= 0 || el.getComputedTextLength() <= maxWidth) return text;\n\n  let lo = 0;\n  let hi = text.length;\n  while (lo < hi) {\n    const mid = Math.ceil((lo + hi) / 2);\n    el.textContent = `${text.slice(0, mid)}\u2026`;\n    if (el.getComputedTextLength() <= maxWidth) {\n      lo = mid;\n    } else {\n      hi = mid - 1;\n    }\n  }\n  return lo > 0 ? `${text.slice(0, lo)}\u2026` : '\u2026';\n}\n", "/** Parse a CSS <time> value (or motion shorthand's first token) to milliseconds. */\nexport function parseCssTimeMs(value: string, fallback: number): number {\n  const firstToken = value.trim().split(/\\s+/)[0] ?? '';\n  const num = parseFloat(firstToken);\n  if (Number.isNaN(num)) return fallback;\n  if (/ms\\s*$/.test(firstToken)) return num;\n  if (/s\\s*$/.test(firstToken)) return num * 1000;\n  return num;\n}\n\nfunction extractCssCustomProp(ref: string): string | null {\n  const varMatch = ref.match(/^var\\(\\s*(--[^),]+)/);\n  if (varMatch) return varMatch[1].trim();\n  if (ref.startsWith('--')) return ref.trim();\n  return null;\n}\n\nfunction readTokenTimeMs(token: string, fallback: number): number {\n  if (typeof document === 'undefined') return fallback;\n\n  const prop = extractCssCustomProp(token);\n  if (!prop) return parseCssTimeMs(token, fallback);\n\n  const raw = getComputedStyle(document.documentElement).getPropertyValue(prop).trim();\n  return parseCssTimeMs(raw, fallback);\n}\n\n/**\n * Resolve a duration to milliseconds for JS timers aligned with CSS motion tokens.\n * Accepts numbers (ms), raw times (`200ms`, `0.75s`), or `var(--effect-*)` references.\n */\nexport function resolveCssTimeMs(\n  value: number | string | undefined,\n  fallbackToken: string,\n): number {\n  if (typeof value === 'number') return value;\n\n  const token = typeof value === 'string' && value.trim() ? value.trim() : fallbackToken;\n  const prop = extractCssCustomProp(token);\n\n  if (prop) {\n    return readTokenTimeMs(token, readTokenTimeMs(fallbackToken, 200));\n  }\n\n  return parseCssTimeMs(token, readTokenTimeMs(fallbackToken, 200));\n}\n\n/** Whether the user has requested reduced non-essential motion. */\nexport function prefersReducedMotion(): boolean {\n  return typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function' &&\n    window.matchMedia('(prefers-reduced-motion: reduce)').matches;\n}\n\n/**\n * Resolve an animation-coupled duration. Returns zero under reduced motion so\n * JS cleanup stays synchronized with CSS that removes the corresponding motion.\n */\nexport function resolveMotionTimeMs(\n  value: number | string | undefined,\n  fallbackToken: string,\n): number {\n  return prefersReducedMotion() ? 0 : resolveCssTimeMs(value, fallbackToken);\n}\n", "/** CSS custom property for scroll-edge fade depth (dimension token or length). */\nexport const SCROLL_EDGE_FADE_SIZE_VAR = '--ds-scroll-edge-fade-size';\n\nexport const SCROLL_EDGE_FADE_DEFAULT_SIZE = 'var(--dimension-size-600)';\n\nexport type ScrollEdgeFadeEdge = 'top' | 'bottom' | 'left' | 'right';\n\nexport type ScrollEdgeFadeSizeToken =\n  | 'size-000'\n  | 'size-050'\n  | 'size-075'\n  | 'size-100'\n  | 'size-150'\n  | 'size-200'\n  | 'size-250'\n  | 'size-300'\n  | 'size-400'\n  | 'size-500'\n  | 'size-600'\n  | 'size-800';\n\nexport type ScrollEdgeFadeSize = ScrollEdgeFadeSizeToken | (string & {});\n\nconst SIZE_VALUE: Record<ScrollEdgeFadeSizeToken, string> = {\n  'size-000': 'var(--dimension-size-000)',\n  'size-050': 'var(--dimension-size-050)',\n  'size-075': 'var(--dimension-size-075)',\n  'size-100': 'var(--dimension-size-100)',\n  'size-150': 'var(--dimension-size-150)',\n  'size-200': 'var(--dimension-size-200)',\n  'size-250': 'var(--dimension-size-250)',\n  'size-300': 'var(--dimension-size-300)',\n  'size-400': 'var(--dimension-size-400)',\n  'size-500': 'var(--dimension-size-500)',\n  'size-600': 'var(--dimension-size-600)',\n  'size-800': 'var(--dimension-size-800)',\n};\n\nconst SIZE_REF = `var(${SCROLL_EDGE_FADE_SIZE_VAR}, ${SCROLL_EDGE_FADE_DEFAULT_SIZE})`;\n\nexport interface ScrollEdgeFadeOptions {\n  /** One or more edges to fade. */\n  edges: ScrollEdgeFadeEdge | ScrollEdgeFadeEdge[];\n  /**\n   * Reveal and hide configured fades from the container's own scroll position.\n   * Uses CSS scroll-driven animations with a static-fade fallback; no listener required.\n   */\n  scrollAware?: boolean;\n  /**\n   * When true, removes the complete mask. Pass a map to remove only configured\n   * edges that are flush when scroll state already lives in JavaScript.\n   */\n  atEnd?: boolean | Partial<Record<ScrollEdgeFadeEdge, boolean>>;\n  /** Force the mask off regardless of scroll position (`ds-fade` `visible={false}`). */\n  hidden?: boolean;\n}\n\n/** Resolve a dimension size token name or raw CSS length for `--ds-scroll-edge-fade-size`. */\nexport function resolveScrollEdgeFadeSize(\n  size: ScrollEdgeFadeSize = 'size-600',\n  height?: string,\n): string {\n  if (height) return height;\n  return Object.prototype.hasOwnProperty.call(SIZE_VALUE, size)\n    ? SIZE_VALUE[size as ScrollEdgeFadeSizeToken]\n    : size;\n}\n\n/** Inline style map setting fade depth on a scroll container. */\nexport function scrollEdgeFadeSizeStyle(\n  size: ScrollEdgeFadeSize = 'size-600',\n  height?: string,\n): Record<string, string> {\n  return {\n    [SCROLL_EDGE_FADE_SIZE_VAR]: resolveScrollEdgeFadeSize(size, height),\n  };\n}\n\n/**\n * Alpha mask for a scroll container edge \u2014 content fades to transparent so\n * textured backgrounds (shell gradients, images) show through.\n */\nexport function scrollEdgeFadeMaskImage(edge: ScrollEdgeFadeEdge): string {\n  switch (edge) {\n    case 'top':\n      return `linear-gradient(to bottom, transparent 0, #000 ${SIZE_REF}, #000 100%)`;\n    case 'bottom':\n      return `linear-gradient(to bottom, #000 0, #000 calc(100% - ${SIZE_REF}), transparent 100%)`;\n    case 'left':\n      return `linear-gradient(to right, transparent 0, #000 ${SIZE_REF}, #000 100%)`;\n    case 'right':\n      return `linear-gradient(to right, #000 0, #000 calc(100% - ${SIZE_REF}), transparent 100%)`;\n  }\n}\n\n/** Inline style map for a masked scroll region (single edge). */\nexport function scrollEdgeFadeMaskStyle(\n  edge: ScrollEdgeFadeEdge,\n  size: ScrollEdgeFadeSize = 'size-600',\n  height?: string,\n): Record<string, string> {\n  const mask = scrollEdgeFadeMaskImage(edge);\n  return {\n    ...scrollEdgeFadeSizeStyle(size, height),\n    WebkitMaskImage: mask,\n    maskImage: mask,\n    WebkitMaskSize: '100% 100%',\n    maskSize: '100% 100%',\n  };\n}\n\n/** Class map for `scroll-edge-fade` modifiers \u2014 pair with `scroll-edge-fade.css`. */\nexport function scrollEdgeFadeClassMap(opts: ScrollEdgeFadeOptions): Record<string, boolean> {\n  const edges = Array.isArray(opts.edges) ? opts.edges : [opts.edges];\n  const classes: Record<string, boolean> = {\n    'scroll-edge-fade': true,\n    'scroll-edge-fade--scroll-aware': opts.scrollAware === true,\n    'scroll-edge-fade--hidden': opts.hidden === true,\n  };\n\n  for (const edge of edges) {\n    classes[`scroll-edge-fade--${edge}`] = true;\n  }\n\n  const { atEnd } = opts;\n  if (atEnd === true) {\n    classes['scroll-edge-fade--at-end'] = true;\n  } else if (atEnd && typeof atEnd === 'object') {\n    for (const edge of edges) {\n      if (atEnd[edge]) {\n        classes[`scroll-edge-fade--${edge}-at-edge`] = true;\n      }\n    }\n  }\n\n  return classes;\n}\n\n/** Whether a scroll container is flush with the given edge (within `threshold` px). */\nexport function isScrollAtEdge(\n  el: HTMLElement,\n  edge: ScrollEdgeFadeEdge,\n  threshold = 2,\n): boolean {\n  switch (edge) {\n    case 'top':\n      return el.scrollTop <= threshold;\n    case 'bottom':\n      return el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;\n    case 'left':\n      return el.scrollLeft <= threshold;\n    case 'right':\n      return el.scrollWidth - el.scrollLeft - el.clientWidth <= threshold;\n  }\n}\n", "import {\n  dimensionIconographyMd,\n  dimensionIconographySm,\n  dimensionIconographyXs,\n  dimensionMenuWidthXs,\n  dimensionPanelWidth2xs,\n  dimensionPanelWidthLg,\n  dimensionPanelWidthMd,\n  dimensionRadius025,\n  dimensionSize200,\n  dimensionSize300,\n  dimensionSize400,\n  dimensionSize600,\n  dimensionSize800,\n  dimensionSpace100,\n  dimensionSpace050,\n  dimensionSpace200,\n  dimensionSpace300,\n  dimensionSpace400,\n  typographyLineheightLg,\n  typographyLineheightMd,\n  typographyLineheightSm,\n  typographyLineheightXl,\n  typographyLineheightXs,\n  effectAnimationDelayLong2,\n  effectAnimationDelayMedium1,\n  effectAnimationDelayMedium3,\n  effectAnimationDelayInstant,\n  effectAnimationDelayShort2,\n  effectAnimationDurationMedium1,\n  effectAnimationDurationShort3,\n  effectMotionShort2,\n  effectMotionShort3,\n} from '@ds-mo/tokens/ts';\n\n/** TokoMo CSS custom-property names for shared component defaults (runtime resolution). */\nexport const TOKEN_DEFAULTS = {\n  space050: dimensionSpace050,\n  space100: dimensionSpace100,\n  space200: dimensionSpace200,\n  space300: dimensionSpace300,\n  space400: dimensionSpace400,\n  radius025: dimensionRadius025,\n  size200: dimensionSize200,\n  size300: dimensionSize300,\n  size400: dimensionSize400,\n  size600: dimensionSize600,\n  size800: dimensionSize800,\n  iconographyMd: dimensionIconographyMd,\n  iconographySm: dimensionIconographySm,\n  iconographyXs: dimensionIconographyXs,\n  panelWidth2xs: dimensionPanelWidth2xs,\n  panelWidthMd: dimensionPanelWidthMd,\n  panelWidthLg: dimensionPanelWidthLg,\n  menuWidthXs: dimensionMenuWidthXs,\n  lineheightLg: typographyLineheightLg,\n  lineheightMd: typographyLineheightMd,\n  lineheightSm: typographyLineheightSm,\n  lineheightXl: typographyLineheightXl,\n  lineheightXs: typographyLineheightXs,\n  motionShort2: effectMotionShort2,\n  motionShort3: effectMotionShort3,\n  animationDurationShort3: effectAnimationDurationShort3,\n  animationDurationMedium1: effectAnimationDurationMedium1,\n  animationDelayInstant: effectAnimationDelayInstant,\n  animationDelayMedium1: effectAnimationDelayMedium1,\n  animationDelayMedium3: effectAnimationDelayMedium3,\n  animationDelayShort2: effectAnimationDelayShort2,\n  animationDelayLong2: effectAnimationDelayLong2,\n  /** Unmeasured menu height fallback: 20\u00D7 base (160px at default scale). */\n  menuFallbackHeight: 'calc(var(--dimension-size-base) * 20)',\n  /** Unmeasured tooltip width fallback: size-800 + size-200 (80px). */\n  tooltipFallbackWidth: 'calc(var(--dimension-size-800) + var(--dimension-size-200))',\n  /** Fill-mode donut diameter floor: 16\u00D7 size-base (128px). */\n  donutFillMin: 'calc(var(--dimension-size-base) * 16)',\n  /** Fill-mode donut diameter ceiling: 24\u00D7 size-base (192px). */\n  donutFillMax: 'calc(var(--dimension-size-base) * 24)',\n} as const;\n\nexport type TokenDefaultKey = keyof typeof TOKEN_DEFAULTS;\n\n/** Valid CSS length strings for overlay offset props \u2014 bind on `sideOffset` / `alignOffset` in hosts. */\nexport const TOKEN_CSS_LENGTHS = {\n  space050: `var(${dimensionSpace050})`,\n  space200: `var(${dimensionSpace200})`,\n  menuWidthXs: `var(${dimensionMenuWidthXs})`,\n} as const;\n", "/**\n * Shared \"required field\" validity contract for form-associated custom\n * elements (Checkbox, Radio, Switch, Input, Select, \u2026).\n *\n * Each control computes its own `missing` condition (what counts as empty\n * differs: unchecked, no value, no selection, \u2026) and its own form value, then\n * calls `setRequiredValidity` instead of hand-rolling the `setValidity` call\n * and the default message string.\n *\n * @see AGENTS.md \u2014 \"Required-field validity\"\n */\n\nexport const DEFAULT_REQUIRED_MESSAGE = 'This field is required.';\n\n/** Sets or clears the `valueMissing` validity flag on a form-associated element. */\nexport function setRequiredValidity(\n  internals: ElementInternals,\n  missing: boolean,\n  message: string,\n): void {\n  internals.setValidity(missing ? { valueMissing: true } : {}, missing ? message : '');\n}\n", "export type FormControlState = File | FormData | string | null;\n\nexport interface SetFormControlValueOptions {\n  inactive?: boolean;\n  state?: FormControlState;\n}\n\nexport interface SetRepeatedFormControlValueOptions {\n  inactive?: boolean;\n  state?: FormControlState;\n}\n\n/**\n * Set one form-associated value while consistently omitting inactive controls.\n * Pass `state` only when restoration differs from the submitted value.\n */\nexport function setFormControlValue(\n  internals: ElementInternals,\n  value: File | string | null,\n  options: SetFormControlValueOptions = {}\n): void {\n  const submission = options.inactive ? null : value;\n  if (options.state === undefined) {\n    internals.setFormValue(submission);\n    return;\n  }\n  internals.setFormValue(submission, options.state);\n}\n\n/**\n * Submit repeated values under one field name and preserve a serialized array\n * for browser form-state restoration.\n */\nexport function setRepeatedFormControlValue(\n  internals: ElementInternals,\n  name: string | null | undefined,\n  values: readonly (number | string)[],\n  options: SetRepeatedFormControlValueOptions = {}\n): void {\n  if (options.inactive || !name || values.length === 0) {\n    internals.setFormValue(null);\n    return;\n  }\n\n  const data = new FormData();\n  values.forEach(value => data.append(name, String(value)));\n  internals.setFormValue(data, options.state ?? JSON.stringify(values));\n}\n\nexport function restoreStringFormState(\n  state: FormControlState,\n  fallback: string = ''\n): string {\n  return typeof state === 'string' ? state : fallback;\n}\n\nexport function restoreStringArrayFormState(state: FormControlState): string[] {\n  if (typeof state !== 'string') return [];\n  try {\n    const restored: unknown = JSON.parse(state);\n    return Array.isArray(restored)\n      ? restored.filter((value): value is string => typeof value === 'string')\n      : [];\n  } catch {\n    return [];\n  }\n}\n\nexport function restoreNumberArrayFormState(\n  state: FormControlState,\n  maximumValues?: number\n): number[] {\n  if (typeof state !== 'string') return [];\n  try {\n    const restored: unknown = JSON.parse(state);\n    if (!Array.isArray(restored)) return [];\n    const values = restored\n      .map(value => typeof value === 'number' ? value : Number(value))\n      .filter(value => Number.isFinite(value));\n    return maximumValues === undefined ? values : values.slice(0, maximumValues);\n  } catch {\n    return [];\n  }\n}\n", "export type SafeUrlProtocol = 'blob:' | 'http:' | 'https:' | 'mailto:';\n\nexport interface ResolveSafeUrlOptions {\n  protocols?: readonly SafeUrlProtocol[];\n  baseUrl?: string | URL;\n}\n\nconst DEFAULT_PROTOCOLS: readonly SafeUrlProtocol[] = ['http:', 'https:'];\n\n/**\n * Resolve a consumer-authored URL only when its protocol is explicitly allowed.\n * Relative URLs use the current document base in browser rendering; server-side\n * callers can provide `baseUrl` when they intentionally support relative input.\n */\nexport function resolveSafeUrl(\n  value: string | null | undefined,\n  options: ResolveSafeUrlOptions = {}\n): string | undefined {\n  const candidate = value?.trim();\n  if (!candidate) return undefined;\n\n  const baseUrl =\n    options.baseUrl ??\n    (typeof document === 'undefined' ? undefined : document.baseURI);\n\n  try {\n    const url = baseUrl === undefined\n      ? new URL(candidate)\n      : new URL(candidate, baseUrl);\n    const protocols = options.protocols ?? DEFAULT_PROTOCOLS;\n    return protocols.includes(url.protocol as SafeUrlProtocol) ? url.href : undefined;\n  } catch {\n    return undefined;\n  }\n}\n", "/** Shared width fit for interactive controls (buttons, select, \u2026). */\nexport type ControlWidth = 'hug' | 'fill';\n\n/** Host / control class map for `width=\"hug\" | \"fill\"`. */\nexport function controlWidthClass(width: ControlWidth): Record<string, boolean> {\n  return {\n    'ds-control-width--hug': width === 'hug',\n    'ds-control-width--fill': width === 'fill',\n  };\n}\n", "import type { TextVariant } from '../components/Text/text-types';\n\n/** Shared public control sizes. Typography is derived; it is not a separate density API. */\nexport type ControlSize = 'lg' | 'md' | 'sm' | 'xs';\n\n/** Complete text variant selected internally by each control size. */\nexport const CONTROL_TEXT_VARIANT: Record<ControlSize, TextVariant> = {\n  lg: 'text-body-large',\n  md: 'text-body-medium',\n  sm: 'text-body-small',\n  xs: 'text-caption',\n};\n\n/** Supporting copy paired with each control density in two-line choice rows. */\nexport const CONTROL_SUPPORTING_TEXT_VARIANT: Record<ControlSize, TextVariant> = {\n  lg: 'text-body-medium',\n  md: 'text-body-small',\n  sm: 'text-caption',\n  xs: 'text-caption',\n};\n", "import type { AnchoredAlign } from './anchored-position';\n\n/**\n * `choice-cell` aligns the first/last interactive row edge with the anchor,\n * allowing the popup frame to extend by the section inset. `popup-frame`\n * aligns the popup frame itself and is reserved for deliberate custom geometry.\n */\nexport type ChoicePopupAnchorAlignment = 'choice-cell' | 'popup-frame';\n\nexport interface ChoicePopupAlignOffsetInput {\n  align: AnchoredAlign;\n  alignOffsetPx: number;\n  sectionInsetPx: number;\n  anchorAlignment?: ChoicePopupAnchorAlignment;\n}\n\n/**\n * Resolve the cross-axis offset for a choice popup. Authored `alignOffsetPx`\n * remains an additive nudge after the shared inner-cell alignment is applied.\n */\nexport function resolveChoicePopupAlignOffset({\n  align,\n  alignOffsetPx,\n  sectionInsetPx,\n  anchorAlignment = 'choice-cell',\n}: ChoicePopupAlignOffsetInput): number {\n  if (anchorAlignment === 'popup-frame' || align === 'center') return alignOffsetPx;\n  return alignOffsetPx + (align === 'start' ? -sectionInsetPx : sectionInsetPx);\n}\n\n/** Minimum popup width that keeps both choice-cell edges aligned to a trigger. */\nexport function choicePopupMinWidth(anchorWidth: number, sectionInsetPx: number): number {\n  return anchorWidth + sectionInsetPx * 2;\n}\n"],
+  "mappings": ";AAQA,IAAM,YAAY,uBAAO,IAAI,sBAAsB;AAM5C,SAAS,aAAa,MAAc,MAAuB;AAChE,SAAO,OAAO,QAAQ,IAAI,KAAK,UAAU,IAAI;AAC/C;AAEO,SAAS,YAA0B;AACxC,QAAM,IAAI;AACV,SAAQ,gCAAiB,oBAAI,IAAI;AACnC;AAmBO,SAAS,cAAc,OAA+B,SAAoC;AAC/F,QAAM,QAAQ,UAAU;AACxB,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,UAAM,OAAO,SAAS,QAAQ,KAAK,WAAW,MAAM;AACpD,UAAM,IAAI,aAAa,MAAM,IAAI,GAAG,GAAG;AAAA,EACzC;AACF;;;AC9CA,IAAM,gBAAgB,oBAAI,IAAoB;AAE9C,IAAI,UAA8B;AAElC,SAAS,kBAAsC;AAC7C,MAAI,OAAO,aAAa,YAAa,QAAO;AAE5C,MAAI,CAAC,SAAS;AACZ,cAAU,SAAS,cAAc,KAAK;AACtC,YAAQ,aAAa,eAAe,MAAM;AAC1C,YAAQ,MAAM,UACZ;AACF,aAAS,gBAAgB,YAAY,OAAO;AAAA,EAC9C;AAEA,SAAO;AACT;AAGO,SAAS,wBAA8B;AAC5C,gBAAc,MAAM;AACtB;AAMO,SAAS,mBACd,OACA,UACQ;AACR,QAAM,WAAW,UAAU,UAAa,UAAU,QAAQ,UAAU,KAAK,WAAW;AACpF,MAAI,OAAO,aAAa,SAAU,QAAO;AAEzC,QAAM,UAAU,SAAS,KAAK;AAC9B,MAAI,CAAC,QAAS,QAAO,mBAAmB,UAAU,CAAC;AAEnD,QAAM,SAAS,cAAc,IAAI,OAAO;AACxC,MAAI,WAAW,OAAW,QAAO;AAEjC,MAAI,kBAAkB,KAAK,OAAO,GAAG;AACnC,UAAM,IAAI,OAAO,OAAO;AACxB,kBAAc,IAAI,SAAS,CAAC;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,QAAQ,MAAM,qBAAqB;AACnD,MAAI,SAAS;AACX,UAAMA,MAAK,WAAW,QAAQ,CAAC,CAAC;AAChC,kBAAc,IAAI,SAASA,GAAE;AAC7B,WAAOA;AAAA,EACT;AAEA,QAAM,YAAY,aAAa,KAAK,OAAO,IAAI,OAAO,OAAO,MAAM;AAEnE,QAAM,QAAQ,gBAAgB;AAC9B,MAAI,CAAC,OAAO;AACV,WAAO,OAAO,aAAa,WAAW,WAAW;AAAA,EACnD;AAEA,QAAM,MAAM,QAAQ;AACpB,QAAM,KAAK,MAAM,sBAAsB,EAAE;AACzC,QAAM,MAAM,QAAQ;AAKpB,MAAI,OAAO,KAAK,CAAC,UAAU,SAAS,MAAM,GAAG;AAC3C,kBAAc,IAAI,SAAS,EAAE;AAAA,EAC/B;AACA,SAAO;AACT;;;ACvEA,IAAM,gBAAyD;AAAA,EAC7D,EAAE,WAAW,KAAe,QAAQ,IAAI;AAAA,EACxC,EAAE,WAAW,KAAW,QAAQ,IAAI;AAAA,EACpC,EAAE,WAAW,KAAO,QAAQ,IAAI;AAClC;AAGO,SAAS,oBAAoB,OAAe,QAAyB;AAC1E,MAAI,QAAQ;AACV,WAAO,IAAI,KAAK,aAAa,QAAQ;AAAA,MACnC,UAAU;AAAA,MACV,gBAAgB;AAAA,MAChB,uBAAuB;AAAA,IACzB,CAAC,EAAE,OAAO,KAAK;AAAA,EACjB;AACA,QAAM,OAAO,QAAQ,IAAI,MAAM;AAC/B,QAAM,MAAM,KAAK,IAAI,KAAK;AAC1B,MAAI,MAAM,IAAM,QAAO,OAAO,KAAK;AAEnC,WAAS,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK;AAC7C,UAAM,OAAO,cAAc,CAAC;AAC5B,QAAI,MAAM,KAAK,UAAW;AAE1B,QAAI,SAAS,KAAK,MAAO,MAAM,KAAK,YAAa,EAAE,IAAI;AAEvD,QAAI,UAAU,OAAQ,IAAI,GAAG;AAC3B,YAAM,OAAO,cAAc,IAAI,CAAC;AAChC,eAAS,KAAK,MAAO,MAAM,KAAK,YAAa,EAAE,IAAI;AACnD,aAAO,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,MAAM;AAAA,IACvC;AACA,WAAO,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,MAAM;AAAA,EACvC;AACA,SAAO,OAAO,KAAK;AACrB;;;AC9BO,SAAS,iBACd,OACA,WAA+B,GAC/B,QACQ;AACR,QAAM,YAAY,aAAa,IAAI,IAAI;AACvC,QAAM,QAAQ,OAAO,SAAS,KAAK,IAAI,QAAQ;AAE/C,SAAO,IAAI,KAAK,aAAa,QAAQ;AAAA,IACnC,OAAO;AAAA,IACP,uBAAuB;AAAA,IACvB,uBAAuB;AAAA,EACzB,CAAC,EAAE,OAAO,KAAK;AACjB;;;AC4BA,IAAM,YAA0B,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,KAAK;AAEnF,SAAS,SAAS,OAAmD;AACnE,SAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAC3D;AAQO,SAAS,oBACd,SACA,UACc;AACd,MAAI,CAAC,SAAS,OAAO,KAAK,CAAC,SAAS,QAAQ,EAAG,QAAO;AAGtD,QAAM,QAAQ,OAAO,YAAY,UAAU,UAAU,QAAQ,EAAE,CAAC;AAChE,MAAI,UAAU,EAAG,QAAO;AAExB,QAAM,WAAW,KAAK,IAAI,KAAK;AAC/B,QAAM,QAAQ,aAAa,IAAI,IAAI,KAAK,IAAI,QAAQ,QAAQ;AAE5D,SAAO,EAAE,OAAO,UAAU,OAAO,WAAW,QAAQ,IAAI,OAAO,OAAO;AACxE;AASO,SAAS,mBACd,SACA,UACA,UAAqC,CAAC,GAClB;AACpB,QAAM,EAAE,WAAW,OAAO,UAAU,OAAO,UAAU,YAAY,OAAO,IAAI;AAC5E,QAAM,SAAS,oBAAoB,SAAS,QAAQ;AACpD,MAAI,CAAC,OAAO,UAAW,QAAO;AAG9B,QAAM,OAAO,OAAO,cAAc;AAClC,QAAM,OAAwB,UAC1B,YACA,SAAS,WACP,aACA;AAEN,QAAM,QAAQ,YAAY,eACtB,IAAI,KAAK,aAAa,QAAQ,EAAE,OAAO,WAAW,uBAAuB,EAAE,CAAC,EAAE,OAAO,OAAO,KAAK,IACjG,oBAAoB,OAAO,UAAU,MAAM;AAE/C,SAAO,EAAE,WAAW,OAAO,WAAW,OAAO,KAAK;AACpD;;;AC7FO,SAAS,uBAAuB,IAAoB,MAAc,UAA0B;AACjG,KAAG,cAAc;AACjB,MAAI,YAAY,KAAK,GAAG,sBAAsB,KAAK,SAAU,QAAO;AAEpE,MAAI,KAAK;AACT,MAAI,KAAK,KAAK;AACd,SAAO,KAAK,IAAI;AACd,UAAM,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC;AACnC,OAAG,cAAc,GAAG,KAAK,MAAM,GAAG,GAAG,CAAC;AACtC,QAAI,GAAG,sBAAsB,KAAK,UAAU;AAC1C,WAAK;AAAA,IACP,OAAO;AACL,WAAK,MAAM;AAAA,IACb;AAAA,EACF;AACA,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,WAAM;AAC5C;;;ACvBO,SAAS,eAAe,OAAe,UAA0B;AACtE,QAAM,aAAa,MAAM,KAAK,EAAE,MAAM,KAAK,EAAE,CAAC,KAAK;AACnD,QAAM,MAAM,WAAW,UAAU;AACjC,MAAI,OAAO,MAAM,GAAG,EAAG,QAAO;AAC9B,MAAI,SAAS,KAAK,UAAU,EAAG,QAAO;AACtC,MAAI,QAAQ,KAAK,UAAU,EAAG,QAAO,MAAM;AAC3C,SAAO;AACT;AAEA,SAAS,qBAAqB,KAA4B;AACxD,QAAM,WAAW,IAAI,MAAM,qBAAqB;AAChD,MAAI,SAAU,QAAO,SAAS,CAAC,EAAE,KAAK;AACtC,MAAI,IAAI,WAAW,IAAI,EAAG,QAAO,IAAI,KAAK;AAC1C,SAAO;AACT;AAEA,SAAS,gBAAgB,OAAe,UAA0B;AAChE,MAAI,OAAO,aAAa,YAAa,QAAO;AAE5C,QAAM,OAAO,qBAAqB,KAAK;AACvC,MAAI,CAAC,KAAM,QAAO,eAAe,OAAO,QAAQ;AAEhD,QAAM,MAAM,iBAAiB,SAAS,eAAe,EAAE,iBAAiB,IAAI,EAAE,KAAK;AACnF,SAAO,eAAe,KAAK,QAAQ;AACrC;AAMO,SAAS,iBACd,OACA,eACQ;AACR,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,QAAM,QAAQ,OAAO,UAAU,YAAY,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI;AACzE,QAAM,OAAO,qBAAqB,KAAK;AAEvC,MAAI,MAAM;AACR,WAAO,gBAAgB,OAAO,gBAAgB,eAAe,GAAG,CAAC;AAAA,EACnE;AAEA,SAAO,eAAe,OAAO,gBAAgB,eAAe,GAAG,CAAC;AAClE;AAGO,SAAS,uBAAgC;AAC9C,SAAO,OAAO,WAAW,eACvB,OAAO,OAAO,eAAe,cAC7B,OAAO,WAAW,kCAAkC,EAAE;AAC1D;AAMO,SAAS,oBACd,OACA,eACQ;AACR,SAAO,qBAAqB,IAAI,IAAI,iBAAiB,OAAO,aAAa;AAC3E;;;AC9DO,IAAM,4BAA4B;AAElC,IAAM,gCAAgC;AAoB7C,IAAM,aAAsD;AAAA,EAC1D,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AACd;AAEA,IAAM,WAAW,OAAO,yBAAyB,KAAK,6BAA6B;AAoB5E,SAAS,0BACd,OAA2B,YAC3B,QACQ;AACR,MAAI,OAAQ,QAAO;AACnB,SAAO,OAAO,UAAU,eAAe,KAAK,YAAY,IAAI,IACxD,WAAW,IAA+B,IAC1C;AACN;AAGO,SAAS,wBACd,OAA2B,YAC3B,QACwB;AACxB,SAAO;AAAA,IACL,CAAC,yBAAyB,GAAG,0BAA0B,MAAM,MAAM;AAAA,EACrE;AACF;AAMO,SAAS,wBAAwB,MAAkC;AACxE,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,kDAAkD,QAAQ;AAAA,IACnE,KAAK;AACH,aAAO,uDAAuD,QAAQ;AAAA,IACxE,KAAK;AACH,aAAO,iDAAiD,QAAQ;AAAA,IAClE,KAAK;AACH,aAAO,sDAAsD,QAAQ;AAAA,EACzE;AACF;AAGO,SAAS,wBACd,MACA,OAA2B,YAC3B,QACwB;AACxB,QAAM,OAAO,wBAAwB,IAAI;AACzC,SAAO;AAAA,IACL,GAAG,wBAAwB,MAAM,MAAM;AAAA,IACvC,iBAAiB;AAAA,IACjB,WAAW;AAAA,IACX,gBAAgB;AAAA,IAChB,UAAU;AAAA,EACZ;AACF;AAGO,SAAS,uBAAuB,MAAsD;AAC3F,QAAM,QAAQ,MAAM,QAAQ,KAAK,KAAK,IAAI,KAAK,QAAQ,CAAC,KAAK,KAAK;AAClE,QAAM,UAAmC;AAAA,IACvC,oBAAoB;AAAA,IACpB,kCAAkC,KAAK,gBAAgB;AAAA,IACvD,4BAA4B,KAAK,WAAW;AAAA,EAC9C;AAEA,aAAW,QAAQ,OAAO;AACxB,YAAQ,qBAAqB,IAAI,EAAE,IAAI;AAAA,EACzC;AAEA,QAAM,EAAE,MAAM,IAAI;AAClB,MAAI,UAAU,MAAM;AAClB,YAAQ,0BAA0B,IAAI;AAAA,EACxC,WAAW,SAAS,OAAO,UAAU,UAAU;AAC7C,eAAW,QAAQ,OAAO;AACxB,UAAI,MAAM,IAAI,GAAG;AACf,gBAAQ,qBAAqB,IAAI,UAAU,IAAI;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,eACd,IACA,MACA,YAAY,GACH;AACT,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,GAAG,aAAa;AAAA,IACzB,KAAK;AACH,aAAO,GAAG,eAAe,GAAG,YAAY,GAAG,gBAAgB;AAAA,IAC7D,KAAK;AACH,aAAO,GAAG,cAAc;AAAA,IAC1B,KAAK;AACH,aAAO,GAAG,cAAc,GAAG,aAAa,GAAG,eAAe;AAAA,EAC9D;AACF;;;AC1JA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGA,IAAM,iBAAiB;AAAA,EAC5B,UAAU;AAAA,EACV,UAAU;AAAA,EACV,UAAU;AAAA,EACV,UAAU;AAAA,EACV,UAAU;AAAA,EACV,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,cAAc;AAAA,EACd,cAAc;AAAA,EACd,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,yBAAyB;AAAA,EACzB,0BAA0B;AAAA,EAC1B,uBAAuB;AAAA,EACvB,uBAAuB;AAAA,EACvB,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA,EAEpB,sBAAsB;AAAA;AAAA,EAEtB,cAAc;AAAA;AAAA,EAEd,cAAc;AAChB;AAKO,IAAM,oBAAoB;AAAA,EAC/B,UAAU,OAAO,iBAAiB;AAAA,EAClC,UAAU,OAAO,iBAAiB;AAAA,EAClC,aAAa,OAAO,oBAAoB;AAC1C;;;AC1EO,IAAM,2BAA2B;AAGjC,SAAS,oBACd,WACA,SACA,SACM;AACN,YAAU,YAAY,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,UAAU,UAAU,EAAE;AACrF;;;ACLO,SAAS,oBACd,WACA,OACA,UAAsC,CAAC,GACjC;AACN,QAAM,aAAa,QAAQ,WAAW,OAAO;AAC7C,MAAI,QAAQ,UAAU,QAAW;AAC/B,cAAU,aAAa,UAAU;AACjC;AAAA,EACF;AACA,YAAU,aAAa,YAAY,QAAQ,KAAK;AAClD;AAMO,SAAS,4BACd,WACA,MACA,QACA,UAA8C,CAAC,GACzC;AACN,MAAI,QAAQ,YAAY,CAAC,QAAQ,OAAO,WAAW,GAAG;AACpD,cAAU,aAAa,IAAI;AAC3B;AAAA,EACF;AAEA,QAAM,OAAO,IAAI,SAAS;AAC1B,SAAO,QAAQ,WAAS,KAAK,OAAO,MAAM,OAAO,KAAK,CAAC,CAAC;AACxD,YAAU,aAAa,MAAM,QAAQ,SAAS,KAAK,UAAU,MAAM,CAAC;AACtE;AAEO,SAAS,uBACd,OACA,WAAmB,IACX;AACR,SAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEO,SAAS,4BAA4B,OAAmC;AAC7E,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC;AACvC,MAAI;AACF,UAAM,WAAoB,KAAK,MAAM,KAAK;AAC1C,WAAO,MAAM,QAAQ,QAAQ,IACzB,SAAS,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ,IACrE,CAAC;AAAA,EACP,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEO,SAAS,4BACd,OACA,eACU;AACV,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC;AACvC,MAAI;AACF,UAAM,WAAoB,KAAK,MAAM,KAAK;AAC1C,QAAI,CAAC,MAAM,QAAQ,QAAQ,EAAG,QAAO,CAAC;AACtC,UAAM,SAAS,SACZ,IAAI,WAAS,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK,CAAC,EAC9D,OAAO,WAAS,OAAO,SAAS,KAAK,CAAC;AACzC,WAAO,kBAAkB,SAAY,SAAS,OAAO,MAAM,GAAG,aAAa;AAAA,EAC7E,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;AC5EA,IAAM,oBAAgD,CAAC,SAAS,QAAQ;AAOjE,SAAS,eACd,OACA,UAAiC,CAAC,GACd;AACpB,QAAM,YAAY,OAAO,KAAK;AAC9B,MAAI,CAAC,UAAW,QAAO;AAEvB,QAAM,UACJ,QAAQ,YACP,OAAO,aAAa,cAAc,SAAY,SAAS;AAE1D,MAAI;AACF,UAAM,MAAM,YAAY,SACpB,IAAI,IAAI,SAAS,IACjB,IAAI,IAAI,WAAW,OAAO;AAC9B,UAAM,YAAY,QAAQ,aAAa;AACvC,WAAO,UAAU,SAAS,IAAI,QAA2B,IAAI,IAAI,OAAO;AAAA,EAC1E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;AC9BO,SAAS,kBAAkB,OAA8C;AAC9E,SAAO;AAAA,IACL,yBAAyB,UAAU;AAAA,IACnC,0BAA0B,UAAU;AAAA,EACtC;AACF;;;ACHO,IAAM,uBAAyD;AAAA,EACpE,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAGO,IAAM,kCAAoE;AAAA,EAC/E,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;;;ACCO,SAAS,8BAA8B;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AACpB,GAAwC;AACtC,MAAI,oBAAoB,iBAAiB,UAAU,SAAU,QAAO;AACpE,SAAO,iBAAiB,UAAU,UAAU,CAAC,iBAAiB;AAChE;AAGO,SAAS,oBAAoB,aAAqB,gBAAgC;AACvF,SAAO,cAAc,iBAAiB;AACxC;",
   "names": ["px"]
 }

package/dist/lib/utils/required-validity.d.ts

@@ -1,6 +1,6 @@
 /**
  * Shared "required field" validity contract for form-associated custom
- * elements (Checkbox, Radio, Switch, Input, Select, SelectMulti, …).
+ * elements (Checkbox, Radio, Switch, Input, Select, …).
  *
  * Each control computes its own `missing` condition (what counts as empty
  * differs: unchecked, no value, no selection, …) and its own form value, then

package/dist/lib/utils/safe-url.d.ts

@@ -0,0 +1,11 @@
+export type SafeUrlProtocol = 'blob:' | 'http:' | 'https:' | 'mailto:';
+export interface ResolveSafeUrlOptions {
+    protocols?: readonly SafeUrlProtocol[];
+    baseUrl?: string | URL;
+}
+/**
+ * Resolve a consumer-authored URL only when its protocol is explicitly allowed.
+ * Relative URLs use the current document base in browser rendering; server-side
+ * callers can provide `baseUrl` when they intentionally support relative input.
+ */
+export declare function resolveSafeUrl(value: string | null | undefined, options?: ResolveSafeUrlOptions): string | undefined;

package/dist/mcp/cli.js

@@ -31151,6 +31151,18 @@ var COMPONENT_LIST_OUTPUT_SCHEMA = external_exports.object({
 var COMPONENT_OUTPUT_SCHEMA = external_exports.object({
   component: JSON_OBJECT_SCHEMA
 });
+var SETUP_GUIDE_OUTPUT_SCHEMA = external_exports.object({
+  guide: external_exports.string()
+});
+var COMPONENT_SOURCE_OUTPUT_SCHEMA = external_exports.object({
+  name: external_exports.string(),
+  title: external_exports.string(),
+  files: external_exports.array(external_exports.object({
+    path: external_exports.string(),
+    language: external_exports.enum(["css", "tsx"]),
+    content: external_exports.string()
+  }))
+});
 var PATTERN_SUMMARY_SCHEMA = external_exports.object({
   id: external_exports.string(),
   status: external_exports.string(),
@@ -31412,10 +31424,15 @@ server.registerTool(
   {
     title: "Get Setup Guide",
     description: "Get the full project setup guide for @ds-mo/ui \u2014 install commands, CSS imports, theme configuration, and design token architecture.",
+    outputSchema: SETUP_GUIDE_OUTPUT_SCHEMA,
     annotations: READ_ONLY_TOOL_ANNOTATIONS
   },
   async () => {
-    return { content: [{ type: "text", text: formatSetupGuide() }] };
+    const guide = formatSetupGuide();
+    return {
+      content: [{ type: "text", text: guide }],
+      structuredContent: { guide }
+    };
   }
 );
 server.registerTool(
@@ -31426,6 +31443,7 @@ server.registerTool(
     inputSchema: external_exports.object({
       name: external_exports.string().describe('Component name in kebab-case (e.g., "button", "modal").')
     }),
+    outputSchema: COMPONENT_SOURCE_OUTPUT_SCHEMA,
     annotations: READ_ONLY_TOOL_ANNOTATIONS
   },
   async ({ name }) => {
@@ -31437,18 +31455,28 @@ server.registerTool(
         isError: true
       };
     }
-    const sections = comp.files.map((f) => {
-      const lang = f.path.endsWith(".css") ? "css" : "tsx";
-      return `### ${f.path}
-
-\`\`\`${lang}
-${f.content}
-\`\`\``;
+    const files = comp.files.map((f) => {
+      const language = f.path.endsWith(".css") ? "css" : "tsx";
+      return { path: f.path, language, content: f.content };
     });
+    const sections = files.map(
+      (file2) => `### ${file2.path}
+
+\`\`\`${file2.language}
+${file2.content}
+\`\`\``
+    );
     const header = formatComponentSourceHeader(comp);
-    return { content: [{ type: "text", text: `${header}
+    return {
+      content: [{ type: "text", text: `${header}
 
-${sections.join("\n\n")}` }] };
+${sections.join("\n\n")}` }],
+      structuredContent: {
+        name: comp.name,
+        title: comp.title,
+        files
+      }
+    };
   }
 );
 server.registerTool(

package/dist/mcp-data/registry/agent-source-list.json

@@ -146,7 +146,7 @@
     },
     {
       "path": "src/wc/components/AgentSourceList/AgentSourceList.tsx",
-      "content": "import { Component, Prop, h, Host } from '@stencil/core';\nimport type { AgentSource } from '../conversation-types';\n\n@Component({ tag: 'ds-agent-source-list', styleUrl: 'AgentSourceList.css', scoped: true })\nexport class AgentSourceList {\n  @Prop() items: AgentSource[] = [];\n  @Prop() heading: string = 'Sources';\n  @Prop() open: boolean = false;\n\n  private safeUrl(value: string) {\n    try {\n      const parsed = new URL(value, document.baseURI);\n      return parsed.protocol === 'http:' || parsed.protocol === 'https:' ? parsed.href : undefined;\n    } catch { return undefined; }\n  }\n\n  render() {\n    if (!this.items.length) return null;\n    return (\n      <Host>\n        <details class=\"agent-sources\" open={this.open}>\n          <summary>\n            <ds-icon name=\"ChevronRight\" size=\"xs\" color=\"inherit\" />\n            <ds-text variant=\"text-body-small\" emphasis>{this.heading} · {this.items.length}</ds-text>\n          </summary>\n          <ol>\n            {this.items.map(source => {\n              const href = this.safeUrl(source.url);\n              return <li>\n                {href\n                  ? <a href={href} target=\"_blank\" rel=\"noopener noreferrer\"><ds-text variant=\"text-body-small\" emphasis>{source.title}</ds-text><ds-icon name=\"ExternalLink\" size=\"xs\" color=\"inherit\" /></a>\n                  : <ds-text variant=\"text-body-small\" emphasis>{source.title}</ds-text>}\n                {source.description ? <ds-text variant=\"text-caption\" color=\"secondary\">{source.description}</ds-text> : null}\n              </li>;\n            })}\n          </ol>\n        </details>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Prop, h, Host } from '@stencil/core';\nimport { resolveSafeUrl } from '../../utils';\nimport type { AgentSource } from '../conversation-types';\n\n@Component({ tag: 'ds-agent-source-list', styleUrl: 'AgentSourceList.css', scoped: true })\nexport class AgentSourceList {\n  @Prop() items: AgentSource[] = [];\n  @Prop() heading: string = 'Sources';\n  @Prop() open: boolean = false;\n\n  render() {\n    if (!this.items.length) return null;\n    return (\n      <Host>\n        <details class=\"agent-sources\" open={this.open}>\n          <summary>\n            <ds-icon name=\"ChevronRight\" size=\"xs\" color=\"inherit\" />\n            <ds-text variant=\"text-body-small\" emphasis>{this.heading} · {this.items.length}</ds-text>\n          </summary>\n          <ol>\n            {this.items.map(source => {\n              const href = resolveSafeUrl(source.url);\n              return <li>\n                {href\n                  ? <a href={href} target=\"_blank\" rel=\"noopener noreferrer\"><ds-text variant=\"text-body-small\" emphasis>{source.title}</ds-text><ds-icon name=\"ExternalLink\" size=\"xs\" color=\"inherit\" /></a>\n                  : <ds-text variant=\"text-body-small\" emphasis>{source.title}</ds-text>}\n                {source.description ? <ds-text variant=\"text-caption\" color=\"secondary\">{source.description}</ds-text> : null}\n              </li>;\n            })}\n          </ol>\n        </details>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

package/dist/mcp-data/registry/attachment-list.json

@@ -130,7 +130,7 @@
     },
     {
       "path": "src/wc/components/AttachmentList/AttachmentList.tsx",
-      "content": "import { Component, h, Host, Prop } from '@stencil/core';\nimport type { ConversationAttachment } from '../conversation-types';\n\nfunction safeAttachmentUrl(value: string | undefined): string | undefined {\n  if (!value) return undefined;\n  try {\n    const url = new URL(value, document.baseURI);\n    return ['http:', 'https:', 'blob:'].includes(url.protocol) ? url.href : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n@Component({\n  tag: 'ds-attachment-list',\n  styleUrl: 'AttachmentList.css',\n  scoped: true,\n})\nexport class AttachmentList {\n  @Prop() items: ConversationAttachment[] = [];\n  @Prop() label: string = 'Attachments';\n\n  private renderItem(item: ConversationAttachment) {\n    const url = safeAttachmentUrl(item.url);\n    const content = (\n      <span class=\"attachment-list__item-content\">\n        <ds-icon name=\"Document\" size=\"sm\" color=\"secondary\" />\n        <span class=\"attachment-list__copy\">\n          <ds-text as=\"span\" variant=\"text-body-small\" emphasis color=\"primary\" lineTruncation={1}>{item.name}</ds-text>\n          {item.mediaType || item.size ? (\n            <ds-text as=\"span\" variant=\"text-caption\" color=\"secondary\">\n              {[item.mediaType, item.size].filter(Boolean).join(' · ')}\n            </ds-text>\n          ) : null}\n        </span>\n      </span>\n    );\n    return url ? (\n      <a class=\"attachment-list__item\" href={url} target=\"_blank\" rel=\"noopener noreferrer\">{content}</a>\n    ) : (\n      <div class=\"attachment-list__item\">{content}</div>\n    );\n  }\n\n  render() {\n    return (\n      <Host>\n        <div class=\"attachment-list\" role=\"list\" aria-label={this.label}>\n          {this.items.map(item => <div role=\"listitem\" key={item.id}>{this.renderItem(item)}</div>)}\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, h, Host, Prop } from '@stencil/core';\nimport { resolveSafeUrl } from '../../utils';\nimport type { ConversationAttachment } from '../conversation-types';\n\n@Component({\n  tag: 'ds-attachment-list',\n  styleUrl: 'AttachmentList.css',\n  scoped: true,\n})\nexport class AttachmentList {\n  @Prop() items: ConversationAttachment[] = [];\n  @Prop() label: string = 'Attachments';\n\n  private renderItem(item: ConversationAttachment) {\n    const url = resolveSafeUrl(item.url, {\n      protocols: ['http:', 'https:', 'blob:'],\n    });\n    const content = (\n      <span class=\"attachment-list__item-content\">\n        <ds-icon name=\"Document\" size=\"sm\" color=\"secondary\" />\n        <span class=\"attachment-list__copy\">\n          <ds-text as=\"span\" variant=\"text-body-small\" emphasis color=\"primary\" lineTruncation={1}>{item.name}</ds-text>\n          {item.mediaType || item.size ? (\n            <ds-text as=\"span\" variant=\"text-caption\" color=\"secondary\">\n              {[item.mediaType, item.size].filter(Boolean).join(' · ')}\n            </ds-text>\n          ) : null}\n        </span>\n      </span>\n    );\n    return url ? (\n      <a class=\"attachment-list__item\" href={url} target=\"_blank\" rel=\"noopener noreferrer\">{content}</a>\n    ) : (\n      <div class=\"attachment-list__item\">{content}</div>\n    );\n  }\n\n  render() {\n    return (\n      <Host>\n        <div class=\"attachment-list\" role=\"list\" aria-label={this.label}>\n          {this.items.map(item => <div role=\"listitem\" key={item.id}>{this.renderItem(item)}</div>)}\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]