@kerfjs/ui 5.0.0-beta.8 → 5.0.0-beta.81

package/dist/chunk-NVKRZ5DI.js

@@ -0,0 +1,222 @@
+import { Skeleton } from './chunk-EFDCALR3.js';
+import { Badge } from './chunk-J3AWE5I4.js';
+import { LucideIcon } from './chunk-PQQQXJGV.js';
+import { em } from './chunk-LRAIS3YB.js';
+import { jsxs, jsx, Fragment } from 'kerfjs/jsx-runtime';
+
+function SelectChevron() {
+  return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 448 512", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M201.4 406.6c12.5 12.5 32.8 12.5 45.3 0l192-192c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0L224 338.7 54.6 169.4c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3l192 192z" }) });
+}
+function Select(props) {
+  const {
+    name,
+    label,
+    ariaLabel,
+    choices,
+    className = "",
+    placeholderText,
+    hint,
+    disabled = false,
+    fitMenu = false,
+    placeholder = false,
+    presentation = "form",
+    size = "default",
+    triggerWidth,
+    caret = true,
+    focusRingOwner = "select",
+    focusRingInset = false,
+    labelMaxWidth,
+    slot
+  } = props;
+  const multiple = props.multiple === true;
+  const values = props.multiple ? props.value : [props.value];
+  const renderSelected = props.multiple ? void 0 : props.renderSelected;
+  const selectedPresentation = props.selectedPresentation ?? "label";
+  const iconTrigger = props.multiple && props.selectedPresentation === "icon-only";
+  const triggerIcon = iconTrigger ? props.triggerIcon : void 0;
+  if (placeholder) {
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        class: `kui-select kui-select--placeholder ${className}`.trim(),
+        "data-component": "select",
+        "data-placeholder": "true",
+        "data-presentation": presentation,
+        "data-size": size,
+        "data-trigger-width": triggerWidth,
+        "data-caret": caret ? void 0 : "false",
+        "data-selected-presentation": selectedPresentation,
+        "data-focus-ring-owner": focusRingOwner,
+        "data-focus-ring-inset": focusRingInset ? "true" : void 0,
+        "aria-busy": "true",
+        style: labelMaxWidth === void 0 ? void 0 : `--kui-select-label-max-width:${labelMaxWidth}px`,
+        slot,
+        children: [
+          label && /* @__PURE__ */ jsx("span", { class: "kui-select__placeholder-label", children: label }),
+          /* @__PURE__ */ jsxs(
+            "span",
+            {
+              class: "kui-select__placeholder-box",
+              "aria-label": ariaLabel,
+              role: "img",
+              children: [
+                /* @__PURE__ */ jsx(Skeleton, { width: em(10) }),
+                /* @__PURE__ */ jsx("span", { class: "kui-select__placeholder-chevron", "aria-hidden": "true", children: /* @__PURE__ */ jsx(SelectChevron, {}) })
+              ]
+            }
+          ),
+          hint && /* @__PURE__ */ jsx("span", { class: "kui-select__placeholder-hint", children: hint })
+        ]
+      }
+    );
+  }
+  const selected = multiple ? void 0 : choices.find((choice) => choice.value === values[0] && !choice.disabled);
+  const chosenCount = iconTrigger ? choices.filter(
+    (choice) => !choice.disabled && values.includes(choice.value)
+  ).length : 0;
+  const icon = (choice, selectedIcon = false) => /* @__PURE__ */ jsx(
+    "span",
+    {
+      "data-key": `${name}:${choice.value}:${selectedIcon ? "selected" : "option"}`,
+      "data-morph-skip": true,
+      slot: "start",
+      class: `kui-select__icon${selectedIcon ? " kui-select__icon--selected" : ""}`,
+      style: choice.color ? `color:${choice.color}` : void 0,
+      children: choice.icon ? /* @__PURE__ */ jsx(
+        LucideIcon,
+        {
+          icon: choice.icon,
+          name: choice.iconName ?? choice.label.toLowerCase().replaceAll(" ", "-")
+        }
+      ) : null
+    }
+  );
+  const option = (choice, index) => /* @__PURE__ */ jsxs(Fragment, { children: [
+    choice.separatorBefore && index > 0 && /* @__PURE__ */ jsx(
+      "wa-divider",
+      {
+        orientation: "horizontal",
+        role: "separator",
+        "aria-orientation": "horizontal"
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      "wa-option",
+      {
+        value: choice.value,
+        selected: multiple && !choice.disabled && values.includes(choice.value),
+        disabled: choice.disabled,
+        title: choice.disabled ? choice.disabledReason : void 0,
+        children: [
+          choice.icon ? icon(choice) : null,
+          choice.label
+        ]
+      }
+    )
+  ] });
+  const groups = [
+    ...new Set(
+      choices.map((choice) => choice.group).filter((group) => Boolean(group))
+    )
+  ];
+  const ungrouped = choices.filter((choice) => !choice.group);
+  return /* @__PURE__ */ jsxs(
+    "wa-select",
+    {
+      size: "m",
+      appearance: "outlined",
+      placement: "bottom",
+      class: `kui-select${renderSelected ? " kui-select--custom-selected" : ""}${fitMenu ? " kui-select--fit-menu" : ""}${!label ? " kui-select--label-hidden" : ""} ${className}`.trim(),
+      "data-component": "select",
+      "data-presentation": presentation,
+      "data-size": size,
+      "data-trigger-width": triggerWidth,
+      "data-caret": caret ? void 0 : "false",
+      "data-selected-presentation": selectedPresentation,
+      "data-focus-ring-owner": focusRingOwner,
+      "data-focus-ring-inset": focusRingInset ? "true" : void 0,
+      name,
+      label: label || ariaLabel,
+      "aria-label": ariaLabel,
+      multiple,
+      value: multiple ? void 0 : values[0],
+      placeholder: placeholderText,
+      hint,
+      disabled,
+      style: labelMaxWidth === void 0 ? void 0 : `--kui-select-label-max-width:${labelMaxWidth}px`,
+      slot,
+      children: [
+        iconTrigger && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsxs("span", { slot: "label", "data-key": `${name}:trigger-label`, children: [
+            label || ariaLabel,
+            /* @__PURE__ */ jsx("span", { class: "kui-select__name-summary", "data-morph-skip": true })
+          ] }),
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              "data-key": `${name}:trigger-icon`,
+              slot: "start",
+              class: "kui-select__icon kui-select__icon--selected kui-select__trigger-icon",
+              children: triggerIcon
+            }
+          ),
+          chosenCount > 0 && /* @__PURE__ */ jsx(Badge, { slot: "end", tone: "info", size: "compact", ariaHidden: true, children: chosenCount })
+        ] }),
+        selected && (renderSelected ? /* @__PURE__ */ jsx(
+          "span",
+          {
+            "data-key": `${name}:${values[0]}:custom-selected`,
+            slot: "start",
+            class: "kui-select__custom-selected",
+            children: /* @__PURE__ */ jsx("span", { class: "kui-select__custom-selected-content", children: renderSelected(selected) })
+          }
+        ) : selected.icon ? icon(selected, true) : null),
+        ungrouped.map(option),
+        groups.map((group, index) => /* @__PURE__ */ jsxs(
+          "div",
+          {
+            class: `kui-select__group${index > 0 || ungrouped.length > 0 ? " kui-select__group--separated" : ""}`,
+            role: "group",
+            "aria-label": group,
+            children: [
+              /* @__PURE__ */ jsx("span", { class: "kui-select__group-title", children: group }),
+              choices.filter((choice) => choice.group === group).map(option)
+            ]
+          }
+        )),
+        props.multiple && (props.selectAllLabel || props.clearLabel) && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            class: "kui-select__actions",
+            role: "group",
+            "aria-label": label || ariaLabel,
+            children: [
+              props.selectAllLabel && /* @__PURE__ */ jsx(
+                "button",
+                {
+                  class: "kui-select__action",
+                  type: "button",
+                  "data-select-action": "all",
+                  children: props.selectAllLabel
+                }
+              ),
+              props.clearLabel && /* @__PURE__ */ jsx(
+                "button",
+                {
+                  class: "kui-select__action",
+                  type: "button",
+                  "data-select-action": "clear",
+                  children: props.clearLabel
+                }
+              )
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+
+export { Select };
+
+//# sourceMappingURL=chunk-NVKRZ5DI.js.map

package/dist/chunk-NVKRZ5DI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/forms/select/select.tsx"],"names":[],"mappings":"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","file":"chunk-NVKRZ5DI.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\n\nimport type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport {\n  type CssForegroundColor,\n  em,\n} from '../../../shared/styles/css-values.js';\nimport { Badge } from '../../feedback/badge/badge.js';\nimport { Skeleton } from '../../feedback/skeleton/skeleton.js';\nimport {\n  LucideIcon,\n  type LucideNode,\n} from '../../media/lucide-icon/lucide-icon.js';\n\nexport interface SelectChoice<Value extends string = string> {\n  value: Value;\n  label: string;\n  icon?: LucideNode;\n  iconName?: string;\n  /**\n   * Foreground color for the optional icon: a semantic foreground token such\n   * as `uiColor('success-on-quiet')`, or an application-owned\n   * `foregroundColorVar('--app-icon-color')`. Fill tokens such as\n   * `uiColor('success-fill-quiet')` are pale background tints and do not\n   * type-check.\n   */\n  color?: CssForegroundColor;\n  group?: string;\n  /** Keep an unavailable choice visible but prevent selection. */\n  disabled?: boolean;\n  /** Optional explanation exposed as the disabled option's native tooltip. */\n  disabledReason?: string;\n  /**\n   * Draw a divider between this choice and the previous choice in the same\n   * list. A group boundary is already a separator, so the first choice of a\n   * group (or of the whole menu) never draws a second one.\n   */\n  separatorBefore?: boolean;\n}\n\ntype SelectAccessibleName =\n  { label: string; ariaLabel?: string } | { label?: never; ariaLabel: string };\n\nexport type SelectPresentation =\n  'form' | 'toolbar-borderless' | 'navigation' | 'inline' | 'title';\nexport type SelectSize = 'default' | 'compact';\nexport type SelectSelectedPresentation = 'label' | 'icon-only';\nexport type SelectFocusRingOwner = 'select' | 'group';\nexport type SelectTriggerWidth = 'fit-content' | 'max-content' | 'fill';\n\ninterface SelectBaseProps<Value extends string = string> {\n  name: string;\n  choices: readonly SelectChoice<Value>[];\n  className?: string;\n  /** Empty-value hint text shown in the closed control (the native select placeholder). */\n  placeholderText?: string;\n  /** Supporting text shown below the control and associated with its combobox. */\n  hint?: string;\n  disabled?: boolean;\n  /** Match menu width to the trigger; default menus grow to content within viewport gutters. */\n  fitMenu?: boolean;\n  /** Render as an unanimated loading skeleton: the label above a static, empty control box. */\n  placeholder?: boolean;\n  /** Form (default), borderless toolbar, intrinsic navigation, inline, or view-title chrome. */\n  presentation?: SelectPresentation;\n  size?: SelectSize;\n  /** Closed trigger width; omit to keep the presentation's default. */\n  triggerWidth?: SelectTriggerWidth;\n  /** Show the disclosure caret (default); omit it for a compact icon-only trigger. */\n  caret?: boolean;\n  /** Let an enclosing ToolbarControlGroup paint the composed focus ring. */\n  focusRingOwner?: SelectFocusRingOwner;\n  /** Keep the trigger's focus ring inside its box when an ancestor clips overflow. */\n  focusRingInset?: boolean;\n  /** Maximum closed-control label width in CSS pixels before ellipsis. */\n  labelMaxWidth?: number;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/** One chosen value (the default). */\nexport interface SelectSingleValueProps<Value extends string = string> {\n  multiple?: false;\n  value: NoInfer<Value>;\n  renderSelected?: (choice: SelectChoice<Value>) => SafeHtml;\n  /** Show only the selected choice icon while retaining the Select's accessible name. */\n  selectedPresentation?: SelectSelectedPresentation;\n  triggerIcon?: never;\n  selectAllLabel?: never;\n  clearLabel?: never;\n}\n\n/**\n * Any number of chosen values. The popup stays open while the person toggles\n * choices and closes on an outside click, Escape, or focus leaving; the closed\n * control summarizes the chosen labels in choice order.\n */\nexport interface SelectMultipleLabelProps<Value extends string = string> {\n  multiple: true;\n  value: readonly NoInfer<Value>[];\n  renderSelected?: never;\n  selectedPresentation?: 'label';\n  triggerIcon?: never;\n  /** Opt in to a footer action that selects every enabled choice. */\n  selectAllLabel?: string;\n  /** Opt in to a footer action that clears the current selection. */\n  clearLabel?: string;\n}\n\n/**\n * A multiple Select drawn as an icon-only toolbar trigger, such as a\n * \"Filter by label\" funnel. No single choice is selected, so the trigger shows\n * a fixed `triggerIcon` naming the menu's purpose; while any choice is chosen\n * a count badge sits beside it, and the combobox's accessible name ends with\n * the chosen labels in choice order.\n */\nexport interface SelectMultipleIconProps<Value extends string = string> {\n  multiple: true;\n  value: readonly NoInfer<Value>[];\n  renderSelected?: never;\n  selectedPresentation: 'icon-only';\n  /**\n   * The trigger's fixed icon, typically a `LucideIcon` naming the menu's\n   * purpose (a funnel for a filter), independent of the selection.\n   */\n  triggerIcon: KerfUiContent;\n  /** Opt in to a footer action that selects every enabled choice. */\n  selectAllLabel?: string;\n  /** Opt in to a footer action that clears the current selection. */\n  clearLabel?: string;\n}\n\nexport type SelectMultipleValueProps<Value extends string = string> =\n  SelectMultipleLabelProps<Value> | SelectMultipleIconProps<Value>;\n\nexport type SelectProps<Value extends string = string> =\n  SelectBaseProps<Value> &\n    SelectAccessibleName &\n    (SelectSingleValueProps<Value> | SelectMultipleValueProps<Value>);\n\n// The closed wa-select's disclosure glyph: Web Awesome's system `chevron-down`,\n// Font Awesome Free 7.0.0 by @fontawesome (https://fontawesome.com), licensed\n// CC BY 4.0 (https://fontawesome.com/license/free). The placeholder draws the\n// same path so the loading box matches the live control without registering\n// Web Awesome.\nfunction SelectChevron() {\n  return (\n    <svg viewBox=\"0 0 448 512\" aria-hidden=\"true\">\n      <path d=\"M201.4 406.6c12.5 12.5 32.8 12.5 45.3 0l192-192c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0L224 338.7 54.6 169.4c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3l192 192z\" />\n    </svg>\n  );\n}\n\nexport function Select<Value extends string>(props: SelectProps<Value>) {\n  const {\n    name,\n    label,\n    ariaLabel,\n    choices,\n    className = '',\n    placeholderText,\n    hint,\n    disabled = false,\n    fitMenu = false,\n    placeholder = false,\n    presentation = 'form',\n    size = 'default',\n    triggerWidth,\n    caret = true,\n    focusRingOwner = 'select',\n    focusRingInset = false,\n    labelMaxWidth,\n    slot,\n  } = props;\n  const multiple = props.multiple === true;\n  const values: readonly Value[] = props.multiple ? props.value : [props.value];\n  const renderSelected = props.multiple ? undefined : props.renderSelected;\n  const selectedPresentation: SelectSelectedPresentation =\n    props.selectedPresentation ?? 'label';\n  // A multiple icon-only trigger shows a fixed icon naming the menu's\n  // purpose instead of a selected choice's icon.\n  const iconTrigger =\n    props.multiple && props.selectedPresentation === 'icon-only';\n  const triggerIcon = iconTrigger ? props.triggerIcon : undefined;\n  if (placeholder) {\n    return (\n      <div\n        class={`kui-select kui-select--placeholder ${className}`.trim()}\n        data-component=\"select\"\n        data-placeholder=\"true\"\n        data-presentation={presentation}\n        data-size={size}\n        data-trigger-width={triggerWidth}\n        data-caret={caret ? undefined : 'false'}\n        data-selected-presentation={selectedPresentation}\n        data-focus-ring-owner={focusRingOwner}\n        data-focus-ring-inset={focusRingInset ? 'true' : undefined}\n        aria-busy=\"true\"\n        style={\n          labelMaxWidth === undefined\n            ? undefined\n            : `--kui-select-label-max-width:${labelMaxWidth}px`\n        }\n        slot={slot}\n      >\n        {label && <span class=\"kui-select__placeholder-label\">{label}</span>}\n        <span\n          class=\"kui-select__placeholder-box\"\n          aria-label={ariaLabel}\n          role=\"img\"\n        >\n          <Skeleton width={em(10)} />\n          <span class=\"kui-select__placeholder-chevron\" aria-hidden=\"true\">\n            <SelectChevron />\n          </span>\n        </span>\n        {hint && <span class=\"kui-select__placeholder-hint\">{hint}</span>}\n      </div>\n    );\n  }\n  // A multiple Select summarizes its choices in the display text instead of\n  // leading with one selected icon.\n  const selected = multiple\n    ? undefined\n    : choices.find((choice) => choice.value === values[0] && !choice.disabled);\n  const chosenCount = iconTrigger\n    ? choices.filter(\n        (choice) => !choice.disabled && values.includes(choice.value),\n      ).length\n    : 0;\n  const icon = (choice: SelectChoice<Value>, selectedIcon = false) => (\n    <span\n      data-key={`${name}:${choice.value}:${selectedIcon ? 'selected' : 'option'}`}\n      data-morph-skip\n      slot=\"start\"\n      class={`kui-select__icon${selectedIcon ? ' kui-select__icon--selected' : ''}`}\n      style={choice.color ? `color:${choice.color}` : undefined}\n    >\n      {choice.icon ? (\n        <LucideIcon\n          icon={choice.icon}\n          name={\n            choice.iconName ?? choice.label.toLowerCase().replaceAll(' ', '-')\n          }\n        />\n      ) : null}\n    </span>\n  );\n  const option = (choice: SelectChoice<Value>, index: number) => (\n    <>\n      {/* Web Awesome sets the divider's role and aria-orientation on its\n          host once, so a template that omits them would lose them to the\n          next kerf re-render's morph for good. Render them explicitly, with\n          the orientation it reflects (see the wa-select note below). */}\n      {choice.separatorBefore && index > 0 && (\n        <wa-divider\n          orientation=\"horizontal\"\n          role=\"separator\"\n          aria-orientation=\"horizontal\"\n        />\n      )}\n      <wa-option\n        value={choice.value}\n        selected={multiple && !choice.disabled && values.includes(choice.value)}\n        disabled={choice.disabled}\n        title={choice.disabled ? choice.disabledReason : undefined}\n      >\n        {choice.icon ? icon(choice) : null}\n        {choice.label}\n      </wa-option>\n    </>\n  );\n  const groups = [\n    ...new Set(\n      choices\n        .map((choice) => choice.group)\n        .filter((group): group is string => Boolean(group)),\n    ),\n  ];\n  const ungrouped = choices.filter((choice) => !choice.group);\n  // Web Awesome names its shadow combobox from the label, not the host's\n  // aria-label. Keep ariaLabel-only names available without visible chrome.\n  // A multiple Select's value is its selected options (the value attribute\n  // holds only one string), kept in sync by @kerfjs/ui/select/register.\n  // size/appearance/placement are Web Awesome's defaults, which it reflects\n  // onto the host; rendering them keeps a re-render's morph from stripping\n  // them and forcing a Lit update to put them back.\n  return (\n    <wa-select\n      size=\"m\"\n      appearance=\"outlined\"\n      placement=\"bottom\"\n      class={`kui-select${renderSelected ? ' kui-select--custom-selected' : ''}${fitMenu ? ' kui-select--fit-menu' : ''}${!label ? ' kui-select--label-hidden' : ''} ${className}`.trim()}\n      data-component=\"select\"\n      data-presentation={presentation}\n      data-size={size}\n      data-trigger-width={triggerWidth}\n      data-caret={caret ? undefined : 'false'}\n      data-selected-presentation={selectedPresentation}\n      data-focus-ring-owner={focusRingOwner}\n      data-focus-ring-inset={focusRingInset ? 'true' : undefined}\n      name={name}\n      label={label || ariaLabel}\n      aria-label={ariaLabel}\n      multiple={multiple}\n      value={multiple ? undefined : values[0]}\n      placeholder={placeholderText}\n      hint={hint}\n      disabled={disabled}\n      style={\n        labelMaxWidth === undefined\n          ? undefined\n          : `--kui-select-label-max-width:${labelMaxWidth}px`\n      }\n      slot={slot}\n    >\n      {iconTrigger && (\n        <>\n          {/* The accessible name ends with the chosen labels, which\n              @kerfjs/ui/select/register writes into the summary. */}\n          <span slot=\"label\" data-key={`${name}:trigger-label`}>\n            {label || ariaLabel}\n            <span class=\"kui-select__name-summary\" data-morph-skip />\n          </span>\n          <span\n            data-key={`${name}:trigger-icon`}\n            slot=\"start\"\n            class=\"kui-select__icon kui-select__icon--selected kui-select__trigger-icon\"\n          >\n            {triggerIcon}\n          </span>\n          {chosenCount > 0 && (\n            <Badge slot=\"end\" tone=\"info\" size=\"compact\" ariaHidden>\n              {chosenCount}\n            </Badge>\n          )}\n        </>\n      )}\n      {selected &&\n        (renderSelected ? (\n          <span\n            data-key={`${name}:${values[0]}:custom-selected`}\n            slot=\"start\"\n            class=\"kui-select__custom-selected\"\n          >\n            <span class=\"kui-select__custom-selected-content\">\n              {renderSelected(selected)}\n            </span>\n          </span>\n        ) : selected.icon ? (\n          icon(selected, true)\n        ) : null)}\n      {ungrouped.map(option)}\n      {groups.map((group, index) => (\n        <div\n          class={`kui-select__group${index > 0 || ungrouped.length > 0 ? ' kui-select__group--separated' : ''}`}\n          role=\"group\"\n          aria-label={group}\n        >\n          <span class=\"kui-select__group-title\">{group}</span>\n          {choices.filter((choice) => choice.group === group).map(option)}\n        </div>\n      ))}\n      {props.multiple && (props.selectAllLabel || props.clearLabel) && (\n        <div\n          class=\"kui-select__actions\"\n          role=\"group\"\n          aria-label={label || ariaLabel}\n        >\n          {props.selectAllLabel && (\n            <button\n              class=\"kui-select__action\"\n              type=\"button\"\n              data-select-action=\"all\"\n            >\n              {props.selectAllLabel}\n            </button>\n          )}\n          {props.clearLabel && (\n            <button\n              class=\"kui-select__action\"\n              type=\"button\"\n              data-select-action=\"clear\"\n            >\n              {props.clearLabel}\n            </button>\n          )}\n        </div>\n      )}\n    </wa-select>\n  );\n}\n"]}

package/dist/chunk-NVRJ7C3W.js

@@ -0,0 +1,83 @@
+import { verticalAlignment, horizontalAlignment } from './chunk-MXNIVEVL.js';
+import { filterDataAttributes } from './chunk-LAZLBC2Q.js';
+import { space } from './chunk-LRAIS3YB.js';
+import { jsx } from 'kerfjs/jsx-runtime';
+
+var listProtectedAttributes = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-gap",
+  "data-flex",
+  "data-fill",
+  "data-h-align",
+  "data-v-align",
+  "data-scrollable",
+  "data-text-insets",
+  "data-control-insets"
+]);
+var spaceNames = [
+  "none",
+  "2xs",
+  "xs",
+  "s",
+  "m",
+  "l",
+  "xl"
+];
+function List({
+  children,
+  selectionMode,
+  ariaLabel,
+  gap = false,
+  flex = false,
+  fill = false,
+  hAlign = "full",
+  vAlign = "top",
+  scrollable = false,
+  dividerSides = "",
+  textInsets = "",
+  controlInsets = "",
+  className = "",
+  rootAttributes = {},
+  slot
+}) {
+  if (selectionMode === "multiple" && !ariaLabel) {
+    throw new Error("Multi-select List requires an ariaLabel");
+  }
+  const safeRootAttributes = filterDataAttributes(
+    rootAttributes,
+    listProtectedAttributes
+  );
+  const gapValue = gap === true ? "var(--kui-list-gap)" : spaceNames.includes(gap) ? space(gap) : gap || void 0;
+  const flexValue = flex === true ? "1 1 auto" : flex || void 0;
+  const style = [
+    gapValue ? `--_kui-list-gap:${gapValue}` : "",
+    flexValue ? `--_kui-list-flex:${flexValue}` : ""
+  ].filter(Boolean).join(";");
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...safeRootAttributes,
+      class: `kui-list ${className}`.trim(),
+      "data-component": "list",
+      role: selectionMode === "multiple" ? "grid" : void 0,
+      "aria-label": selectionMode === "multiple" ? ariaLabel : void 0,
+      "aria-multiselectable": selectionMode === "multiple" ? "true" : void 0,
+      "data-gap": String(Boolean(gap)),
+      "data-flex": String(Boolean(flex)),
+      "data-fill": fill ? "true" : void 0,
+      "data-h-align": horizontalAlignment(hAlign),
+      "data-v-align": verticalAlignment(vAlign),
+      "data-scrollable": String(scrollable),
+      "divider-sides": dividerSides || void 0,
+      "data-text-insets": textInsets || void 0,
+      "data-control-insets": controlInsets || void 0,
+      style: style || void 0,
+      slot,
+      children
+    }
+  );
+}
+
+export { List };
+
+//# sourceMappingURL=chunk-NVRJ7C3W.js.map

