@kerfjs/ui 5.0.0-beta.11 → 5.0.0-beta.110

package/dist/chunk-4RECPEHI.js

@@ -0,0 +1,67 @@
+import { createSheetHandle, wireSheetHandle } from './chunk-QPTJ5DOO.js';
+
+// src/components/surfaces/surface-scaffold/wiring/wire-overlay-sheets.ts
+var OVERLAY_SHEET_RESIZABLE_CLASS = "kui-overlay-sheet-resizable";
+var OVERLAY_SHEET_HANDLE_CLASS = "kui-overlay-sheet-handle";
+var OVERLAY_SHEET_HEIGHT_PROPERTY = "--_kui-overlay-sheet-height";
+var SHEET_SELECTOR = `.kerf-overlay.${OVERLAY_SHEET_RESIZABLE_CLASS}[data-presentation="bottom-sheet"]`;
+function wireOverlaySheets(container = document.body) {
+  const wired = /* @__PURE__ */ new Map();
+  const sync = () => {
+    for (const child of container.children) {
+      if (child instanceof HTMLElement && child.matches(SHEET_SELECTOR) && !wired.has(child))
+        wired.set(child, wireSheet(child));
+    }
+    for (const [wrapper, dispose] of wired) {
+      if (wrapper.parentNode === container) continue;
+      dispose();
+      wired.delete(wrapper);
+    }
+  };
+  const observer = new MutationObserver(sync);
+  observer.observe(container, { childList: true });
+  sync();
+  return () => {
+    observer.disconnect();
+    for (const dispose of wired.values()) dispose();
+    wired.clear();
+  };
+}
+function sheetOf(wrapper) {
+  if (wrapper.localName === "dialog") return wrapper;
+  const sheet = wrapper.firstElementChild;
+  return sheet instanceof HTMLElement ? sheet : null;
+}
+function wireSheet(wrapper) {
+  const handle = createSheetHandle({
+    class: OVERLAY_SHEET_HANDLE_CLASS,
+    "data-morph-preserve": ""
+  });
+  const place = () => {
+    const sheet = sheetOf(wrapper);
+    if (sheet !== null && sheet.firstChild !== handle)
+      sheet.insertBefore(handle, sheet.firstChild);
+  };
+  place();
+  const observer = new MutationObserver(place);
+  observer.observe(wrapper, { childList: true, subtree: true });
+  const unwire = wireSheetHandle(handle, {
+    // Input only reaches a connected grabber, which sits in the sheet.
+    get panel() {
+      return sheetOf(wrapper);
+    },
+    host: wrapper,
+    property: OVERLAY_SHEET_HEIGHT_PROPERTY,
+    enabled: () => !wrapper.inert
+  });
+  return () => {
+    observer.disconnect();
+    unwire();
+    handle.remove();
+    wrapper.style.removeProperty(OVERLAY_SHEET_HEIGHT_PROPERTY);
+  };
+}
+
+export { wireOverlaySheets };
+
+//# sourceMappingURL=chunk-4RECPEHI.js.map

package/dist/chunk-4RECPEHI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/surfaces/surface-scaffold/wiring/wire-overlay-sheets.ts"],"names":[],"mappings":"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","file":"chunk-4RECPEHI.js","sourcesContent":["import {\n  createSheetHandle,\n  wireSheetHandle,\n} from '../internal/sheet-handle.js';\n\n/**\n * The class that opts a core `kerfjs/overlay` bottom sheet into resizing:\n * pass it with the default wrapper class, as\n * `className: 'kerf-overlay kui-overlay-sheet-resizable'`.\n */\nexport const OVERLAY_SHEET_RESIZABLE_CLASS = 'kui-overlay-sheet-resizable';\n\n/** The grabber's class, styled by `@kerfjs/ui/overlay-sheet.css`. */\nexport const OVERLAY_SHEET_HANDLE_CLASS = 'kui-overlay-sheet-handle';\n\n/** The wrapper variable holding a resized sheet's visible height. */\nexport const OVERLAY_SHEET_HEIGHT_PROPERTY = '--_kui-overlay-sheet-height';\n\nconst SHEET_SELECTOR = `.kerf-overlay.${OVERLAY_SHEET_RESIZABLE_CLASS}[data-presentation=\"bottom-sheet\"]`;\n\n/**\n * Give every resizable core `kerfjs/overlay` bottom sheet opened in\n * `container` the resize grabber a `resizable` `DialogSurface` sheet has: a\n * `role=\"separator\"` at the sheet's top edge that resizes its visible height\n * by drag or keyboard (arrows, Page Up/Down, Home, End), between\n * `--kui-overlay-sheet-min-height` (160px) and the sheet's cap below the top\n * safe area. A sheet opts in with the `kui-overlay-sheet-resizable` class\n * (`overlay()` and the promise dialogs alike) and opens at its content\n * height each time.\n *\n * kerf appends each overlay to its `container` (`document.body` by\n * default), so call this once per container you open sheets in. The grabber\n * is `data-morph-preserve` and returns to the top of the sheet after each\n * re-render of the overlay's content. Requires\n * `@kerfjs/ui/overlay-sheet.css`. Returns a disposer that removes every\n * grabber and stops watching.\n */\nexport function wireOverlaySheets(\n  container: ParentNode = document.body,\n): () => void {\n  const wired = new Map<HTMLElement, () => void>();\n  const sync = (): void => {\n    for (const child of container.children) {\n      if (\n        child instanceof HTMLElement &&\n        child.matches(SHEET_SELECTOR) &&\n        !wired.has(child)\n      )\n        wired.set(child, wireSheet(child));\n    }\n    for (const [wrapper, dispose] of wired) {\n      if (wrapper.parentNode === container) continue;\n      dispose();\n      wired.delete(wrapper);\n    }\n  };\n  const observer = new MutationObserver(sync);\n  observer.observe(container, { childList: true });\n  sync();\n  return () => {\n    observer.disconnect();\n    for (const dispose of wired.values()) dispose();\n    wired.clear();\n  };\n}\n\n/**\n * The sheet is the native `<dialog>` itself, or the plain wrapper's content\n * root (the wrapper is the backdrop).\n */\nfunction sheetOf(wrapper: HTMLElement): HTMLElement | null {\n  if (wrapper.localName === 'dialog') return wrapper;\n  const sheet = wrapper.firstElementChild;\n  return sheet instanceof HTMLElement ? sheet : null;\n}\n\nfunction wireSheet(wrapper: HTMLElement): () => void {\n  const handle = createSheetHandle({\n    class: OVERLAY_SHEET_HANDLE_CLASS,\n    'data-morph-preserve': '',\n  });\n  // A re-render may move the preserved grabber behind the new content, or\n  // replace the content root that held it: keep it first in the sheet, so it\n  // is the sheet's first tab stop and sticks to its top edge.\n  const place = (): void => {\n    const sheet = sheetOf(wrapper);\n    if (sheet !== null && sheet.firstChild !== handle)\n      sheet.insertBefore(handle, sheet.firstChild);\n  };\n  place();\n  const observer = new MutationObserver(place);\n  observer.observe(wrapper, { childList: true, subtree: true });\n  const unwire = wireSheetHandle(handle, {\n    // Input only reaches a connected grabber, which sits in the sheet.\n    get panel() {\n      return sheetOf(wrapper)!;\n    },\n    host: wrapper,\n    property: OVERLAY_SHEET_HEIGHT_PROPERTY,\n    enabled: () => !wrapper.inert,\n  });\n  return () => {\n    observer.disconnect();\n    unwire();\n    handle.remove();\n    wrapper.style.removeProperty(OVERLAY_SHEET_HEIGHT_PROPERTY);\n  };\n}\n"]}

package/dist/chunk-4UB5Z3ZZ.js

@@ -0,0 +1,68 @@
+import { filterDataAttributes } from './chunk-KH4KEMSP.js';
+import { jsxs, jsx } from 'kerfjs/jsx-runtime';
+
+var summaryRowProtected = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-presentation",
+  "data-list-edge",
+  "data-rail",
+  "data-selected",
+  "data-dimmed"
+]);
+function SummaryRow({
+  title,
+  leading,
+  trailingMeta,
+  metadata,
+  presentation = "row",
+  titleLines,
+  rail,
+  selected = false,
+  dimmed = false,
+  listEdge,
+  deferRendering = false,
+  ariaLabel,
+  id,
+  className = "",
+  rootAttributes = {}
+}) {
+  if (titleLines !== void 0 && (!Number.isInteger(titleLines) || titleLines < 1))
+    throw new RangeError("SummaryRow titleLines must be a positive integer");
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...filterDataAttributes(rootAttributes, summaryRowProtected),
+      id,
+      class: `kui-summary-row ${className}`.trim(),
+      "data-component": "summary-row",
+      "data-presentation": presentation,
+      "data-list-edge": listEdge,
+      "data-rail": rail,
+      "data-selected": selected ? "true" : void 0,
+      "data-dimmed": dimmed ? "true" : void 0,
+      "data-defer": deferRendering ? "true" : void 0,
+      role: "option",
+      tabindex: "0",
+      "aria-selected": selected ? "true" : "false",
+      "aria-label": ariaLabel,
+      style: titleLines === void 0 ? void 0 : `--_kui-summary-row-title-lines:${titleLines}`,
+      children: [
+        rail && /* @__PURE__ */ jsx("span", { class: "kui-summary-row__rail", "aria-hidden": "true" }),
+        /* @__PURE__ */ jsxs("div", { class: "kui-summary-row__body", children: [
+          leading && /* @__PURE__ */ jsx("span", { class: "kui-summary-row__leading", children: leading }),
+          /* @__PURE__ */ jsxs("div", { class: "kui-summary-row__content", children: [
+            /* @__PURE__ */ jsxs("div", { class: "kui-summary-row__title", children: [
+              trailingMeta !== void 0 && /* @__PURE__ */ jsx("span", { class: "kui-summary-row__trailing", children: trailingMeta }),
+              title
+            ] }),
+            metadata && /* @__PURE__ */ jsx("div", { class: "kui-summary-row__metadata", children: metadata })
+          ] })
+        ] })
+      ]
+    }
+  );
+}
+
+export { SummaryRow };
+
+//# sourceMappingURL=chunk-4UB5Z3ZZ.js.map

