@llui/components 0.0.13 → 0.0.14

package/dist/utils/tree-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-collection.js","sourceRoot":"","sources":["../../src/utils/tree-collection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TreeCollection — helper for building tree-view payloads from a nested\n * data structure. Tree-view's state machine only knows about flat lists\n * (visibleItems, visibleLabels) and opaque ids; the collection owns the\n * structure and derives those flat arrays on demand.\n *\n * Typical flow:\n *\n *   const col = new TreeCollection(data)\n *   state.visibleItems = col.visibleItems(state.expanded)\n *   state.visibleLabels = col.visibleLabels(state.expanded)\n *\n * After every `expand` / `collapse` message, the consumer dispatches\n * `setVisibleItems` with the updated arrays. The collection itself is\n * immutable — build a new one when the tree structure changes.\n */\n\nexport interface TreeNode {\n  id: string\n  label?: string\n  disabled?: boolean\n  children?: TreeNode[]\n}\n\ninterface NodeInfo {\n  node: TreeNode\n  parentId: string | null\n  depth: number\n  childIds: string[]\n}\n\nexport class TreeCollection {\n  readonly roots: TreeNode[]\n  private readonly info: Map<string, NodeInfo>\n\n  constructor(roots: TreeNode | TreeNode[]) {\n    this.roots = Array.isArray(roots) ? roots : [roots]\n    this.info = new Map()\n    this.index()\n  }\n\n  private index(): void {\n    const walk = (node: TreeNode, parentId: string | null, depth: number): void => {\n      const children = node.children ?? []\n      this.info.set(node.id, {\n        node,\n        parentId,\n        depth,\n        childIds: children.map((c) => c.id),\n      })\n      for (const child of children) walk(child, node.id, depth + 1)\n    }\n    for (const root of this.roots) walk(root, null, 0)\n  }\n\n  /** All ids in the collection, in depth-first order. */\n  get allIds(): string[] {\n    return Array.from(this.info.keys())\n  }\n\n  getNode(id: string): TreeNode | null {\n    return this.info.get(id)?.node ?? null\n  }\n\n  getLabel(id: string): string {\n    const node = this.getNode(id)\n    return node?.label ?? id\n  }\n\n  getParent(id: string): string | null {\n    return this.info.get(id)?.parentId ?? null\n  }\n\n  getDepth(id: string): number {\n    return this.info.get(id)?.depth ?? 0\n  }\n\n  getChildren(id: string): string[] {\n    return this.info.get(id)?.childIds ?? []\n  }\n\n  /** All descendants of id in depth-first order (excluding id itself). */\n  getDescendants(id: string): string[] {\n    const out: string[] = []\n    const walk = (current: string): void => {\n      for (const childId of this.getChildren(current)) {\n        out.push(childId)\n        walk(childId)\n      }\n    }\n    walk(id)\n    return out\n  }\n\n  isBranch(id: string): boolean {\n    return this.getChildren(id).length > 0\n  }\n\n  isDisabled(id: string): boolean {\n    return this.info.get(id)?.node.disabled === true\n  }\n\n  /**\n   * The ordered list of visible item ids given a set of expanded branches.\n   * A branch's descendants appear only if every ancestor up to a root is\n   * in `expanded`.\n   */\n  visibleItems(expanded: string[]): string[] {\n    const expandedSet = new Set(expanded)\n    const out: string[] = []\n    const walk = (nodes: TreeNode[]): void => {\n      for (const node of nodes) {\n        out.push(node.id)\n        if (expandedSet.has(node.id) && node.children) {\n          walk(node.children)\n        }\n      }\n    }\n    walk(this.roots)\n    return out\n  }\n\n  /** Parallel array of labels for `visibleItems()`, using `label ?? id`. */\n  visibleLabels(expanded: string[]): string[] {\n    return this.visibleItems(expanded).map((id) => this.getLabel(id))\n  }\n\n  /**\n   * Ids of all branches in the collection (useful for `expandAll`).\n   */\n  get branchIds(): string[] {\n    const out: string[] = []\n    for (const [id, info] of this.info) {\n      if (info.childIds.length > 0) out.push(id)\n    }\n    return out\n  }\n\n  /**\n   * Compute the indeterminate-set from a set of checked ids: any branch\n   * whose descendants are partially — but not fully — checked. Useful as\n   * a post-toggleChecked reconciler:\n   *\n   *   const indeterminate = col.computeIndeterminate(new Set(state.checked))\n   *   send({ type: 'setIndeterminate', ids: indeterminate })\n   */\n  computeIndeterminate(checked: Set<string>): string[] {\n    const out: string[] = []\n    for (const [id, info] of this.info) {\n      if (info.childIds.length === 0) continue\n      const desc = this.getDescendants(id)\n      if (desc.length === 0) continue\n      let checkedCount = 0\n      for (const d of desc) if (checked.has(d)) checkedCount++\n      if (checkedCount > 0 && checkedCount < desc.length) out.push(id)\n    }\n    return out\n  }\n}\n"]}

package/dist/utils/typeahead.js

@@ -79,3 +79,4 @@ export function isTypeaheadKey(e) {
         return false;
     return true;
 }
+//# sourceMappingURL=typeahead.js.map