package/dist/chunk-NVRJ7C3W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/collections/list/list.tsx"],"names":[],"mappings":";;;;;AAiBA,IAAM,uBAAA,uBAA8B,GAAA,CAAI;AAAA,EACtC,gBAAA;AAAA,EACA,UAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,cAAA;AAAA,EACA,cAAA;AAAA,EACA,iBAAA;AAAA,EACA,kBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAgBD,IAAM,UAAA,GAAqC;AAAA,EACzC,MAAA;AAAA,EACA,KAAA;AAAA,EACA,IAAA;AAAA,EACA,GAAA;AAAA,EACA,GAAA;AAAA,EACA,GAAA;AAAA,EACA;AACF,CAAA;AAiDO,SAAS,IAAA,CAAK;AAAA,EACnB,QAAA;AAAA,EACA,aAAA;AAAA,EACA,SAAA;AAAA,EACA,GAAA,GAAM,KAAA;AAAA,EACN,IAAA,GAAO,KAAA;AAAA,EACP,IAAA,GAAO,KAAA;AAAA,EACP,MAAA,GAAS,MAAA;AAAA,EACT,MAAA,GAAS,KAAA;AAAA,EACT,UAAA,GAAa,KAAA;AAAA,EACb,YAAA,GAAe,EAAA;AAAA,EACf,UAAA,GAAa,EAAA;AAAA,EACb,aAAA,GAAgB,EAAA;AAAA,EAChB,SAAA,GAAY,EAAA;AAAA,EACZ,iBAAiB,EAAC;AAAA,EAClB;AACF,CAAA,EAAc;AACZ,EAAA,IAAI,aAAA,KAAkB,UAAA,IAAc,CAAC,SAAA,EAAW;AAC9C,IAAA,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAAA,EAC3D;AACA,EAAA,MAAM,kBAAA,GAAqB,oBAAA;AAAA,IACzB,cAAA;AAAA,IACA;AAAA,GACF;AACA,EAAA,MAAM,QAAA,GACJ,GAAA,KAAQ,IAAA,GACJ,qBAAA,GACA,UAAA,CAAW,QAAA,CAAS,GAAkB,CAAA,GACpC,KAAA,CAAM,GAAkB,CAAA,GACxB,GAAA,IAAO,MAAA;AACf,EAAA,MAAM,SAAA,GAAY,IAAA,KAAS,IAAA,GAAO,UAAA,GAAa,IAAA,IAAQ,MAAA;AACvD,EAAA,MAAM,KAAA,GAAQ;AAAA,IACZ,QAAA,GAAW,CAAA,gBAAA,EAAmB,QAAQ,CAAA,CAAA,GAAK,EAAA;AAAA,IAC3C,SAAA,GAAY,CAAA,iBAAA,EAAoB,SAAS,CAAA,CAAA,GAAK;AAAA,GAChD,CACG,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA;AAEX,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACE,GAAG,kBAAA;AAAA,MACJ,KAAA,EAAO,CAAA,SAAA,EAAY,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MACpC,gBAAA,EAAe,MAAA;AAAA,MACf,IAAA,EAAM,aAAA,KAAkB,UAAA,GAAa,MAAA,GAAS,MAAA;AAAA,MAC9C,YAAA,EAAY,aAAA,KAAkB,UAAA,GAAa,SAAA,GAAY,MAAA;AAAA,MACvD,sBAAA,EAAsB,aAAA,KAAkB,UAAA,GAAa,MAAA,GAAS,MAAA;AAAA,MAC9D,UAAA,EAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAC,CAAA;AAAA,MAC7B,WAAA,EAAW,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAC,CAAA;AAAA,MAC/B,WAAA,EAAW,OAAO,MAAA,GAAS,MAAA;AAAA,MAC3B,cAAA,EAAc,oBAAoB,MAAM,CAAA;AAAA,MACxC,cAAA,EAAc,kBAAkB,MAAM,CAAA;AAAA,MACtC,iBAAA,EAAiB,OAAO,UAAU,CAAA;AAAA,MAClC,iBAAe,YAAA,IAAgB,MAAA;AAAA,MAC/B,oBAAkB,UAAA,IAAc,MAAA;AAAA,MAChC,uBAAqB,aAAA,IAAiB,MAAA;AAAA,MACtC,OAAO,KAAA,IAAS,MAAA;AAAA,MAChB,IAAA;AAAA,MAEC;AAAA;AAAA,GACH;AAEJ","file":"chunk-NVRJ7C3W.js","sourcesContent":["import type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport { filterDataAttributes } from '../../../shared/dom/extension-attributes.js';\nimport {\n  type HorizontalAlignment,\n  horizontalAlignment,\n  type ListVerticalAlignment,\n  verticalAlignment,\n} from '../../../shared/layout/flex-alignment.js';\nimport type { Sides } from '../../../shared/layout/sides.js';\nimport {\n  type CssFlex,\n  type CssFlexKeyword,\n  type CssLength,\n  space,\n  type UiSpaceName,\n} from '../../../shared/styles/css-values.js';\n\nconst listProtectedAttributes = new Set([\n  'data-component',\n  'data-gap',\n  'data-flex',\n  'data-fill',\n  'data-h-align',\n  'data-v-align',\n  'data-scrollable',\n  'data-text-insets',\n  'data-control-insets',\n]);\n\ntype ListRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-gap'?: never;\n    'data-flex'?: never;\n    'data-fill'?: never;\n    'data-h-align'?: never;\n    'data-v-align'?: never;\n    'data-scrollable'?: never;\n    'data-text-insets'?: never;\n    'data-control-insets'?: never;\n  }\n>;\n\nconst spaceNames: readonly UiSpaceName[] = [\n  'none',\n  '2xs',\n  'xs',\n  's',\n  'm',\n  'l',\n  'xl',\n];\n\nexport interface ListProps {\n  children?: KerfUiContent;\n  /** Make this list a labeled multi-select grid for `ContentItem selectionMode=\"multiple\"` rows. */\n  selectionMode?: 'multiple';\n  /** Accessible name for the multi-select grid. */\n  ariaLabel?: string;\n  /** Use the standard item gap, a named UI spacing token, or a typed CSS length. Defaults to no gap. */\n  gap?: boolean | UiSpaceName | CssLength;\n  /** Allow this list to grow/shrink, use a keyword, or supply a typed CSS flex shorthand. */\n  flex?: boolean | CssFlexKeyword | CssFlex;\n  /**\n   * Fill the height of a parent with a definite height, such as an app root or\n   * a fixed-height frame, when this list is that parent's layout root. Inside a\n   * flex layout use `flex` instead. Defaults to false.\n   */\n  fill?: boolean;\n  /** Horizontal alignment. Defaults to full to preserve stretch-aligned list children. */\n  hAlign?: HorizontalAlignment;\n  /** Vertical distribution. Defaults to top. */\n  vAlign?: ListVerticalAlignment;\n  /** Own vertical scrolling and overscroll containment. */\n  scrollable?: boolean;\n  /** Physical divider edges in canonical top/right/bottom/left order. */\n  dividerSides?: Sides;\n  /** Physical sides that receive the standard 17px text inset. */\n  textInsets?: Sides;\n  /** Physical sides that receive the standard 8px control inset. Text insets win on overlap. */\n  controlInsets?: Sides;\n  className?: string;\n  /** Safe `data-*` metadata; List-owned structural attributes remain protected. */\n  rootAttributes?: ListRootAttributes;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/**\n * A list's configuration, apart from its content and styling hooks: the props a\n * composite that renders a `List` for the app (the Workbench's `mainHeader` /\n * `mainFooter` chrome) forwards, so the app configures that list instead of\n * styling it. An omitted or `undefined` field keeps the composite's default.\n */\nexport type ListConfig = Pick<\n  ListProps,\n  'gap' | 'hAlign' | 'vAlign' | 'dividerSides' | 'textInsets' | 'controlInsets'\n>;\n\n/** A stretch-aligned vertical stack with optional gap, flex, fill, scroll, and dividers. */\nexport function List({\n  children,\n  selectionMode,\n  ariaLabel,\n  gap = false,\n  flex = false,\n  fill = false,\n  hAlign = 'full',\n  vAlign = 'top',\n  scrollable = false,\n  dividerSides = '',\n  textInsets = '',\n  controlInsets = '',\n  className = '',\n  rootAttributes = {},\n  slot,\n}: ListProps) {\n  if (selectionMode === 'multiple' && !ariaLabel) {\n    throw new Error('Multi-select List requires an ariaLabel');\n  }\n  const safeRootAttributes = filterDataAttributes(\n    rootAttributes,\n    listProtectedAttributes,\n  );\n  const gapValue =\n    gap === true\n      ? 'var(--kui-list-gap)'\n      : spaceNames.includes(gap as UiSpaceName)\n        ? space(gap as UiSpaceName)\n        : gap || undefined;\n  const flexValue = flex === true ? '1 1 auto' : flex || undefined;\n  const style = [\n    gapValue ? `--_kui-list-gap:${gapValue}` : '',\n    flexValue ? `--_kui-list-flex:${flexValue}` : '',\n  ]\n    .filter(Boolean)\n    .join(';');\n\n  return (\n    <div\n      {...safeRootAttributes}\n      class={`kui-list ${className}`.trim()}\n      data-component=\"list\"\n      role={selectionMode === 'multiple' ? 'grid' : undefined}\n      aria-label={selectionMode === 'multiple' ? ariaLabel : undefined}\n      aria-multiselectable={selectionMode === 'multiple' ? 'true' : undefined}\n      data-gap={String(Boolean(gap))}\n      data-flex={String(Boolean(flex))}\n      data-fill={fill ? 'true' : undefined}\n      data-h-align={horizontalAlignment(hAlign)}\n      data-v-align={verticalAlignment(vAlign)}\n      data-scrollable={String(scrollable)}\n      divider-sides={dividerSides || undefined}\n      data-text-insets={textInsets || undefined}\n      data-control-insets={controlInsets || undefined}\n      style={style || undefined}\n      slot={slot}\n    >\n      {children}\n    </div>\n  );\n}\n\nexport type {\n  HorizontalAlignment,\n  ListVerticalAlignment,\n  VerticalAlignment,\n} from '../../../shared/layout/flex-alignment.js';\nexport type { Sides } from '../../../shared/layout/sides.js';\nexport type {\n  CssFlex,\n  CssFlexKeyword,\n  CssLength,\n  UiSpaceName,\n} from '../../../shared/styles/css-values.js';\n"]}

