@kerfjs/ui 5.0.0-beta.10 → 5.0.0-beta.101

package/dist/chunk-SIW64V65.js

@@ -0,0 +1,176 @@
+import { listIconTilePresentation, withWordBreaks, nativeDraggable } from './chunk-ZNROKDSZ.js';
+import { PopupMenu } from './chunk-HQZYKJ56.js';
+import { LoadingSpinner } from './chunk-WVS6CUCT.js';
+import { Skeleton } from './chunk-CVD5IZGB.js';
+import { remify, em } from './chunk-IQSRHXZR.js';
+import { filterDataAttributes, filterControlAttributes } from './chunk-KH4KEMSP.js';
+import { jsxs, jsx } from 'kerfjs/jsx-runtime';
+
+var PROTECTED_ROOT_DATA_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-action",
+  "data-item-id",
+  "data-has-icon",
+  "data-icon-tile",
+  "data-icon-tile-tone",
+  "data-multiline",
+  "data-density",
+  "data-divider",
+  "data-busy",
+  "data-trailing-visibility",
+  "data-state",
+  "data-selected",
+  "data-pressed",
+  "data-dragging",
+  "data-drop-position"
+]);
+var PROTECTED_TRAILING_DATA_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-action",
+  "data-item-id",
+  "data-kui-disabled"
+]);
+function ListActionRow({
+  label,
+  description,
+  status,
+  busy = false,
+  density = "standard",
+  divider = "none",
+  icon,
+  iconTile,
+  action,
+  itemId,
+  selected = false,
+  pressed,
+  accessibleLabel,
+  title,
+  multiline = false,
+  state,
+  disabled = false,
+  tabIndex,
+  placeholder = false,
+  draggable,
+  dragging = false,
+  dropPosition,
+  trailingAction,
+  trailingActionLabel,
+  trailingActionIcon,
+  trailingActionDisabled = false,
+  trailingActionTitle,
+  trailingActionVisibility = "always",
+  trailingMenu,
+  className = "",
+  rootAttributes = {},
+  trailingActionAttributes = {},
+  slot
+}) {
+  const extensionRootAttributes = filterDataAttributes(
+    rootAttributes,
+    PROTECTED_ROOT_DATA_ATTRIBUTES
+  );
+  const extensionTrailingAttributes = filterControlAttributes(
+    trailingActionAttributes,
+    PROTECTED_TRAILING_DATA_ATTRIBUTES
+  );
+  const tile = icon ? listIconTilePresentation(iconTile, "list-action-row") : null;
+  const iconSize = tile?.tile ? 32 : 18;
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...extensionRootAttributes,
+      class: `kui-list-action-row ${className}`.trim(),
+      "data-component": "list-action-row",
+      "data-item-id": itemId,
+      "data-has-icon": String(Boolean(icon)),
+      "data-icon-tile": tile?.tile,
+      "data-icon-tile-tone": tile?.tone,
+      "data-multiline": multiline ? "true" : void 0,
+      "data-density": density,
+      "data-divider": divider,
+      "data-busy": busy ? "true" : void 0,
+      "data-trailing-visibility": trailingActionVisibility,
+      "data-state": state,
+      "data-selected": String(selected),
+      "data-pressed": pressed === void 0 ? void 0 : String(pressed),
+      "data-placeholder": placeholder ? "true" : void 0,
+      draggable: nativeDraggable(draggable, placeholder),
+      "data-dragging": dragging ? "true" : void 0,
+      "data-drop-position": dropPosition,
+      "aria-busy": placeholder || busy ? "true" : void 0,
+      slot,
+      children: [
+        /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            class: "kui-list-action-row__primary",
+            title: placeholder ? void 0 : title,
+            disabled: disabled || placeholder,
+            tabindex: placeholder ? -1 : tabIndex,
+            "data-kui-disabled": disabled ? "true" : void 0,
+            "data-action": placeholder ? void 0 : action,
+            "data-item-id": itemId,
+            "aria-label": accessibleLabel,
+            "aria-current": selected ? "page" : void 0,
+            "aria-pressed": pressed === void 0 ? void 0 : String(pressed),
+            children: [
+              icon && /* @__PURE__ */ jsx(
+                "span",
+                {
+                  class: "kui-list-action-row__icon",
+                  style: placeholder ? void 0 : tile?.style,
+                  children: placeholder ? /* @__PURE__ */ jsx(
+                    Skeleton,
+                    {
+                      block: true,
+                      width: remify(iconSize),
+                      height: remify(iconSize)
+                    }
+                  ) : icon
+                }
+              ),
+              /* @__PURE__ */ jsxs("span", { class: "kui-list-action-row__label", children: [
+                /* @__PURE__ */ jsx("span", { class: "kui-list-action-row__primary-label", children: placeholder ? /* @__PURE__ */ jsx(Skeleton, { width: em(9) }) : multiline ? withWordBreaks(label) : label }),
+                description && /* @__PURE__ */ jsx("span", { class: "kui-list-action-row__description", children: placeholder ? /* @__PURE__ */ jsx(Skeleton, { width: em(11) }) : description }),
+                (busy || status) && /* @__PURE__ */ jsxs("span", { class: "kui-list-action-row__status", children: [
+                  busy && /* @__PURE__ */ jsx(LoadingSpinner, {}),
+                  status && (placeholder ? /* @__PURE__ */ jsx(Skeleton, { width: em(6) }) : status)
+                ] })
+              ] })
+            ]
+          }
+        ),
+        trailingMenu ? /* @__PURE__ */ jsx(
+          PopupMenu,
+          {
+            label: trailingMenu.label,
+            icon: trailingMenu.icon,
+            items: trailingMenu.items,
+            placement: trailingMenu.placement ?? "bottom-end",
+            caret: false,
+            disabled: Boolean(trailingMenu.disabled) || placeholder
+          }
+        ) : /* @__PURE__ */ jsx(
+          "button",
+          {
+            ...extensionTrailingAttributes,
+            type: "button",
+            class: "kui-list-action-row__trailing-action",
+            "data-action": placeholder ? void 0 : trailingAction,
+            "data-item-id": itemId,
+            "aria-label": trailingActionLabel,
+            title: trailingActionTitle ?? trailingActionLabel,
+            disabled: trailingActionDisabled || placeholder || void 0,
+            "data-kui-disabled": trailingActionDisabled ? "true" : void 0,
+            children: trailingActionIcon
+          }
+        )
+      ]
+    }
+  );
+}
+
+export { ListActionRow };
+
+//# sourceMappingURL=chunk-SIW64V65.js.map