package/dist/utils/typeahead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.js","sourceRoot":"","sources":["../../src/utils/typeahead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AAEvC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,IAAY,EACZ,GAAW,EACX,SAAiB;IAEjB,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAgB,EAChB,YAAuB,EACvB,KAAa,EACb,SAAwB;IAExB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1D,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IACvB,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,CAAC,CAAA;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,YAAY,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC/B,IAAI,MAAM,CAAC,GAAG,CAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;IAC1D,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAe,EACf,QAA2B,EAC3B,KAAa,EACb,SAAwB;IAExB,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;IACtB,MAAM,IAAI,GAAG,IAAI,KAAK,CAAU,CAAC,CAAC,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;IAClE,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,CAAgB;IAC7C,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACpD,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACpC,uEAAuE;IACvE,kEAAkE;IAClE,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,KAAK,CAAA;IAC/B,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/**\n * Typeahead search — accumulates keystrokes into a query while the user\n * types rapidly, then matches the first item whose label starts with the\n * query. Used by listbox, menu, select, combobox, tree-view to support\n * WAI-ARIA keyboard navigation patterns.\n *\n * Behavior:\n *   - If a keystroke arrives within `TYPEAHEAD_TIMEOUT_MS` of the previous\n *     one, append to the existing query (so typing \"sa\" finds \"Saturn\" even\n *     if the highlight is currently on \"Jupiter\").\n *   - Otherwise, start a fresh single-character query.\n *   - Single-character queries advance past the current position (jump to\n *     the *next* item starting with that letter), which is the standard\n *     WAI-ARIA behavior — rapid repeated presses of \"s\" cycle through\n *     items beginning with \"s\".\n *   - Multi-character queries search from the current cursor position\n *     (inclusive) so if the cursor is already on a matching item, it\n *     stays — typing \"ap\" while on \"apricot\" keeps focus on \"apricot\".\n */\n\nexport const TYPEAHEAD_TIMEOUT_MS = 500\n\n/**\n * Advance the typeahead query based on a new keystroke and the previous\n * expiration time. Returns the new query string; callers combine this with\n * `typeaheadMatch()` to produce a new highlight index.\n */\nexport function typeaheadAccumulate(\n  prev: string,\n  char: string,\n  now: number,\n  expiresAt: number,\n): string {\n  return now < expiresAt ? prev + char : char\n}\n\n/**\n * Find the first enabled item whose label starts with the query\n * (case-insensitive). `labels` and `disabledMask` are parallel arrays.\n * `startFrom` is the current highlighted index; for single-character\n * queries the search begins at `startFrom + 1` (so repeated \"s\" keys\n * cycle), for multi-character queries it begins at `startFrom` (inclusive).\n *\n * Returns the matching index, or `null` if no enabled item matches.\n */\nexport function typeaheadMatch(\n  labels: string[],\n  disabledMask: boolean[],\n  query: string,\n  startFrom: number | null,\n): number | null {\n  if (labels.length === 0 || query.length === 0) return null\n  const q = query.toLowerCase()\n  const offset = query.length === 1 ? 1 : 0\n  const n = labels.length\n  const start = startFrom ?? -1\n  for (let i = 0; i < n; i++) {\n    const idx = (start + offset + i + n) % n\n    if (disabledMask[idx]) continue\n    if (labels[idx]!.toLowerCase().startsWith(q)) return idx\n  }\n  return null\n}\n\n/**\n * Convenience: pass a `disabled` list of values instead of a boolean mask.\n * Builds the mask by checking membership via `===` on the raw string values.\n */\nexport function typeaheadMatchByItems(\n  items: string[],\n  disabled: readonly string[],\n  query: string,\n  startFrom: number | null,\n): number | null {\n  const n = items.length\n  const mask = new Array<boolean>(n)\n  for (let i = 0; i < n; i++) mask[i] = disabled.includes(items[i]!)\n  return typeaheadMatch(items, mask, query, startFrom)\n}\n\n/**\n * Returns true if the key event should trigger a typeahead query — i.e., a\n * single printable character that isn't a modified keyboard shortcut. Use\n * this in `onKeyDown` handlers to decide whether to dispatch a typeahead\n * message.\n */\nexport function isTypeaheadKey(e: KeyboardEvent): boolean {\n  if (e.ctrlKey || e.metaKey || e.altKey) return false\n  if (e.key.length !== 1) return false\n  // Whitespace isn't a typeahead character in most widgets — Space often\n  // activates the highlighted item. Let callers override if needed.\n  if (e.key === ' ') return false\n  return true\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/components",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -456,19 +456,13 @@
       "types": "./dist/styles/classes/tree-view.d.ts"
     }
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json && mkdir -p dist/styles && cp src/styles/theme.css src/styles/theme-dark.css dist/styles/",
-    "check": "tsc --noEmit -p tsconfig.check.json",
-    "lint": "eslint src",
-    "test": "vitest run"
-  },
   "peerDependencies": {
-    "@llui/dom": "^0.0.13"
+    "@llui/dom": "^0.0.14"
   },
   "devDependencies": {
-    "@llui/dom": "workspace:*",
     "typescript": "^6.0.0",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.2",
+    "@llui/dom": "0.0.14"
   },
   "sideEffects": [
     "./dist/styles/theme.css",
@@ -500,5 +494,11 @@
   "homepage": "https://github.com/fponticelli/llui/tree/main/packages/components#readme",
   "files": [
     "dist"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && mkdir -p dist/styles && cp src/styles/theme.css src/styles/theme-dark.css dist/styles/",
+    "check": "tsc --noEmit -p tsconfig.check.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}