package/dist/chunk-4UB5Z3ZZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/collections/summary-row/summary-row.tsx"],"names":[],"mappings":";;;AAWA,IAAM,mBAAA,uBAA0B,GAAA,CAAI;AAAA,EAClC,gBAAA;AAAA,EACA,mBAAA;AAAA,EACA,gBAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF,CAAC,CAAA;AAmDM,SAAS,UAAA,CAAW;AAAA,EACzB,KAAA;AAAA,EACA,OAAA;AAAA,EACA,YAAA;AAAA,EACA,QAAA;AAAA,EACA,YAAA,GAAe,KAAA;AAAA,EACf,UAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA,GAAW,KAAA;AAAA,EACX,MAAA,GAAS,KAAA;AAAA,EACT,QAAA;AAAA,EACA,cAAA,GAAiB,KAAA;AAAA,EACjB,SAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA,GAAY,EAAA;AAAA,EACZ,iBAAiB;AACnB,CAAA,EAAoB;AAClB,EAAA,IACE,eAAe,MAAA,KACd,CAAC,OAAO,SAAA,CAAU,UAAU,KAAK,UAAA,GAAa,CAAA,CAAA;AAE/C,IAAA,MAAM,IAAI,WAAW,kDAAkD,CAAA;AACzE,EAAA,uBACE,IAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACE,GAAG,oBAAA,CAAqB,cAAA,EAAgB,mBAAmB,CAAA;AAAA,MAC5D,EAAA;AAAA,MACA,KAAA,EAAO,CAAA,gBAAA,EAAmB,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MAC3C,gBAAA,EAAe,aAAA;AAAA,MACf,mBAAA,EAAmB,YAAA;AAAA,MACnB,gBAAA,EAAgB,QAAA;AAAA,MAChB,WAAA,EAAW,IAAA;AAAA,MACX,eAAA,EAAe,WAAW,MAAA,GAAS,MAAA;AAAA,MACnC,aAAA,EAAa,SAAS,MAAA,GAAS,MAAA;AAAA,MAC/B,YAAA,EAAY,iBAAiB,MAAA,GAAS,MAAA;AAAA,MACtC,IAAA,EAAK,QAAA;AAAA,MACL,QAAA,EAAS,GAAA;AAAA,MACT,eAAA,EAAe,WAAW,MAAA,GAAS,OAAA;AAAA,MACnC,YAAA,EAAY,SAAA;AAAA,MACZ,KAAA,EACE,UAAA,KAAe,MAAA,GACX,MAAA,GACA,kCAAkC,UAAU,CAAA,CAAA;AAAA,MAGjD,QAAA,EAAA;AAAA,QAAA,IAAA,oBAAQ,GAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAM,uBAAA,EAAwB,eAAY,MAAA,EAAO,CAAA;AAAA,wBAChE,IAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,uBAAA,EACR,QAAA,EAAA;AAAA,UAAA,OAAA,oBAAW,GAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAM,0BAAA,EAA4B,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,0BAC5D,IAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,0BAAA,EACT,QAAA,EAAA;AAAA,4BAAA,IAAA,CAAC,KAAA,EAAA,EAAI,OAAM,wBAAA,EACR,QAAA,EAAA;AAAA,cAAA,YAAA,KAAiB,MAAA,oBAChB,GAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAM,6BAA6B,QAAA,EAAA,YAAA,EAAa,CAAA;AAAA,cAEvD;AAAA,aAAA,EACH,CAAA;AAAA,YACC,QAAA,oBAAY,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,6BAA6B,QAAA,EAAA,QAAA,EAAS;AAAA,WAAA,EAChE;AAAA,SAAA,EACF;AAAA;AAAA;AAAA,GACF;AAEJ","file":"chunk-4UB5Z3ZZ.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\n\nimport type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport { filterDataAttributes } from '../../../shared/dom/extension-attributes.js';\nimport type { SemanticTone } from '../../../shared/styles/semantic-tone.js';\n\n/** `row` for a list section; `card` for a board column. */\nexport type SummaryRowPresentation = 'row' | 'card';\n/** A row's place in a rounded list section, so its corners match. */\nexport type SummaryRowListEdge = 'start' | 'end' | 'only';\n\nconst summaryRowProtected = new Set([\n  'data-component',\n  'data-presentation',\n  'data-list-edge',\n  'data-rail',\n  'data-selected',\n  'data-dimmed',\n]);\n\ntype SummaryRowRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-presentation'?: never;\n    'data-list-edge'?: never;\n    'data-rail'?: never;\n    'data-selected'?: never;\n    'data-dimmed'?: never;\n  }\n>;\n\nexport interface SummaryRowProps {\n  /** The identity line: an identifier, inline status glyphs, and the title. */\n  title: KerfUiContent;\n  /** Optional leading glyph, such as a category icon. */\n  leading?: SafeHtml;\n  /** Quiet text at the end of the title line, such as a relative time. */\n  trailingMeta?: string | SafeHtml;\n  /** A wrapping line of badges, chips, and quiet text below the title. */\n  metadata?: KerfUiContent;\n  /** `row` (default) or `card`. */\n  presentation?: SummaryRowPresentation;\n  /** Title lines before clipping; default 2 for a row and 4 for a card. */\n  titleLines?: number;\n  /** A leading state rail in a semantic tone (Up Next, blocked, …). */\n  rail?: SemanticTone;\n  /** Selected state, exposed as `aria-selected`. */\n  selected?: boolean;\n  /** Dim a finished or cut item; hover and selection restore it. */\n  dimmed?: boolean;\n  /** Round the corners that meet a rounded list section's edge. */\n  listEdge?: SummaryRowListEdge;\n  /** Skip rendering while off screen in long lists (`content-visibility`). */\n  deferRendering?: boolean;\n  /** Accessible name when the visible content is not a good one. */\n  ariaLabel?: string;\n  id?: string;\n  className?: string;\n  /** Safe `data-*` identity (an item id or delegated action) on the option. */\n  rootAttributes?: SummaryRowRootAttributes;\n}\n\n/**\n * A selectable, keyboard-focusable summary of one item, as a list row or a\n * board card: an optional leading glyph and state rail, a clamped identity line\n * with trailing quiet metadata, and a wrapping metadata line. It is a\n * `role=\"option\"`; place rows in a labeled `role=\"listbox\"` and own selection\n * and keyboard movement in the application.\n */\nexport function SummaryRow({\n  title,\n  leading,\n  trailingMeta,\n  metadata,\n  presentation = 'row',\n  titleLines,\n  rail,\n  selected = false,\n  dimmed = false,\n  listEdge,\n  deferRendering = false,\n  ariaLabel,\n  id,\n  className = '',\n  rootAttributes = {},\n}: SummaryRowProps) {\n  if (\n    titleLines !== undefined &&\n    (!Number.isInteger(titleLines) || titleLines < 1)\n  )\n    throw new RangeError('SummaryRow titleLines must be a positive integer');\n  return (\n    <div\n      {...filterDataAttributes(rootAttributes, summaryRowProtected)}\n      id={id}\n      class={`kui-summary-row ${className}`.trim()}\n      data-component=\"summary-row\"\n      data-presentation={presentation}\n      data-list-edge={listEdge}\n      data-rail={rail}\n      data-selected={selected ? 'true' : undefined}\n      data-dimmed={dimmed ? 'true' : undefined}\n      data-defer={deferRendering ? 'true' : undefined}\n      role=\"option\"\n      tabindex=\"0\"\n      aria-selected={selected ? 'true' : 'false'}\n      aria-label={ariaLabel}\n      style={\n        titleLines === undefined\n          ? undefined\n          : `--_kui-summary-row-title-lines:${titleLines}`\n      }\n    >\n      {rail && <span class=\"kui-summary-row__rail\" aria-hidden=\"true\" />}\n      <div class=\"kui-summary-row__body\">\n        {leading && <span class=\"kui-summary-row__leading\">{leading}</span>}\n        <div class=\"kui-summary-row__content\">\n          <div class=\"kui-summary-row__title\">\n            {trailingMeta !== undefined && (\n              <span class=\"kui-summary-row__trailing\">{trailingMeta}</span>\n            )}\n            {title}\n          </div>\n          {metadata && <div class=\"kui-summary-row__metadata\">{metadata}</div>}\n        </div>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/chunk-5J6Z4BWY.js

@@ -0,0 +1,141 @@
+import { LoadingSpinner } from './chunk-WVS6CUCT.js';
+import { isSafeHtml } from 'kerfjs';
+import { jsxs, jsx, Fragment } from 'kerfjs/jsx-runtime';
+
+var RELOCATE_ON_COLLAPSE = /* @__PURE__ */ Symbol.for(
+  "@kerfjs/ui.ToolbarControlGroup.relocateOnCollapse"
+);
+function markRelocatableGroup(group) {
+  Object.defineProperty(group, RELOCATE_ON_COLLAPSE, { value: true });
+  return group;
+}
+function isRelocatableGroup(value) {
+  return isSafeHtml(value) && value[RELOCATE_ON_COLLAPSE] === true;
+}
+function ToolbarActionLink({
+  href,
+  label,
+  icon,
+  detail,
+  ariaLabel,
+  external = false,
+  className = "",
+  slot
+}) {
+  const accessibleLabel = ariaLabel ?? `${label}${detail ? `, ${detail}` : ""}${external ? " (opens in new tab)" : ""}`;
+  return /* @__PURE__ */ jsxs(
+    "a",
+    {
+      class: `kui-toolbar-action-link ${className}`.trim(),
+      "data-component": "toolbar-action-link",
+      href,
+      target: external ? "_blank" : void 0,
+      rel: external ? "noopener noreferrer" : void 0,
+      "aria-label": accessibleLabel,
+      slot,
+      children: [
+        icon,
+        /* @__PURE__ */ jsx("span", { children: label }),
+        detail ? /* @__PURE__ */ jsx("code", { "aria-hidden": "true", children: detail }) : null
+      ]
+    }
+  );
+}
+function ToolbarControlGroup({
+  children,
+  label,
+  className = "",
+  expanded = false,
+  single = false,
+  appearance = "contained",
+  tone = "default",
+  material = "solid",
+  tileTone,
+  buttonAppearance = "plain",
+  shape = "pill",
+  size = "default",
+  density = "comfortable",
+  content = "icon",
+  focusRing = "control",
+  selectedChrome = "raised",
+  selectedTone = "brand",
+  nestedDropdown = false,
+  menuInset = "standard",
+  overflow = "visible",
+  expandedOverflow = "clip",
+  visibility = "always",
+  hideBelow,
+  showBelow,
+  sizing = "content",
+  placement = "start",
+  growBasis,
+  relocateOnCollapse = false,
+  scrim = false,
+  busy = false,
+  busyLabel = "Working",
+  avatarImage,
+  slot
+}) {
+  const inlineStyles = [
+    avatarImage ? `--kui-toolbar-avatar-image:url(${JSON.stringify(avatarImage)})` : "",
+    growBasis ? `--kui-toolbar-group-grow-basis:${growBasis}` : ""
+  ].filter(Boolean);
+  const group = /* @__PURE__ */ jsxs(
+    "div",
+    {
+      class: `kui-toolbar-control-group ${className}`.trim(),
+      "data-component": "toolbar-control-group",
+      role: label ? "group" : void 0,
+      "aria-label": label,
+      "data-appearance": appearance,
+      "data-tone": tone,
+      "data-material": material === "glass" ? "glass" : void 0,
+      "data-tile-tone": tileTone,
+      "data-button-appearance": buttonAppearance,
+      "data-expanded": String(expanded),
+      "data-single": String(single),
+      "data-shape": shape,
+      "data-size": size,
+      "data-density": density,
+      "data-content": content,
+      "data-focus-ring": focusRing,
+      "data-selected-chrome": selectedChrome,
+      "data-selected-tone": selectedTone,
+      "data-nested-dropdown": String(nestedDropdown),
+      "data-menu-inset": menuInset,
+      "data-overflow": overflow,
+      "data-expanded-overflow": expandedOverflow === "visible" ? "visible" : void 0,
+      "data-visibility": visibility,
+      "data-hide-below": hideBelow,
+      "data-show-below": showBelow,
+      "data-sizing": sizing,
+      "data-placement": placement,
+      "data-scrim": String(scrim),
+      "data-busy": String(busy),
+      "aria-busy": busy ? "true" : void 0,
+      inert: busy,
+      style: inlineStyles.length ? inlineStyles.join(";") : void 0,
+      slot,
+      children: [
+        children,
+        busy ? /* @__PURE__ */ jsx(
+          "span",
+          {
+            class: "kui-toolbar-control-group__busy-spinner",
+            "aria-hidden": "true",
+            children: /* @__PURE__ */ jsx(LoadingSpinner, {})
+          }
+        ) : null
+      ]
+    }
+  );
+  const renderedGroup = busy ? /* @__PURE__ */ jsxs(Fragment, { children: [
+    group,
+    /* @__PURE__ */ jsx("span", { class: "kui-toolbar-control-group__busy-status", role: "status", children: busyLabel })
+  ] }) : group;
+  return relocateOnCollapse ? markRelocatableGroup(renderedGroup) : renderedGroup;
+}
+
+export { ToolbarActionLink, ToolbarControlGroup, isRelocatableGroup };
+
+//# sourceMappingURL=chunk-5J6Z4BWY.js.map

package/dist/chunk-5J6Z4BWY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/panels/panel-toolbar-group.ts","../src/components/actions/toolbar-control-group/toolbar-control-group.tsx"],"names":[],"mappings":"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","file":"chunk-5J6Z4BWY.js","sourcesContent":["import { isSafeHtml, type SafeHtml } from 'kerfjs';\n\n// A render-time annotation, shared across separately bundled UI subpaths.\n// It never appears in the DOM or changes the group's visual treatment.\nconst RELOCATE_ON_COLLAPSE = Symbol.for(\n  '@kerfjs/ui.ToolbarControlGroup.relocateOnCollapse',\n);\n\nexport function markRelocatableGroup(group: SafeHtml): SafeHtml {\n  Object.defineProperty(group, RELOCATE_ON_COLLAPSE, { value: true });\n  return group;\n}\n\nexport function isRelocatableGroup(value: unknown): value is SafeHtml {\n  return (\n    isSafeHtml(value) &&\n    (value as SafeHtml & { [RELOCATE_ON_COLLAPSE]?: boolean })[\n      RELOCATE_ON_COLLAPSE\n    ] === true\n  );\n}\n","import type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport { markRelocatableGroup } from '../../../shared/panels/panel-toolbar-group.js';\nimport type { CssLength } from '../../../shared/styles/css-values.js';\nimport { LoadingSpinner } from '../../feedback/loading-spinner/loading-spinner.js';\n\nexport type ToolbarControlGroupAppearance = 'contained' | 'borderless';\nexport type ToolbarControlGroupTone = 'default' | 'dark';\n/** Surface material: the opaque `solid` fill (default) or translucent `glass`. */\nexport type ToolbarControlGroupMaterial = 'solid' | 'glass';\n/** Quiet palette for a contained, single decorative icon tile. */\nexport type ToolbarControlGroupTileTone =\n  'neutral' | 'brand' | 'success' | 'warning' | 'danger';\nexport type ToolbarControlGroupButtonAppearance = 'plain' | 'push';\nexport type ToolbarControlGroupShape = 'pill' | 'rounded';\nexport type ToolbarControlGroupSize = 'default' | 'compact';\nexport type ToolbarControlGroupDensity = 'comfortable' | 'tight';\nexport type ToolbarControlGroupContent =\n  'icon' | 'text' | 'mixed' | 'avatar' | 'search';\nexport type ToolbarControlGroupFocusRing = 'control' | 'outline' | 'halo';\nexport type ToolbarControlGroupSelectedChrome =\n  'raised' | 'filled' | 'outline' | 'none';\nexport type ToolbarControlGroupSelectedTone = 'brand' | 'neutral' | 'pop';\nexport type ToolbarControlGroupOverflow = 'visible' | 'scroll' | 'wrap';\nexport type ToolbarControlGroupExpandedOverflow = 'clip' | 'visible';\nexport type ToolbarControlGroupMenuInset = 'standard' | 'compact' | 'list-zero';\nexport type ToolbarControlGroupVisibility =\n  | 'always'\n  | 'compact-only'\n  | 'hide-collapsed-tiny'\n  | 'yield-to-expanded-sibling'\n  | 'yield-to-priority-row';\nexport type ToolbarControlGroupSizing = 'content' | 'grow' | 'fill';\nexport type ToolbarControlGroupPlacement = 'start' | 'end';\n\nexport interface ToolbarActionLinkProps {\n  href: string;\n  label: string;\n  icon?: KerfUiContent;\n  /** Optional machine-readable detail hidden visually but included in the default accessible name. */\n  detail?: string;\n  /** Override the accessible name when surrounding context is needed. */\n  ariaLabel?: string;\n  /** Open in a new tab with a safe rel and announce that behavior. */\n  external?: boolean;\n  className?: string;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/** A semantic anchor with ToolbarControlGroup-owned action geometry. */\nexport function ToolbarActionLink({\n  href,\n  label,\n  icon,\n  detail,\n  ariaLabel,\n  external = false,\n  className = '',\n  slot,\n}: ToolbarActionLinkProps) {\n  const accessibleLabel =\n    ariaLabel ??\n    `${label}${detail ? `, ${detail}` : ''}${external ? ' (opens in new tab)' : ''}`;\n  return (\n    <a\n      class={`kui-toolbar-action-link ${className}`.trim()}\n      data-component=\"toolbar-action-link\"\n      href={href}\n      target={external ? '_blank' : undefined}\n      rel={external ? 'noopener noreferrer' : undefined}\n      aria-label={accessibleLabel}\n      slot={slot}\n    >\n      {icon}\n      <span>{label}</span>\n      {detail ? <code aria-hidden=\"true\">{detail}</code> : null}\n    </a>\n  );\n}\n\nexport interface ToolbarControlGroupProps {\n  children: KerfUiContent;\n  label?: string;\n  className?: string;\n  expanded?: boolean;\n  single?: boolean;\n  appearance?: ToolbarControlGroupAppearance;\n  tone?: ToolbarControlGroupTone;\n  /**\n   * `glass` paints the group on the translucent chrome material (backdrop\n   * blur and saturation) with a specular edge and a soft shadow, for a group\n   * floating over imagery or a clear toolbar. Controls take the normal text\n   * color so they keep AA over any content; the fill turns opaque under\n   * reduced transparency, increased contrast, static effects, or without\n   * backdrop-filter support. A borderless group has no surface and ignores it.\n   */\n  material?: ToolbarControlGroupMaterial;\n  /** Quiet fill, matching border and foreground for a contained single group whose only child is a decorative SVG. Ignored for interactive or mixed content. */\n  tileTone?: ToolbarControlGroupTileTone;\n  buttonAppearance?: ToolbarControlGroupButtonAppearance;\n  /** Corner shape: fully round `pill` (default) or a softer `rounded` rectangle. */\n  shape?: ToolbarControlGroupShape;\n  size?: ToolbarControlGroupSize;\n  density?: ToolbarControlGroupDensity;\n  content?: ToolbarControlGroupContent;\n  /** Whether controls paint focus individually or the group paints an outline/halo on focus-within. */\n  focusRing?: ToolbarControlGroupFocusRing;\n  /**\n   * Chrome a pressed (`aria-pressed=\"true\"`) control paints. `none` keeps a\n   * pressed control looking like its neighbors, for an icon-state toggle whose\n   * glyph already shows the state (an empty or filled star); hover and the\n   * focus ring are unchanged. One control can opt out alone with\n   * `data-selected-chrome=\"none\"` on its own button.\n   */\n  selectedChrome?: ToolbarControlGroupSelectedChrome;\n  selectedTone?: ToolbarControlGroupSelectedTone;\n  /** Size a nested Web Awesome dropdown trigger as part of this group. */\n  nestedDropdown?: boolean;\n  /** Configure the nested dropdown menu inset without consumer ::part() CSS. */\n  menuInset?: ToolbarControlGroupMenuInset;\n  /** Keep an overlong row inside the available width by scrolling or wrapping. */\n  overflow?: ToolbarControlGroupOverflow;\n  /** Let app-owned anchored surfaces extend outside an expanded search group. Collapsed searches retain their clipping. */\n  expandedOverflow?: ToolbarControlGroupExpandedOverflow;\n  /**\n   * Responsive visibility owned by the enclosing Toolbar container.\n   * `yield-to-priority-row` hides this trailing group exactly while its\n   * Toolbar's `responsive=\"trailing-priority\"` row is active (an expanded\n   * trailing sibling at the Toolbar's `responsiveAt` width), so the app never\n   * restates that breakpoint with `hideBelow`.\n   */\n  visibility?: ToolbarControlGroupVisibility;\n  /** Hide below this Toolbar content width; requires wireToolbarVisibility. */\n  hideBelow?: CssLength;\n  /** Show only below this Toolbar content width; requires wireToolbarVisibility. */\n  showBelow?: CssLength;\n  /** Intrinsic (default), grow from a basis, or occupy a full wrapping row. */\n  sizing?: ToolbarControlGroupSizing;\n  /** Place this group at the end of its flex row in a wrapping Toolbar zone. */\n  placement?: ToolbarControlGroupPlacement;\n  /** CSS length used as the minimum width and flex basis for `sizing=\"grow\"`; defaults to 19rem. */\n  growBasis?: string;\n  /** Move this group into the work-area toolbar when its panel collapses. */\n  relocateOnCollapse?: boolean;\n  /** Add contrast behind photo-backed avatar content. */\n  scrim?: boolean;\n  /** Block the group's controls and show a spinner without changing its dimensions. */\n  busy?: boolean;\n  /** Announced status while busy; defaults to “Working”. */\n  busyLabel?: string;\n  /**\n   * Avatar image URL. A single-control group paints it on the group; a\n   * multi-control group paints it only on the pressed selection highlight.\n   */\n  avatarImage?: string;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\nexport function ToolbarControlGroup({\n  children,\n  label,\n  className = '',\n  expanded = false,\n  single = false,\n  appearance = 'contained',\n  tone = 'default',\n  material = 'solid',\n  tileTone,\n  buttonAppearance = 'plain',\n  shape = 'pill',\n  size = 'default',\n  density = 'comfortable',\n  content = 'icon',\n  focusRing = 'control',\n  selectedChrome = 'raised',\n  selectedTone = 'brand',\n  nestedDropdown = false,\n  menuInset = 'standard',\n  overflow = 'visible',\n  expandedOverflow = 'clip',\n  visibility = 'always',\n  hideBelow,\n  showBelow,\n  sizing = 'content',\n  placement = 'start',\n  growBasis,\n  relocateOnCollapse = false,\n  scrim = false,\n  busy = false,\n  busyLabel = 'Working',\n  avatarImage,\n  slot,\n}: ToolbarControlGroupProps) {\n  const inlineStyles = [\n    avatarImage\n      ? `--kui-toolbar-avatar-image:url(${JSON.stringify(avatarImage)})`\n      : '',\n    growBasis ? `--kui-toolbar-group-grow-basis:${growBasis}` : '',\n  ].filter(Boolean);\n  const group = (\n    <div\n      class={`kui-toolbar-control-group ${className}`.trim()}\n      data-component=\"toolbar-control-group\"\n      role={label ? 'group' : undefined}\n      aria-label={label}\n      data-appearance={appearance}\n      data-tone={tone}\n      data-material={material === 'glass' ? 'glass' : undefined}\n      data-tile-tone={tileTone}\n      data-button-appearance={buttonAppearance}\n      data-expanded={String(expanded)}\n      data-single={String(single)}\n      data-shape={shape}\n      data-size={size}\n      data-density={density}\n      data-content={content}\n      data-focus-ring={focusRing}\n      data-selected-chrome={selectedChrome}\n      data-selected-tone={selectedTone}\n      data-nested-dropdown={String(nestedDropdown)}\n      data-menu-inset={menuInset}\n      data-overflow={overflow}\n      data-expanded-overflow={\n        expandedOverflow === 'visible' ? 'visible' : undefined\n      }\n      data-visibility={visibility}\n      data-hide-below={hideBelow}\n      data-show-below={showBelow}\n      data-sizing={sizing}\n      data-placement={placement}\n      data-scrim={String(scrim)}\n      data-busy={String(busy)}\n      aria-busy={busy ? 'true' : undefined}\n      inert={busy}\n      style={inlineStyles.length ? inlineStyles.join(';') : undefined}\n      slot={slot}\n    >\n      {children}\n      {busy ? (\n        <span\n          class=\"kui-toolbar-control-group__busy-spinner\"\n          aria-hidden=\"true\"\n        >\n          <LoadingSpinner />\n        </span>\n      ) : null}\n    </div>\n  );\n  const renderedGroup = busy ? (\n    <>\n      {group}\n      <span class=\"kui-toolbar-control-group__busy-status\" role=\"status\">\n        {busyLabel}\n      </span>\n    </>\n  ) : (\n    group\n  );\n  return relocateOnCollapse\n    ? markRelocatableGroup(renderedGroup)\n    : renderedGroup;\n}\n"]}

package/dist/chunk-5USKCWGL.js

@@ -0,0 +1,113 @@
+import { filterDataAttributes } from './chunk-KH4KEMSP.js';
+import { jsx } from 'kerfjs/jsx-runtime';
+
+function roleForSelectionMode(mode) {
+  switch (mode) {
+    case "single":
+      return "option";
+    case "multiple":
+      return "row";
+    case "none":
+    case "toggle":
+      return "button";
+  }
+}
+var contentItemProtectedAttributes = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-appearance",
+  "data-outlined",
+  "data-bubble",
+  "data-grid-row"
+]);
+var interactiveProtectedAttributes = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-appearance",
+  "data-outlined",
+  "data-bubble",
+  "data-grid-row",
+  "data-action",
+  "data-item-id",
+  "data-interactive",
+  "data-selected",
+  "data-disabled",
+  "data-selection-mode",
+  "data-kui-pressed"
+]);
+function ContentItem({
+  appearance = "transparent",
+  children,
+  frame = "none",
+  flush = false,
+  shape = "rounded",
+  bubble,
+  title,
+  ariaLabel,
+  focusTarget = false,
+  outlined = false,
+  tabIndex,
+  gridRow = false,
+  interactive = false,
+  action,
+  itemId,
+  selectionMode = "none",
+  selected = false,
+  disabled = false,
+  className = "",
+  rootAttributes = {},
+  slot
+}) {
+  const safeRootAttributes = filterDataAttributes(
+    rootAttributes,
+    interactive ? interactiveProtectedAttributes : contentItemProtectedAttributes
+  );
+  if (interactive && !action) {
+    throw new Error("Interactive ContentItem requires an action");
+  }
+  if (interactive && selected && selectionMode === "none") {
+    throw new Error("Selected ContentItem requires a selectionMode");
+  }
+  const cls = [
+    "kui-content-item",
+    shape === "pill" ? "kui-content-item--pill" : "",
+    frame === "framed" ? "kui-content-item--framed" : "",
+    flush ? "kui-content-item--flush" : "",
+    className
+  ].filter(Boolean).join(" ");
+  const interactiveAttributes = interactive ? {
+    "data-interactive": "true",
+    "data-action": disabled ? void 0 : action,
+    "data-item-id": itemId,
+    "data-selection-mode": selectionMode,
+    "data-selected": selectionMode === "none" ? void 0 : String(selected),
+    "data-disabled": disabled ? "true" : void 0
+  } : {};
+  let role = ariaLabel ? "region" : void 0;
+  if (interactive) role = roleForSelectionMode(selectionMode);
+  else if (gridRow) role = "row";
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...safeRootAttributes,
+      ...interactiveAttributes,
+      class: cls,
+      title,
+      "data-component": "content-item",
+      "data-appearance": appearance,
+      "data-outlined": outlined ? "true" : void 0,
+      "data-bubble": bubble,
+      "data-grid-row": !interactive && gridRow ? "true" : void 0,
+      role,
+      "aria-label": ariaLabel,
+      "aria-selected": interactive && (selectionMode === "single" || selectionMode === "multiple") ? String(selected) : void 0,
+      "aria-pressed": interactive && selectionMode === "toggle" ? String(selected) : void 0,
+      "aria-disabled": interactive && disabled ? "true" : void 0,
+      tabindex: interactive ? disabled ? "-1" : "0" : tabIndex ?? (focusTarget ? "-1" : void 0),
+      slot,
+      children: interactive && selectionMode === "multiple" || !interactive && gridRow ? /* @__PURE__ */ jsx("div", { role: "gridcell", children }) : children
+    }
+  );
+}
+
+export { ContentItem };
+
+//# sourceMappingURL=chunk-5USKCWGL.js.map