package/dist/chunk-O27D24CA.js

@@ -0,0 +1,250 @@
+// src/integrations/webawesome/help-tags/install-help-tag.ts
+var HELP_TAG_SHOW_DELAY = 500;
+var HELP_TAG_WARM_WINDOW = 400;
+var HELP_TAG_VIEWPORT_MARGIN = 8;
+var LIFECYCLE_EVENTS = [
+  "wa-show",
+  "wa-after-show",
+  "wa-hide",
+  "wa-after-hide"
+];
+var installed = /* @__PURE__ */ new WeakSet();
+function isFocusVisible(element) {
+  try {
+    return element.matches(":focus-visible");
+  } catch {
+    return false;
+  }
+}
+var MENU_LABEL = ':scope > [slot="trigger"] .kui-popup-menu__label';
+var isPlainControl = (host) => host.localName === "button" || host.localName === "a";
+var words = (node) => node.textContent.replace(/\s+/g, " ").trim();
+var ariaLabel = (control) => (control.getAttribute("aria-label") ?? "").replace(/\s+/g, " ").trim();
+function isToolbarIconControl(target) {
+  if (!target.matches("button, a[href]")) return false;
+  if (!ariaLabel(target) || target.hasAttribute("title") || words(target))
+    return false;
+  if (!target.closest(".kui-toolbar-control-group")) return false;
+  return !(target.id && target.ownerDocument.querySelector(
+    `wa-tooltip[for="${CSS.escape(target.id)}"]`
+  ));
+}
+function helpTagHost(path) {
+  for (const target of path) {
+    if (!(target instanceof HTMLElement)) continue;
+    if (isToolbarIconControl(target)) return target;
+    const { component, selectedPresentation } = target.dataset;
+    if (component === "select" && target.localName === "wa-select" && selectedPresentation === "icon-only")
+      return target;
+    if (component === "popup-menu" && target.querySelector(MENU_LABEL))
+      return target;
+  }
+  return null;
+}
+function anchorOf(host) {
+  if (isPlainControl(host)) return host;
+  if (host.dataset.component === "select")
+    return host.shadowRoot?.querySelector('[part~="combobox"]') ?? null;
+  return host.querySelector(':scope > [slot="trigger"]');
+}
+function helpText(host) {
+  if (isPlainControl(host)) return ariaLabel(host);
+  const label = host.querySelector(MENU_LABEL) ?? host.querySelector(':scope > [slot="label"]');
+  if (label) return words(label);
+  const name = host.getAttribute("label") ?? "";
+  const chosen = host.selectedOptions?.[0];
+  const choice = chosen ? chosen.label || words(chosen) : "";
+  return choice && choice !== name ? `${name}: ${choice}` : name;
+}
+function installHelpTags(doc = document, { focusVisible = isFocusVisible } = {}) {
+  if (installed.has(doc)) return;
+  installed.add(doc);
+  const tags = /* @__PURE__ */ new WeakMap();
+  let hovered = null;
+  let focused = null;
+  let shown = null;
+  let dismissed = null;
+  let timer;
+  let warmUntil = 0;
+  let layer = null;
+  const layerRoot = () => {
+    if (!layer) {
+      layer = doc.createElement("div");
+      layer.className = "kui-help-tag-layer";
+      layer.setAttribute("aria-hidden", "true");
+      layer.setAttribute("data-morph-skip", "");
+      Object.assign(layer.style, {
+        position: "fixed",
+        top: "0",
+        left: "0",
+        width: "0",
+        height: "0"
+      });
+    }
+    if (!layer.isConnected) doc.body.append(layer);
+    return layer;
+  };
+  const tagFor = (host) => {
+    const plain = isPlainControl(host);
+    const root = plain ? layerRoot() : host.shadowRoot;
+    if (!root) return null;
+    let tag = tags.get(host);
+    if (!tag) {
+      tag = doc.createElement("wa-tooltip");
+      tag.className = "kui-help-tag";
+      tag.setAttribute("aria-hidden", "true");
+      tag.setAttribute("trigger", "manual");
+      tag.setAttribute("placement", "bottom");
+      tag.style.pointerEvents = "none";
+      for (const type of LIFECYCLE_EVENTS)
+        tag.addEventListener(type, (event) => event.stopPropagation());
+      if (plain) {
+        const created = tag;
+        created.addEventListener("wa-after-hide", () => {
+          if (created.open) return;
+          created.remove();
+          tags.delete(host);
+        });
+      }
+      root.append(tag);
+      tags.set(host, tag);
+    }
+    return tag;
+  };
+  const hide = (host) => {
+    if (shown?.host !== host) return;
+    shown.tag.open = false;
+    shown = null;
+    warmUntil = Date.now() + HELP_TAG_WARM_WINDOW;
+  };
+  const show = (host) => {
+    window.clearTimeout(timer);
+    timer = void 0;
+    if (host.open || dismissed === host || !host.isConnected) return;
+    const anchor = anchorOf(host);
+    const text = helpText(host);
+    if (!anchor || !text) return;
+    const tag = tagFor(host);
+    if (!tag) return;
+    if (shown) hide(shown.host);
+    if (anchor === host)
+      tag.style.colorScheme = window.getComputedStyle(host).colorScheme;
+    tag.anchor = anchor;
+    tag.textContent = text;
+    tag.open = true;
+    shown = { host, tag };
+    void tag.updateComplete.then(() => {
+      if (tag.anchor !== anchor) tag.anchor = anchor;
+      const popup = tag.shadowRoot?.querySelector("wa-popup");
+      if (popup) popup.shiftPadding = HELP_TAG_VIEWPORT_MARGIN;
+    });
+  };
+  const triggerHost = (event) => {
+    const path = event.composedPath();
+    const host = helpTagHost(path);
+    if (!host) return null;
+    const anchor = anchorOf(host);
+    return anchor && path.includes(anchor) ? host : null;
+  };
+  const leave = (host) => {
+    if (hovered !== host) {
+      window.clearTimeout(timer);
+      timer = void 0;
+    }
+    if (hovered !== host && focused !== host) hide(host);
+  };
+  const release = (host) => {
+    if (dismissed && dismissed !== host && !dismissed.open) dismissed = null;
+  };
+  doc.addEventListener(
+    "pointerover",
+    (event) => {
+      if (event.pointerType === "touch") return;
+      const host = triggerHost(event);
+      release(host);
+      if (host === hovered) return;
+      const previous = hovered;
+      hovered = host;
+      if (previous) leave(previous);
+      if (!host || host.open || dismissed === host || shown?.host === host)
+        return;
+      window.clearTimeout(timer);
+      if (Date.now() < warmUntil) show(host);
+      else timer = window.setTimeout(() => show(host), HELP_TAG_SHOW_DELAY);
+    },
+    true
+  );
+  doc.addEventListener(
+    "pointerout",
+    (event) => {
+      if (event.relatedTarget !== null || !hovered) return;
+      const previous = hovered;
+      hovered = null;
+      leave(previous);
+    },
+    true
+  );
+  const dismiss = (host) => {
+    dismissed = host;
+    hide(host);
+  };
+  doc.addEventListener(
+    "pointerdown",
+    (event) => {
+      const host = helpTagHost(event.composedPath());
+      if (host) dismiss(host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "focusin",
+    (event) => {
+      const target = event.composedPath()[0];
+      const host = target instanceof Element && focusVisible(target) ? triggerHost(event) : null;
+      if (host === focused) return;
+      const previous = focused;
+      focused = host;
+      if (previous) leave(previous);
+      if (host && dismissed !== host) show(host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "focusout",
+    (event) => {
+      const host = helpTagHost(event.composedPath());
+      const next = event.relatedTarget;
+      if (!host || next instanceof Node && host.contains(next)) return;
+      if (dismissed === host) dismissed = null;
+      if (host !== focused) return;
+      focused = null;
+      leave(host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "keydown",
+    (event) => {
+      if (event.key === "Escape" && shown) dismiss(shown.host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "wa-show",
+    (event) => {
+      const host = helpTagHost(event.composedPath());
+      if (host && event.composedPath()[0] === host) dismiss(host);
+    },
+    true
+  );
+  const refresh = (event) => {
+    const host = helpTagHost(event.composedPath());
+    if (shown && host === shown.host) shown.tag.textContent = helpText(host);
+  };
+  doc.addEventListener("change", refresh, true);
+  doc.addEventListener("input", refresh, true);
+}
+
+export { installHelpTags };
+
+//# sourceMappingURL=chunk-O27D24CA.js.map