package/dist/chunk-SIW64V65.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/collections/list-action-row/list-action-row.tsx"],"names":[],"mappings":"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","file":"chunk-SIW64V65.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\n\nimport {\n  type ListIconTile,\n  listIconTilePresentation,\n} from '../../../shared/content/list-icon-tile.js';\nimport { nativeDraggable } from '../../../shared/dom/draggable.js';\nimport {\n  filterControlAttributes,\n  filterDataAttributes,\n} from '../../../shared/dom/extension-attributes.js';\nimport { em, remify } from '../../../shared/styles/css-values.js';\nimport { withWordBreaks } from '../../../shared/text/word-breaks.js';\nimport {\n  PopupMenu,\n  type PopupMenuEntry,\n  type PopupMenuPlacement,\n} from '../../actions/popup-menu/popup-menu.js';\nimport { LoadingSpinner } from '../../feedback/loading-spinner/loading-spinner.js';\nimport { Skeleton } from '../../feedback/skeleton/skeleton.js';\n\nexport type {\n  ListIconTile,\n  ListIconTileColor,\n  ListIconTileTone,\n} from '../../../shared/content/list-icon-tile.js';\n\nconst PROTECTED_ROOT_DATA_ATTRIBUTES = new Set([\n  'data-component',\n  'data-action',\n  'data-item-id',\n  'data-has-icon',\n  'data-icon-tile',\n  'data-icon-tile-tone',\n  'data-multiline',\n  'data-density',\n  'data-divider',\n  'data-busy',\n  'data-trailing-visibility',\n  'data-state',\n  'data-selected',\n  'data-pressed',\n  'data-dragging',\n  'data-drop-position',\n]);\nconst PROTECTED_TRAILING_DATA_ATTRIBUTES = new Set([\n  'data-component',\n  'data-action',\n  'data-item-id',\n  'data-kui-disabled',\n]);\n\ntype ListActionRowRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-action'?: never;\n    'data-item-id'?: never;\n    'data-has-icon'?: never;\n    'data-icon-tile'?: never;\n    'data-icon-tile-tone'?: never;\n    'data-multiline'?: never;\n    'data-density'?: never;\n    'data-divider'?: never;\n    'data-busy'?: never;\n    'data-trailing-visibility'?: never;\n    'data-state'?: never;\n    'data-selected'?: never;\n    'data-pressed'?: never;\n    'data-dragging'?: never;\n    'data-drop-position'?: never;\n  }\n>;\n\ntype ListActionRowTrailingAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-action'?: never;\n    'data-item-id'?: never;\n    'data-kui-disabled'?: never;\n    popoverTarget?: string;\n    popoverTargetAction?: 'toggle' | 'show' | 'hide';\n    'aria-controls'?: string;\n    'aria-haspopup'?: 'dialog' | 'menu' | 'listbox' | 'tree' | 'grid' | 'true';\n  }\n>;\n\n/** A trailing overflow `PopupMenu` rendered as the row's sibling trailing control. */\nexport interface ListActionRowTrailingMenu {\n  /** Accessible name of the icon-only menu trigger, such as `Actions for report.json`. */\n  label: string;\n  /** Decorative trigger icon, typically a `MoreHorizontal` `LucideIcon`. */\n  icon: SafeHtml;\n  /** The menu's commands, headings, and dividers; items dispatch their own `data-action`s. */\n  items: readonly PopupMenuEntry[];\n  /** Where the menu opens relative to its trigger. Defaults to `bottom-end`. */\n  placement?: PopupMenuPlacement;\n  disabled?: boolean;\n}\n\ninterface ListActionRowTrailingButtonProps {\n  trailingAction: string;\n  trailingActionLabel: string;\n  /** Decorative dormant content for the trailing button. Must not contain interactive descendants. */\n  trailingActionIcon: SafeHtml;\n  trailingActionDisabled?: boolean;\n  trailingActionTitle?: string;\n  trailingActionAttributes?: ListActionRowTrailingAttributes;\n  trailingMenu?: never;\n}\n\ninterface ListActionRowTrailingMenuProps {\n  /** A trailing overflow menu in place of the trailing button. Import `@kerfjs/ui/popup-menu/register` once. */\n  trailingMenu: ListActionRowTrailingMenu;\n  trailingAction?: never;\n  trailingActionLabel?: never;\n  trailingActionIcon?: never;\n  trailingActionDisabled?: never;\n  trailingActionTitle?: never;\n  trailingActionAttributes?: never;\n}\n\ninterface ListActionRowCommonProps {\n  /** Visible dormant content for the primary button. Must not contain interactive descendants. */\n  label: string | SafeHtml;\n  description?: string | SafeHtml;\n  status?: string | SafeHtml;\n  busy?: boolean;\n  /** Row height: `standard` is 44px; `compact` is 36px (42px with `iconTile`), the height of a compact `ListItem`. */\n  density?: 'standard' | 'compact';\n  divider?: 'none' | 'before' | 'after' | 'both';\n  /** Decorative dormant content for the primary button. Must not contain interactive descendants. */\n  icon?: SafeHtml;\n  /** Present `icon` in a filled 32px rounded tile with an 18px glyph: a quiet tone preset, or `{ color, foreground? }` for an application color. */\n  iconTile?: ListIconTile;\n  action: string;\n  itemId?: string;\n  selected?: boolean;\n  pressed?: boolean;\n  accessibleLabel?: string;\n  title?: string;\n  multiline?: boolean;\n  state?: string;\n  disabled?: boolean;\n  tabIndex?: number;\n  /** Render as an unanimated loading skeleton, disabling both actions: label, description, icon, and status text become skeletons; the `busy` indicator stays live. */\n  placeholder?: boolean;\n  /** Native HTML drag source (`draggable=\"true\"` on the row root); a placeholder is never draggable. Pair with `wireListReorder` for pointer and keyboard reordering. */\n  draggable?: boolean;\n  /** Dim this row as one of the rows being dragged. */\n  dragging?: boolean;\n  /** Draw the insertion line at this row's leading (`before`) or trailing (`after`) block edge. */\n  dropPosition?: 'before' | 'after';\n  trailingActionVisibility?: 'always' | 'interaction';\n  className?: string;\n  rootAttributes?: ListActionRowRootAttributes;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/** Exactly one trailing control: a native button (`trailingAction*`) or an overflow menu (`trailingMenu`). */\nexport type ListActionRowProps = ListActionRowCommonProps &\n  (ListActionRowTrailingButtonProps | ListActionRowTrailingMenuProps);\n\nexport function ListActionRow({\n  label,\n  description,\n  status,\n  busy = false,\n  density = 'standard',\n  divider = 'none',\n  icon,\n  iconTile,\n  action,\n  itemId,\n  selected = false,\n  pressed,\n  accessibleLabel,\n  title,\n  multiline = false,\n  state,\n  disabled = false,\n  tabIndex,\n  placeholder = false,\n  draggable,\n  dragging = false,\n  dropPosition,\n  trailingAction,\n  trailingActionLabel,\n  trailingActionIcon,\n  trailingActionDisabled = false,\n  trailingActionTitle,\n  trailingActionVisibility = 'always',\n  trailingMenu,\n  className = '',\n  rootAttributes = {},\n  trailingActionAttributes = {},\n  slot,\n}: ListActionRowProps) {\n  const extensionRootAttributes = filterDataAttributes(\n    rootAttributes,\n    PROTECTED_ROOT_DATA_ATTRIBUTES,\n  );\n  const extensionTrailingAttributes = filterControlAttributes(\n    trailingActionAttributes,\n    PROTECTED_TRAILING_DATA_ATTRIBUTES,\n  );\n  const tile = icon\n    ? listIconTilePresentation(iconTile, 'list-action-row')\n    : null;\n  const iconSize = tile?.tile ? 32 : 18;\n\n  return (\n    <div\n      {...extensionRootAttributes}\n      class={`kui-list-action-row ${className}`.trim()}\n      data-component=\"list-action-row\"\n      data-item-id={itemId}\n      data-has-icon={String(Boolean(icon))}\n      data-icon-tile={tile?.tile}\n      data-icon-tile-tone={tile?.tone}\n      data-multiline={multiline ? 'true' : undefined}\n      data-density={density}\n      data-divider={divider}\n      data-busy={busy ? 'true' : undefined}\n      data-trailing-visibility={trailingActionVisibility}\n      data-state={state}\n      data-selected={String(selected)}\n      data-pressed={pressed === undefined ? undefined : String(pressed)}\n      data-placeholder={placeholder ? 'true' : undefined}\n      draggable={nativeDraggable(draggable, placeholder)}\n      data-dragging={dragging ? 'true' : undefined}\n      data-drop-position={dropPosition}\n      aria-busy={placeholder || busy ? 'true' : undefined}\n      slot={slot}\n    >\n      <button\n        type=\"button\"\n        class=\"kui-list-action-row__primary\"\n        title={placeholder ? undefined : title}\n        disabled={disabled || placeholder}\n        tabindex={placeholder ? -1 : tabIndex}\n        data-kui-disabled={disabled ? 'true' : undefined}\n        data-action={placeholder ? undefined : action}\n        data-item-id={itemId}\n        aria-label={accessibleLabel}\n        aria-current={selected ? 'page' : undefined}\n        aria-pressed={pressed === undefined ? undefined : String(pressed)}\n      >\n        {icon && (\n          <span\n            class=\"kui-list-action-row__icon\"\n            style={placeholder ? undefined : tile?.style}\n          >\n            {placeholder ? (\n              <Skeleton\n                block\n                width={remify(iconSize)}\n                height={remify(iconSize)}\n              />\n            ) : (\n              icon\n            )}\n          </span>\n        )}\n        <span class=\"kui-list-action-row__label\">\n          <span class=\"kui-list-action-row__primary-label\">\n            {placeholder ? (\n              <Skeleton width={em(9)} />\n            ) : multiline ? (\n              withWordBreaks(label)\n            ) : (\n              label\n            )}\n          </span>\n          {description && (\n            <span class=\"kui-list-action-row__description\">\n              {placeholder ? <Skeleton width={em(11)} /> : description}\n            </span>\n          )}\n          {(busy || status) && (\n            <span class=\"kui-list-action-row__status\">\n              {/* The busy spinner is component-owned chrome drawn from a\n                  known prop, so a placeholder keeps it live; only the status\n                  text is a value and becomes a skeleton. */}\n              {busy && <LoadingSpinner />}\n              {status && (placeholder ? <Skeleton width={em(6)} /> : status)}\n            </span>\n          )}\n        </span>\n      </button>\n      {trailingMenu ? (\n        <PopupMenu\n          label={trailingMenu.label}\n          icon={trailingMenu.icon}\n          items={trailingMenu.items}\n          placement={trailingMenu.placement ?? 'bottom-end'}\n          caret={false}\n          disabled={Boolean(trailingMenu.disabled) || placeholder}\n        />\n      ) : (\n        <button\n          {...extensionTrailingAttributes}\n          type=\"button\"\n          class=\"kui-list-action-row__trailing-action\"\n          data-action={placeholder ? undefined : trailingAction}\n          data-item-id={itemId}\n          aria-label={trailingActionLabel}\n          title={trailingActionTitle ?? trailingActionLabel}\n          disabled={trailingActionDisabled || placeholder || undefined}\n          data-kui-disabled={trailingActionDisabled ? 'true' : undefined}\n        >\n          {trailingActionIcon}\n        </button>\n      )}\n    </div>\n  );\n}\n"]}

package/dist/chunk-SQ5DH66U.js

@@ -0,0 +1,37 @@
+// src/shared/layout/scroll-edge.ts
+function scrollEdgeAttributes(edge, distance, enabled) {
+  if (!enabled || edge === "none")
+    return {
+      "data-scroll-edge": void 0,
+      "data-scroll-edge-distance": void 0
+    };
+  return {
+    "data-scroll-edge": edge,
+    "data-scroll-edge-distance": distance === void 0 || !(distance > 0) ? void 0 : String(distance)
+  };
+}
+
+// src/shared/styles/surface-tint.ts
+function surfaceTintAttributes(tint) {
+  if (tint === void 0)
+    return {
+      "data-kui-tint": void 0,
+      "data-kui-tint-accent": void 0,
+      className: "",
+      style: void 0
+    };
+  return {
+    "data-kui-tint": tint.scheme,
+    "data-kui-tint-accent": tint.accent === void 0 ? void 0 : "",
+    className: `wa-${tint.scheme}`,
+    style: tint.accent === void 0 ? `--_kui-tint-color:${tint.color}` : `--_kui-tint-color:${tint.color};--_kui-tint-accent:${tint.accent}`
+  };
+}
+function joinStyles(...declarations) {
+  const present = declarations.filter((value) => value !== void 0);
+  return present.length === 0 ? void 0 : present.join(";");
+}
+
+export { joinStyles, scrollEdgeAttributes, surfaceTintAttributes };
+
+//# sourceMappingURL=chunk-SQ5DH66U.js.map

package/dist/chunk-SQ5DH66U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/layout/scroll-edge.ts","../src/shared/styles/surface-tint.ts"],"names":[],"mappings":";AAaO,SAAS,oBAAA,CACd,IAAA,EACA,QAAA,EACA,OAAA,EAIA;AACA,EAAA,IAAI,CAAC,WAAW,IAAA,KAAS,MAAA;AACvB,IAAA,OAAO;AAAA,MACL,kBAAA,EAAoB,MAAA;AAAA,MACpB,2BAAA,EAA6B;AAAA,KAC/B;AACF,EAAA,OAAO;AAAA,IACL,kBAAA,EAAoB,IAAA;AAAA,IACpB,2BAAA,EACE,aAAa,MAAA,IAAa,EAAE,WAAW,CAAA,CAAA,GAAK,MAAA,GAAY,OAAO,QAAQ;AAAA,GAC3E;AACF;;;ACLO,SAAS,sBAAsB,IAAA,EAOpC;AACA,EAAA,IAAI,IAAA,KAAS,MAAA;AACX,IAAA,OAAO;AAAA,MACL,eAAA,EAAiB,MAAA;AAAA,MACjB,sBAAA,EAAwB,MAAA;AAAA,MACxB,SAAA,EAAW,EAAA;AAAA,MACX,KAAA,EAAO;AAAA,KACT;AACF,EAAA,OAAO;AAAA,IACL,iBAAiB,IAAA,CAAK,MAAA;AAAA,IACtB,sBAAA,EAAwB,IAAA,CAAK,MAAA,KAAW,MAAA,GAAY,MAAA,GAAY,EAAA;AAAA,IAChE,SAAA,EAAW,CAAA,GAAA,EAAM,IAAA,CAAK,MAAM,CAAA,CAAA;AAAA,IAC5B,KAAA,EACE,IAAA,CAAK,MAAA,KAAW,MAAA,GACZ,CAAA,kBAAA,EAAqB,IAAA,CAAK,KAAK,CAAA,CAAA,GAC/B,CAAA,kBAAA,EAAqB,IAAA,CAAK,KAAK,CAAA,oBAAA,EAAuB,KAAK,MAAM,CAAA;AAAA,GACzE;AACF;AAGO,SAAS,cACX,YAAA,EACiB;AACpB,EAAA,MAAM,UAAU,YAAA,CAAa,MAAA,CAAO,CAAC,KAAA,KAAU,UAAU,MAAS,CAAA;AAClE,EAAA,OAAO,QAAQ,MAAA,KAAW,CAAA,GAAI,MAAA,GAAY,OAAA,CAAQ,KAAK,GAAG,CAAA;AAC5D","file":"chunk-SQ5DH66U.js","sourcesContent":["/**\n * What clear (fully transparent) chrome fades in as content scrolls beneath\n * it: `none` stays clear; `material` fades in the translucent chrome\n * material; `surface` fades in the opaque surface. The fade tracks the scroll\n * over `scrollEdgeDistance` (opacity only), from the scroll state\n * `wireScrollDividers` reports; unwired, the chrome stays clear.\n */\nexport type ScrollEdge = 'none' | 'material' | 'surface';\n\n/** The default scroll distance, in CSS pixels, a scroll edge fades in over. */\nexport const DEFAULT_SCROLL_EDGE_DISTANCE = 60;\n\n/** The root attributes a component with a scroll edge renders. */\nexport function scrollEdgeAttributes(\n  edge: ScrollEdge,\n  distance: number | undefined,\n  enabled: boolean,\n): {\n  'data-scroll-edge': 'material' | 'surface' | undefined;\n  'data-scroll-edge-distance': string | undefined;\n} {\n  if (!enabled || edge === 'none')\n    return {\n      'data-scroll-edge': undefined,\n      'data-scroll-edge-distance': undefined,\n    };\n  return {\n    'data-scroll-edge': edge,\n    'data-scroll-edge-distance':\n      distance === undefined || !(distance > 0) ? undefined : String(distance),\n  };\n}\n","import type { CssColor } from './css-values.js';\n\n/** The color scheme an app declares for a {@link SurfaceTint}'s color. */\nexport type SurfaceTintScheme = 'light' | 'dark';\n\n/**\n * A scoped tint for a layout surface: the app's color (usually sampled from\n * artwork it already knows) and the scheme that color belongs to. Kerf does no\n * color detection; `scheme` says whether the color reads as a light or a dark\n * surface. Inside the scope the surface, raised surface, text, quiet text, and\n * everything built on them (quiet fills, separators' backdrop, the chrome\n * material) re-derive from the color, with lightness clamped so text keeps\n * WCAG AA over any color.\n */\nexport interface SurfaceTint {\n  color: CssColor;\n  scheme: SurfaceTintScheme;\n  /**\n   * An optional accent (usually the artwork's most vivid color). The scope's\n   * brand ramp re-derives from it: loud fills and their text, brand text and\n   * links, text on brand fills, and the focus ring, each clamped to keep AA.\n   */\n  accent?: CssColor;\n}\n\n/** The root attributes a tinted surface renders. */\nexport function surfaceTintAttributes(tint: SurfaceTint | undefined): {\n  'data-kui-tint': SurfaceTintScheme | undefined;\n  'data-kui-tint-accent': '' | undefined;\n  /** The Web Awesome scheme class, so its theme re-derives in the scope. */\n  className: string;\n  /** The inline declaration carrying the color, or `undefined`. */\n  style: string | undefined;\n} {\n  if (tint === undefined)\n    return {\n      'data-kui-tint': undefined,\n      'data-kui-tint-accent': undefined,\n      className: '',\n      style: undefined,\n    };\n  return {\n    'data-kui-tint': tint.scheme,\n    'data-kui-tint-accent': tint.accent === undefined ? undefined : '',\n    className: `wa-${tint.scheme}`,\n    style:\n      tint.accent === undefined\n        ? `--_kui-tint-color:${tint.color}`\n        : `--_kui-tint-color:${tint.color};--_kui-tint-accent:${tint.accent}`,\n  };\n}\n\n/** Join inline declarations, omitting absent ones. */\nexport function joinStyles(\n  ...declarations: (string | undefined)[]\n): string | undefined {\n  const present = declarations.filter((value) => value !== undefined);\n  return present.length === 0 ? undefined : present.join(';');\n}\n"]}

package/dist/chunk-TDMHA7C3.js

@@ -0,0 +1,251 @@
+// 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, .kui-icon-toggle-button"))
+    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-TDMHA7C3.js.map

package/dist/chunk-TDMHA7C3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/integrations/webawesome/help-tags/install-help-tag.ts"],"names":[],"mappings":"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","file":"chunk-TDMHA7C3.js","sourcesContent":["// Hover and keyboard-focus help tags for icon-only controls.\n//\n// An icon-only `Select` (single `selectedPresentation=\"icon-only\"` or the\n// multiple `triggerIcon` filter), an icon-only `PopupMenu` (a `label` instead\n// of visible `text`), and an icon-only `<button>` or link inside a\n// `ToolbarControlGroup` (named only by `aria-label`) carry their purpose — and\n// a Select its current choice — only in the accessible name. Sighted pointer\n// and keyboard users see just the icon, so the registration boundary shows a\n// Web Awesome `wa-tooltip` naming the control (Apple HIG \"help tag\"):\n//\n// - after a short hover delay, or immediately when a previous tag just closed\n//   (moving along a toolbar), and at once on keyboard (`:focus-visible`) focus;\n// - never while the control's popup is open, and not again after a press or\n//   Escape until the pointer or focus leaves and returns;\n// - with the same text the accessible name already announces, so the tag is\n//   `aria-hidden` and never joins the control's `aria-labelledby` (a manual\n//   trigger with a programmatic anchor, not `for`, so Web Awesome does not\n//   add it) — assistive technology hears the name once.\n//\n// A Select's or PopupMenu's tag lives in the control's open shadow root, so\n// the morph never sees it, `:has([open])` selectors on the light DOM ignore\n// it, and it inherits the control's theme. A plain button cannot host a shadow\n// root, so its tag lives in one body-level layer (re-attached if a body morph\n// drops it, and removed again once hidden) and copies the button's\n// `color-scheme`; the tag's Popover-API popup renders in the top layer, so its\n// place in the document does not affect where or above what it shows. A\n// button that already has a native `title`, or a Web Awesome tooltip `for` it,\n// keeps that and gets no second tag. Each tag's own lifecycle events stop at\n// the tag so an application listening for the control's `wa-show` / `wa-hide`\n// never hears the tag's.\n\n/** Hover delay before a help tag appears. */\nexport const HELP_TAG_SHOW_DELAY = 500;\n/** After a tag closes, a neighboring trigger shows its tag at once for this long. */\nexport const HELP_TAG_WARM_WINDOW = 400;\n/** A tag shifted inward stays this far from the viewport edge. */\nexport const HELP_TAG_VIEWPORT_MARGIN = 8;\n\ninterface HelpTagHost extends HTMLElement {\n  open?: boolean;\n  selectedOptions?: readonly (HTMLElement & { label?: string })[];\n}\n\ninterface HelpTag extends HTMLElement {\n  open: boolean;\n  readonly updateComplete: Promise<unknown>;\n  anchor: Element | null;\n  trigger: string;\n  placement: string;\n}\n\nexport interface HelpTagOptions {\n  /** Whether a newly focused element shows keyboard focus. */\n  focusVisible?: (element: Element) => boolean;\n}\n\nconst LIFECYCLE_EVENTS = [\n  'wa-show',\n  'wa-after-show',\n  'wa-hide',\n  'wa-after-hide',\n] as const;\n\nconst installed = new WeakSet<Document>();\n\nfunction isFocusVisible(element: Element): boolean {\n  try {\n    return element.matches(':focus-visible');\n  } catch {\n    return false;\n  }\n}\n\nconst MENU_LABEL = ':scope > [slot=\"trigger\"] .kui-popup-menu__label';\n\n/** A plain control (not a Web Awesome popup host) gets a body-layer tag. */\nconst isPlainControl = (host: HelpTagHost): boolean =>\n  host.localName === 'button' || host.localName === 'a';\n\n/** An element's text with whitespace collapsed (an element's is never null). */\nconst words = (node: Element): string =>\n  (node.textContent as string).replace(/\\s+/g, ' ').trim();\n\n/** The trimmed `aria-label` of a plain control. */\nconst ariaLabel = (control: Element): string =>\n  (control.getAttribute('aria-label') ?? '').replace(/\\s+/g, ' ').trim();\n\n/**\n * An icon-only toolbar button or link (inside a `ToolbarControlGroup`) or an\n * `IconToggleButton`: named by `aria-label`, with no visible text, and without\n * a native `title` or a Web Awesome tooltip of its own that a second tag would\n * duplicate.\n */\nfunction isToolbarIconControl(target: HTMLElement): boolean {\n  if (!target.matches('button, a[href]')) return false;\n  if (!ariaLabel(target) || target.hasAttribute('title') || words(target))\n    return false;\n  if (!target.closest('.kui-toolbar-control-group, .kui-icon-toggle-button'))\n    return false;\n  return !(\n    target.id &&\n    target.ownerDocument.querySelector(\n      `wa-tooltip[for=\"${CSS.escape(target.id)}\"]`,\n    )\n  );\n}\n\n/** The icon-only Kerf control on an event path, if any. */\nfunction helpTagHost(path: readonly EventTarget[]): HelpTagHost | null {\n  for (const target of path) {\n    if (!(target instanceof HTMLElement)) continue;\n    if (isToolbarIconControl(target)) return target;\n    const { component, selectedPresentation } = target.dataset;\n    if (\n      component === 'select' &&\n      target.localName === 'wa-select' &&\n      selectedPresentation === 'icon-only'\n    )\n      return target;\n    if (component === 'popup-menu' && target.querySelector(MENU_LABEL))\n      return target;\n  }\n  return null;\n}\n\n/** The visible trigger the tag describes and anchors to. */\nfunction anchorOf(host: HelpTagHost): Element | null {\n  if (isPlainControl(host)) return host;\n  if (host.dataset.component === 'select')\n    return host.shadowRoot?.querySelector('[part~=\"combobox\"]') ?? null;\n  return host.querySelector(':scope > [slot=\"trigger\"]');\n}\n\n/** The tag text: the same words as the trigger's accessible name. */\nfunction helpText(host: HelpTagHost): string {\n  if (isPlainControl(host)) return ariaLabel(host);\n  // An icon-only PopupMenu's visually hidden label, or a multiple icon\n  // trigger's label slot (it already ends with the chosen labels).\n  const label =\n    host.querySelector(MENU_LABEL) ??\n    host.querySelector(':scope > [slot=\"label\"]');\n  if (label) return words(label);\n  const name = host.getAttribute('label') ?? '';\n  const chosen = host.selectedOptions?.[0];\n  const choice = chosen ? chosen.label || words(chosen) : '';\n  return choice && choice !== name ? `${name}: ${choice}` : name;\n}\n\n/**\n * Install once at an explicit registration boundary. Idempotent per document.\n */\nexport function installHelpTags(\n  doc: Document = document,\n  { focusVisible = isFocusVisible }: HelpTagOptions = {},\n): void {\n  if (installed.has(doc)) return;\n  installed.add(doc);\n  const tags = new WeakMap<HelpTagHost, HelpTag>();\n  let hovered: HelpTagHost | null = null;\n  let focused: HelpTagHost | null = null;\n  // The trigger whose tag is open, with that tag.\n  let shown: { host: HelpTagHost; tag: HelpTag } | null = null;\n  // A press, Escape, or an opened popup suppresses that trigger's tag.\n  let dismissed: HelpTagHost | null = null;\n  let timer: number | undefined;\n  let warmUntil = 0;\n  let layer: HTMLElement | null = null;\n\n  // The body-level home of plain controls' tags. Its fixed, zero-size box\n  // keeps it out of a grid or flex body's flow; a body morph that drops it is\n  // repaired on the next show.\n  const layerRoot = (): HTMLElement => {\n    if (!layer) {\n      layer = doc.createElement('div');\n      layer.className = 'kui-help-tag-layer';\n      layer.setAttribute('aria-hidden', 'true');\n      layer.setAttribute('data-morph-skip', '');\n      Object.assign(layer.style, {\n        position: 'fixed',\n        top: '0',\n        left: '0',\n        width: '0',\n        height: '0',\n      });\n    }\n    if (!layer.isConnected) doc.body.append(layer);\n    return layer;\n  };\n\n  const tagFor = (host: HelpTagHost): HelpTag | null => {\n    const plain = isPlainControl(host);\n    const root = plain ? layerRoot() : host.shadowRoot;\n    if (!root) return null;\n    let tag = tags.get(host);\n    if (!tag) {\n      tag = doc.createElement('wa-tooltip') as HelpTag;\n      tag.className = 'kui-help-tag';\n      tag.setAttribute('aria-hidden', 'true');\n      tag.setAttribute('trigger', 'manual');\n      tag.setAttribute('placement', 'bottom');\n      tag.style.pointerEvents = 'none';\n      for (const type of LIFECYCLE_EVENTS)\n        tag.addEventListener(type, (event) => event.stopPropagation());\n      if (plain) {\n        // A hidden button tag leaves the layer, so tags for buttons that a\n        // re-render replaced never accumulate there.\n        const created = tag;\n        created.addEventListener('wa-after-hide', () => {\n          if (created.open) return;\n          created.remove();\n          tags.delete(host);\n        });\n      }\n      root.append(tag);\n      tags.set(host, tag);\n    }\n    return tag;\n  };\n\n  const hide = (host: HelpTagHost) => {\n    if (shown?.host !== host) return;\n    shown.tag.open = false;\n    shown = null;\n    warmUntil = Date.now() + HELP_TAG_WARM_WINDOW;\n  };\n\n  const show = (host: HelpTagHost) => {\n    window.clearTimeout(timer);\n    timer = undefined;\n    if (host.open || dismissed === host || !host.isConnected) return;\n    const anchor = anchorOf(host);\n    const text = helpText(host);\n    if (!anchor || !text) return;\n    const tag = tagFor(host);\n    if (!tag) return;\n    if (shown) hide(shown.host);\n    // A body-layer tag takes its button's light or dark scheme, which a\n    // subtree theme (`.wa-dark`) may set below the document root.\n    if (anchor === host)\n      tag.style.colorScheme = window.getComputedStyle(host).colorScheme;\n    tag.anchor = anchor;\n    tag.textContent = text;\n    tag.open = true;\n    shown = { host, tag };\n    // A new tag's first update resets `anchor` from its (null) `for`. Its\n    // popup also keeps the standard 8px clear of the viewport edge when it\n    // shifts a long tag inward (Web Awesome's tooltip leaves this at 0).\n    void tag.updateComplete.then(() => {\n      if (tag.anchor !== anchor) tag.anchor = anchor;\n      const popup = tag.shadowRoot?.querySelector<\n        HTMLElement & { shiftPadding: number }\n      >('wa-popup');\n      if (popup) popup.shiftPadding = HELP_TAG_VIEWPORT_MARGIN;\n    });\n  };\n\n  /** The tagged host whose trigger (not its popup) is on the path. */\n  const triggerHost = (event: Event): HelpTagHost | null => {\n    const path = event.composedPath();\n    const host = helpTagHost(path);\n    if (!host) return null;\n    const anchor = anchorOf(host);\n    return anchor && path.includes(anchor) ? host : null;\n  };\n\n  // A pending hover belongs to the hovered trigger; a tag stays while either\n  // the pointer or keyboard focus is still on its trigger.\n  const leave = (host: HelpTagHost) => {\n    if (hovered !== host) {\n      window.clearTimeout(timer);\n      timer = undefined;\n    }\n    if (hovered !== host && focused !== host) hide(host);\n  };\n\n  // A press, Escape, or an opened popup dismisses a trigger's tag until the\n  // pointer moves onto something else while the popup is closed, or focus\n  // leaves the control.\n  const release = (host: HelpTagHost | null) => {\n    if (dismissed && dismissed !== host && !dismissed.open) dismissed = null;\n  };\n\n  doc.addEventListener(\n    'pointerover',\n    (event) => {\n      if ((event as PointerEvent).pointerType === 'touch') return;\n      const host = triggerHost(event);\n      release(host);\n      if (host === hovered) return;\n      const previous = hovered;\n      hovered = host;\n      if (previous) leave(previous);\n      if (!host || host.open || dismissed === host || shown?.host === host)\n        return;\n      window.clearTimeout(timer);\n      if (Date.now() < warmUntil) show(host);\n      else timer = window.setTimeout(() => show(host), HELP_TAG_SHOW_DELAY);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'pointerout',\n    (event) => {\n      // Leaving the window: nothing new is hovered.\n      if ((event as PointerEvent).relatedTarget !== null || !hovered) return;\n      const previous = hovered;\n      hovered = null;\n      leave(previous);\n    },\n    true,\n  );\n\n  // A pending hover show for this host re-checks the dismissal and no-ops.\n  const dismiss = (host: HelpTagHost) => {\n    dismissed = host;\n    hide(host);\n  };\n\n  doc.addEventListener(\n    'pointerdown',\n    (event) => {\n      const host = helpTagHost(event.composedPath());\n      if (host) dismiss(host);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'focusin',\n    (event) => {\n      // Only keyboard focus (`:focus-visible`) shows a tag; a click focuses\n      // the trigger without one.\n      const target = event.composedPath()[0];\n      const host =\n        target instanceof Element && focusVisible(target)\n          ? triggerHost(event)\n          : null;\n      if (host === focused) return;\n      const previous = focused;\n      focused = host;\n      if (previous) leave(previous);\n      if (host && dismissed !== host) show(host);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'focusout',\n    (event) => {\n      const host = helpTagHost(event.composedPath());\n      // Focus moving within the control (into its popup and back) is handled\n      // by focusin; only focus leaving the control ends a dismissal.\n      const next = (event as FocusEvent).relatedTarget;\n      if (!host || (next instanceof Node && host.contains(next))) return;\n      if (dismissed === host) dismissed = null;\n      if (host !== focused) return;\n      focused = null;\n      leave(host);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'keydown',\n    (event) => {\n      if (event.key === 'Escape' && shown) dismiss(shown.host);\n    },\n    true,\n  );\n\n  // Opening the popup hides the tag: the menu itself now shows the choices.\n  doc.addEventListener(\n    'wa-show',\n    (event) => {\n      const host = helpTagHost(event.composedPath());\n      if (host && event.composedPath()[0] === host) dismiss(host);\n    },\n    true,\n  );\n\n  // Keep a visible tag's text in step with the selection.\n  const refresh = (event: Event) => {\n    const host = helpTagHost(event.composedPath());\n    if (shown && host === shown.host) shown.tag.textContent = helpText(host);\n  };\n  doc.addEventListener('change', refresh, true);\n  doc.addEventListener('input', refresh, true);\n}\n"]}