package/dist/chunk-5USKCWGL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/surfaces/content-item/content-item.tsx"],"names":[],"mappings":"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","file":"chunk-5USKCWGL.js","sourcesContent":["import type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport { filterDataAttributes } from '../../../shared/dom/extension-attributes.js';\nimport type { SemanticTone } from '../../../shared/styles/semantic-tone.js';\n\nexport type { SemanticTone } from '../../../shared/styles/semantic-tone.js';\n\n/**\n * Base surface treatment, semantic status colors, or `brand-loud`: the solid\n * brand fill with its on-loud foreground (a transcript's own messages).\n */\nexport type ContentItemAppearance =\n  'transparent' | 'surface' | 'brand-loud' | SemanticTone;\n\n/**\n * A chat-bubble layout for transcripts: the item fits its content up to 80%\n * of the row and sits at the `start` (other participants) or `end` (the\n * person's own messages) of the line.\n */\nexport type ContentItemBubble = 'start' | 'end';\n\n/** Whether the item's always-reserved 1px border is transparent or visible. */\nexport type ContentItemFrame = 'none' | 'framed';\n\n/** Corner shape: the 12px rounded rectangle or the 22px pill. */\nexport type ContentItemShape = 'rounded' | 'pill';\n/** `single` uses an option; `multiple` uses a grid row; `toggle` uses a pressed button. */\nexport type ContentItemSelectionMode =\n  'none' | 'single' | 'multiple' | 'toggle';\n\nfunction roleForSelectionMode(\n  mode: ContentItemSelectionMode,\n): 'option' | 'row' | 'button' {\n  switch (mode) {\n    case 'single':\n      return 'option';\n    case 'multiple':\n      return 'row';\n    case 'none':\n    case 'toggle':\n      return 'button';\n  }\n}\n\nconst contentItemProtectedAttributes = new Set([\n  'data-component',\n  'data-appearance',\n  'data-outlined',\n  'data-bubble',\n  'data-grid-row',\n]);\nconst interactiveProtectedAttributes = new Set([\n  'data-component',\n  'data-appearance',\n  'data-outlined',\n  'data-bubble',\n  'data-grid-row',\n  'data-action',\n  'data-item-id',\n  'data-interactive',\n  'data-selected',\n  'data-disabled',\n  'data-selection-mode',\n  'data-kui-pressed',\n]);\n\ntype ContentItemRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-appearance'?: never;\n    'data-outlined'?: never;\n    'data-bubble'?: never;\n    'data-grid-row'?: never;\n  }\n>;\n\ntype ContentItemInteractiveRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-appearance'?: never;\n    'data-outlined'?: never;\n    'data-bubble'?: never;\n    'data-grid-row'?: never;\n    'data-action'?: never;\n    'data-item-id'?: never;\n    'data-interactive'?: never;\n    'data-selected'?: never;\n    'data-disabled'?: never;\n    'data-selection-mode'?: never;\n    'data-kui-pressed'?: never;\n  }\n>;\n\ninterface ContentItemBaseProps {\n  /**\n   * Coordinated background, border, and foreground colors. `transparent`\n   * preserves the surrounding surface; `surface` paints the base surface;\n   * semantic values match StateBanner. Defaults to `transparent`.\n   */\n  appearance?: ContentItemAppearance;\n  /** Item content; a plain string is allowed for bare copy. */\n  children?: KerfUiContent | string;\n  /**\n   * `framed` paints the standard neutral border in the 1px the item always\n   * reserves, so framing never changes geometry. Frame only an item that\n   * marks a real distinction. Defaults to `none` (transparent border).\n   */\n  frame?: ContentItemFrame;\n  /** Remove block padding and block borders while retaining inline geometry. */\n  flush?: boolean;\n  /** Corner shape. Defaults to `rounded`. */\n  shape?: ContentItemShape;\n  /**\n   * Lay the item out as a chat bubble: content width up to 80% of the row,\n   * at the `start` or `end` of the line. Pair `end` with `brand-loud` for the\n   * person's own messages. Omit for an ordinary full-width item.\n   */\n  bubble?: ContentItemBubble;\n  /** Native hover tooltip. */\n  title?: string;\n  /**\n   * Names the item as a distinct region (`role=\"region\"`). Omit it for an\n   * ordinary item, which stays a non-landmark grouping.\n   */\n  ariaLabel?: string;\n  /**\n   * Makes the item a programmatic focus target (`tabindex=\"-1\"`, never a tab\n   * stop), for example the preferred initial focus of a NavStack view when\n   * combined with `data-nav-focus` in `rootAttributes`.\n   */\n  focusTarget?: boolean;\n  /** Keep the standard focus outline visible, such as for a drop target. */\n  outlined?: boolean;\n  className?: string;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\nexport type ContentItemProps = ContentItemBaseProps &\n  (\n    | {\n        interactive?: false;\n        action?: never;\n        itemId?: never;\n        selectionMode?: never;\n        selected?: never;\n        disabled?: never;\n        /** Opt into keyboard (`0`) or programmatic (`-1`) focus. */\n        tabIndex?: 0 | -1;\n        /**\n         * A non-selectable row of a multi-select `List` or `Grid`: renders\n         * `role=\"row\"` around a `gridcell`, with no `aria-selected` and no\n         * Tab stop of its own, for content between selectable rows (an\n         * activity group, a \"messages skipped\" divider). Its controls stay\n         * reachable by Tab; arrow keys skip it.\n         */\n        gridRow?: boolean;\n        /** Existing static `data-*` metadata remains available. */\n        rootAttributes?: ContentItemRootAttributes;\n      }\n    | {\n        /** Enable a keyboard reachable card; wire `wireContentItems` once on its containing root. */\n        interactive: true;\n        /** Delegated action dispatched by pointer, Enter, or Space. */\n        action: string;\n        itemId?: string;\n        selectionMode?: ContentItemSelectionMode;\n        selected?: boolean;\n        disabled?: boolean;\n        tabIndex?: never;\n        /** An interactive item is already a row in a multi-select grid. */\n        gridRow?: never;\n        /** Safe app metadata; interaction attributes are component-owned. */\n        rootAttributes?: ContentItemInteractiveRootAttributes;\n      }\n  );\n\n/**\n * One self-contained `.kui-content` child: an 8px inline margin, a real 1px\n * border (transparent unless `framed`), 8px padding, and a rounded or pill\n * radius. It owns that whole geometry, so wrappers must not add more.\n */\nexport function ContentItem({\n  appearance = 'transparent',\n  children,\n  frame = 'none',\n  flush = false,\n  shape = 'rounded',\n  bubble,\n  title,\n  ariaLabel,\n  focusTarget = false,\n  outlined = false,\n  tabIndex,\n  gridRow = false,\n  interactive = false,\n  action,\n  itemId,\n  selectionMode = 'none',\n  selected = false,\n  disabled = false,\n  className = '',\n  rootAttributes = {},\n  slot,\n}: ContentItemProps) {\n  const safeRootAttributes = filterDataAttributes(\n    rootAttributes,\n    interactive\n      ? interactiveProtectedAttributes\n      : contentItemProtectedAttributes,\n  );\n  if (interactive && !action) {\n    throw new Error('Interactive ContentItem requires an action');\n  }\n  if (interactive && selected && selectionMode === 'none') {\n    throw new Error('Selected ContentItem requires a selectionMode');\n  }\n  const cls = [\n    'kui-content-item',\n    shape === 'pill' ? 'kui-content-item--pill' : '',\n    frame === 'framed' ? 'kui-content-item--framed' : '',\n    flush ? 'kui-content-item--flush' : '',\n    className,\n  ]\n    .filter(Boolean)\n    .join(' ');\n  const interactiveAttributes = interactive\n    ? {\n        'data-interactive': 'true',\n        'data-action': disabled ? undefined : action,\n        'data-item-id': itemId,\n        'data-selection-mode': selectionMode,\n        'data-selected':\n          selectionMode === 'none' ? undefined : String(selected),\n        'data-disabled': disabled ? 'true' : undefined,\n      }\n    : {};\n  let role: 'option' | 'row' | 'button' | 'region' | undefined = ariaLabel\n    ? 'region'\n    : undefined;\n  if (interactive) role = roleForSelectionMode(selectionMode);\n  else if (gridRow) role = 'row';\n  return (\n    <div\n      {...safeRootAttributes}\n      {...interactiveAttributes}\n      class={cls}\n      title={title}\n      data-component=\"content-item\"\n      data-appearance={appearance}\n      data-outlined={outlined ? 'true' : undefined}\n      data-bubble={bubble}\n      data-grid-row={!interactive && gridRow ? 'true' : undefined}\n      role={role}\n      aria-label={ariaLabel}\n      aria-selected={\n        interactive &&\n        (selectionMode === 'single' || selectionMode === 'multiple')\n          ? String(selected)\n          : undefined\n      }\n      aria-pressed={\n        interactive && selectionMode === 'toggle' ? String(selected) : undefined\n      }\n      aria-disabled={interactive && disabled ? 'true' : undefined}\n      tabindex={\n        interactive\n          ? disabled\n            ? '-1'\n            : '0'\n          : (tabIndex ?? (focusTarget ? '-1' : undefined))\n      }\n      slot={slot}\n    >\n      {(interactive && selectionMode === 'multiple') ||\n      (!interactive && gridRow) ? (\n        <div role=\"gridcell\">{children}</div>\n      ) : (\n        children\n      )}\n    </div>\n  );\n}\n"]}

package/dist/chunk-6C6DLP3W.js

@@ -0,0 +1,31 @@
+// src/catalog/ux-review.ts
+var UX_REVIEW_PROJECT_PATH = "__ux-review/project.json";
+function uxReviewCaptureUrl({
+  projectDirectory,
+  title,
+  context
+}) {
+  const url = new URL("uxreview://capture");
+  url.searchParams.set("kind", "screenshot");
+  url.searchParams.set("target", "region");
+  url.searchParams.set("project", projectDirectory);
+  url.searchParams.set("title", title);
+  url.searchParams.set("context", context);
+  return url.href;
+}
+var ABSOLUTE_PATH = /^(?:\/|[A-Za-z]:[\\/])/;
+async function loadUxReviewProject(pageUrl, fetchImpl = globalThis.fetch) {
+  try {
+    const response = await fetchImpl(new URL(UX_REVIEW_PROJECT_PATH, pageUrl));
+    if (!response.ok) return null;
+    const data = await response.json();
+    const directory = typeof data === "object" && data !== null && "projectDirectory" in data ? data.projectDirectory : void 0;
+    return typeof directory === "string" && ABSOLUTE_PATH.test(directory) ? directory : null;
+  } catch {
+    return null;
+  }
+}
+
+export { UX_REVIEW_PROJECT_PATH, loadUxReviewProject, uxReviewCaptureUrl };
+
+//# sourceMappingURL=chunk-6C6DLP3W.js.map

package/dist/chunk-6C6DLP3W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog/ux-review.ts"],"names":[],"mappings":";AAQO,IAAM,sBAAA,GAAyB;AAa/B,SAAS,kBAAA,CAAmB;AAAA,EACjC,gBAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAA,EAA4B;AAC1B,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,oBAAoB,CAAA;AACxC,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,MAAA,EAAQ,YAAY,CAAA;AACzC,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,QAAQ,CAAA;AACvC,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,gBAAgB,CAAA;AAChD,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,OAAA,EAAS,KAAK,CAAA;AACnC,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,OAAO,CAAA;AACvC,EAAA,OAAO,GAAA,CAAI,IAAA;AACb;AAGA,IAAM,aAAA,GAAgB,wBAAA;AAOtB,eAAsB,mBAAA,CACpB,OAAA,EACA,SAAA,GAAqC,UAAA,CAAW,KAAA,EACxB;AACxB,EAAA,IAAI;AACF,IAAA,MAAM,WAAW,MAAM,SAAA,CAAU,IAAI,GAAA,CAAI,sBAAA,EAAwB,OAAO,CAAC,CAAA;AACzE,IAAA,IAAI,CAAC,QAAA,CAAS,EAAA,EAAI,OAAO,IAAA;AACzB,IAAA,MAAM,IAAA,GAAgB,MAAM,QAAA,CAAS,IAAA,EAAK;AAC1C,IAAA,MAAM,SAAA,GACJ,OAAO,IAAA,KAAS,QAAA,IAAY,SAAS,IAAA,IAAQ,kBAAA,IAAsB,IAAA,GAC/D,IAAA,CAAK,gBAAA,GACL,KAAA,CAAA;AACN,IAAA,OAAO,OAAO,SAAA,KAAc,QAAA,IAAY,cAAc,IAAA,CAAK,SAAS,IAChE,SAAA,GACA,IAAA;AAAA,EACN,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF","file":"chunk-6C6DLP3W.js","sourcesContent":["/**\n * Browser helpers for UX Review region captures from a catalog. The local\n * project directory comes from `uxReviewPlugin` (`@kerfjs/ui/vite-ux-review`),\n * which serves it to the catalog page on a Vite dev or preview server; static\n * hosting has no such endpoint, so a catalog there shows no capture link.\n */\n\n/** Where `uxReviewPlugin` serves `{ projectDirectory }`, relative to the catalog page. */\nexport const UX_REVIEW_PROJECT_PATH = '__ux-review/project.json';\n\n/** What a UX Review region capture is preset with. */\nexport interface UxReviewCapture {\n  /** The absolute project directory UX Review files the review under. */\n  projectDirectory: string;\n  /** The review title. */\n  title: string;\n  /** Review context: what was selected and where. */\n  context: string;\n}\n\n/** A `uxreview://capture` link that starts a region screenshot for a project. */\nexport function uxReviewCaptureUrl({\n  projectDirectory,\n  title,\n  context,\n}: UxReviewCapture): string {\n  const url = new URL('uxreview://capture');\n  url.searchParams.set('kind', 'screenshot');\n  url.searchParams.set('target', 'region');\n  url.searchParams.set('project', projectDirectory);\n  url.searchParams.set('title', title);\n  url.searchParams.set('context', context);\n  return url.href;\n}\n\n/** POSIX (`/…`) or Windows drive (`C:\\…`, `C:/…`) absolute path. */\nconst ABSOLUTE_PATH = /^(?:\\/|[A-Za-z]:[\\\\/])/;\n\n/**\n * Ask the server that served `pageUrl` for its UX Review project directory.\n * Resolves `null` when there is none (static hosting, a server without the\n * plugin, a malformed answer, or a network failure); never rejects.\n */\nexport async function loadUxReviewProject(\n  pageUrl: string | URL,\n  fetchImpl: typeof globalThis.fetch = globalThis.fetch,\n): Promise<string | null> {\n  try {\n    const response = await fetchImpl(new URL(UX_REVIEW_PROJECT_PATH, pageUrl));\n    if (!response.ok) return null;\n    const data: unknown = await response.json();\n    const directory =\n      typeof data === 'object' && data !== null && 'projectDirectory' in data\n        ? data.projectDirectory\n        : undefined;\n    return typeof directory === 'string' && ABSOLUTE_PATH.test(directory)\n      ? directory\n      : null;\n  } catch {\n    return null;\n  }\n}\n"]}