@signal9/era-ui 25.0.0 → 25.1.0

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [25.1.0](https://github.com/sig-nine/era-ui/compare/v25.0.0...v25.1.0) (2026-08-12)
+
+### Features
+
+* **tree:** export ancestorPath standalone, and record the real scale number ([57650ca](https://github.com/sig-nine/era-ui/commit/57650ca9b7106afdc23ab9bdc02ae1a64c65fc55))
+
+### Bug Fixes
+
+* **test:** ancestorPath test runs in Node, not through a Vite import path ([20bae4e](https://github.com/sig-nine/era-ui/commit/20bae4e4b8330ae2e220f7243c53c343cfa0a39a))
+* **tree:** ancestorPath is its own runes-free module ([93e427d](https://github.com/sig-nine/era-ui/commit/93e427d715d58c4aa69f5d0fdfa38b167be8e3b0))
+
 ## [25.0.0](https://github.com/sig-nine/era-ui/compare/v24.0.3...v25.0.0) (2026-08-12)
 
 ### ⚠ BREAKING CHANGES

package/dist/eslint/index.js

@@ -65,7 +65,7 @@ export const rules = {
     'no-hardcoded-motion': makeRule('Take transition timing from the motion axis, not from a literal.', findHardcodedMotion)
 };
 const plugin = {
-    meta: { name: '@sig-nine/era-ui/eslint' },
+    meta: { name: '@signal9/era-ui/eslint' },
     rules,
     configs: {}
 };

package/dist/ui/tree/ancestor-path.d.ts

@@ -0,0 +1,22 @@
+import type { TreeNode } from './context.svelte.js';
+/**
+ * The ids of every ancestor of `id`, outermost first. Empty if not found.
+ *
+ * ITS OWN MODULE, WITH NO RUNES, on purpose. The whole claim of this function is
+ * that it needs no state, no context and no DOM — the commonest deep-link flow
+ * runs BEFORE a tree exists, turning a URL into the `expanded` array the
+ * component is handed on first render. Living in context.svelte.ts would have
+ * made it unimportable from a plain Node context (that file declares $state
+ * fields), and living in the barrel drags every .svelte component in with it.
+ * Same reasoning as docs/consumer-import.ts, which is standalone so the node doc
+ * builder can load it.
+ *
+ * A consumer previously had to construct a throwaway TreeState, assign nodes,
+ * call revealPath and discard the instance — "reaching around the component for
+ * something the component owns", as they put it. The giveaway is that the walk
+ * is pure over `nodes`.
+ *
+ * TreeState.revealPath is the stateful wrapper over this: one implementation,
+ * two surfaces.
+ */
+export declare function ancestorPath(nodes: TreeNode[], id: string): string[];

package/dist/ui/tree/ancestor-path.js

@@ -0,0 +1,36 @@
+/**
+ * The ids of every ancestor of `id`, outermost first. Empty if not found.
+ *
+ * ITS OWN MODULE, WITH NO RUNES, on purpose. The whole claim of this function is
+ * that it needs no state, no context and no DOM — the commonest deep-link flow
+ * runs BEFORE a tree exists, turning a URL into the `expanded` array the
+ * component is handed on first render. Living in context.svelte.ts would have
+ * made it unimportable from a plain Node context (that file declares $state
+ * fields), and living in the barrel drags every .svelte component in with it.
+ * Same reasoning as docs/consumer-import.ts, which is standalone so the node doc
+ * builder can load it.
+ *
+ * A consumer previously had to construct a throwaway TreeState, assign nodes,
+ * call revealPath and discard the instance — "reaching around the component for
+ * something the component owns", as they put it. The giveaway is that the walk
+ * is pure over `nodes`.
+ *
+ * TreeState.revealPath is the stateful wrapper over this: one implementation,
+ * two surfaces.
+ */
+export function ancestorPath(nodes, id) {
+    const path = [];
+    const find = (list, trail) => {
+        for (const n of list) {
+            if (n.id === id) {
+                path.push(...trail);
+                return true;
+            }
+            if (n.children?.length && find(n.children, [...trail, n.id]))
+                return true;
+        }
+        return false;
+    };
+    find(nodes, []);
+    return path;
+}

package/dist/ui/tree/context.svelte.d.ts

@@ -48,6 +48,13 @@ export declare class TreeState {
     /**
      * VISIBLE nodes in render order, which is also keyboard order.
      *
+     * The whole tree can be handed to `nodes`; only what is open gets flattened.
+     * Measured in the field on the catalog this was built for: 1,196 nodes in,
+     * ~58 visible, recomputed per render, comfortable with no windowing. That is
+     * a real number from a consumer rather than an estimate — their earlier cap
+     * of 162 was an artifact of the hand-rolled sidebar they replaced, which
+     * could only mount one family at a time.
+     *
      * Arrow keys move through what is on screen, not through the data — a
      * collapsed branch's children are not reachable by ↓ and must not be, or the
      * focus ring disappears into a closed subtree.
@@ -61,10 +68,11 @@ export declare class TreeState {
     /**
      * Open every ancestor of `id` so a deep link lands on a visible node.
      *
-     * Deep-linking is the reason `expanded` is controllable at all: a URL like
-     * /sp800-53r5/ac/ac-2.1 has to open AC and AC-2 before AC-2(1) exists on
-     * screen. Doing it from the consumer's side means re-deriving the path
-     * through the tree, which the tree already knows.
+     * Deep-linking is why `expanded` is controllable at all: a URL like
+     * /sp800-53r5/AC/ac-2.1 has to open AC and AC-2 before AC-2(1) exists on
+     * screen. This is the stateful half — it mutates `expanded` and notifies.
+     * The path computation itself is {@link ancestorPath}, which needs no state
+     * and is exported for callers who only want the ids.
      */
     revealPath(id: string): string[];
 }

package/dist/ui/tree/context.svelte.js

@@ -1,5 +1,6 @@
 import { getContext, setContext } from 'svelte';
 import { SvelteSet } from 'svelte/reactivity';
+import { ancestorPath } from './ancestor-path.js';
 export class TreeState {
     nodes = $state([]);
     // SvelteSet, so membership reads are tracked per-key rather than the whole
@@ -14,6 +15,13 @@ export class TreeState {
     /**
      * VISIBLE nodes in render order, which is also keyboard order.
      *
+     * The whole tree can be handed to `nodes`; only what is open gets flattened.
+     * Measured in the field on the catalog this was built for: 1,196 nodes in,
+     * ~58 visible, recomputed per render, comfortable with no windowing. That is
+     * a real number from a consumer rather than an estimate — their earlier cap
+     * of 162 was an artifact of the hand-rolled sidebar they replaced, which
+     * could only mount one family at a time.
+     *
      * Arrow keys move through what is on screen, not through the data — a
      * collapsed branch's children are not reachable by ↓ and must not be, or the
      * focus ring disappears into a closed subtree.
@@ -60,25 +68,14 @@ export class TreeState {
     /**
      * Open every ancestor of `id` so a deep link lands on a visible node.
      *
-     * Deep-linking is the reason `expanded` is controllable at all: a URL like
-     * /sp800-53r5/ac/ac-2.1 has to open AC and AC-2 before AC-2(1) exists on
-     * screen. Doing it from the consumer's side means re-deriving the path
-     * through the tree, which the tree already knows.
+     * Deep-linking is why `expanded` is controllable at all: a URL like
+     * /sp800-53r5/AC/ac-2.1 has to open AC and AC-2 before AC-2(1) exists on
+     * screen. This is the stateful half — it mutates `expanded` and notifies.
+     * The path computation itself is {@link ancestorPath}, which needs no state
+     * and is exported for callers who only want the ids.
      */
     revealPath(id) {
-        const path = [];
-        const find = (list, trail) => {
-            for (const n of list) {
-                if (n.id === id) {
-                    path.push(...trail);
-                    return true;
-                }
-                if (n.children?.length && find(n.children, [...trail, n.id]))
-                    return true;
-            }
-            return false;
-        };
-        find(this.nodes, []);
+        const path = ancestorPath(this.nodes, id);
         if (path.length) {
             for (const p of path)
                 this.expanded.add(p);

package/dist/ui/tree/index.d.ts

@@ -1,3 +1,4 @@
 export { default as Root } from './tree.svelte';
 export { default as Item } from './tree-item.svelte';
 export { TreeState, type TreeNode, type FlatNode } from './context.svelte.js';
+export { ancestorPath } from './ancestor-path.js';

package/dist/ui/tree/index.js

@@ -1,3 +1,4 @@
 export { default as Root } from './tree.svelte';
 export { default as Item } from './tree-item.svelte';
 export { TreeState } from './context.svelte.js';
+export { ancestorPath } from './ancestor-path.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@signal9/era-ui",
-	"version": "25.0.0",
+	"version": "25.1.0",
 	"scripts": {
 		"dev": "vite dev --host",
 		"build": "vite build && npm run prepack",
@@ -25,13 +25,14 @@
 		"check:classes": "node --experimental-strip-types scripts/check-classes.ts",
 		"check:twmerge": "node --experimental-strip-types scripts/check-twmerge.ts",
 		"build:llm-docs": "node --experimental-strip-types scripts/build-llm-docs.ts",
-		"prebuild": "npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run check:audit-controls && npm run check:specimen-coverage && npm run check:eslint-rules && npm run build:llm-docs",
-		"validate": "npm run check && npm run lint && npm run format:check && npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run check:audit-controls && npm run check:specimen-coverage && npm run check:eslint-rules",
+		"prebuild": "npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run check:audit-controls && npm run check:specimen-coverage && npm run check:eslint-rules && npm run check:package-name && npm run build:llm-docs",
+		"validate": "npm run check && npm run lint && npm run format:check && npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run check:audit-controls && npm run check:specimen-coverage && npm run check:eslint-rules && npm run check:package-name",
 		"test": "npm run test:visual",
 		"check:doc-tokens": "node --experimental-strip-types scripts/check-doc-tokens.ts",
 		"check:audit-controls": "node --experimental-strip-types scripts/check-audit-controls.ts",
 		"check:specimen-coverage": "node --experimental-strip-types scripts/check-specimen-coverage.ts",
-		"check:eslint-rules": "node --experimental-strip-types scripts/check-eslint-rules.ts"
+		"check:eslint-rules": "node --experimental-strip-types scripts/check-eslint-rules.ts",
+		"check:package-name": "node --experimental-strip-types scripts/check-package-name.ts"
 	},
 	"files": [
 		"dist",

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: era-ui
 description: |
-  Design-system methodology for building UIs with @sig-nine/era-ui (Svelte 5 +
+  Design-system methodology for building UIs with @signal9/era-ui (Svelte 5 +
   Tailwind v4). Use when: writing or reviewing any component, layout, or page
   in a project that uses era-ui — sizing controls, spacing/padding, radii,
   surfaces, motion, or composing library components. Covers: the named class
@@ -167,7 +167,7 @@ Not everything era exposes is a component — these ride along with the styleshe
 and need no import. Reach for one before hand-rolling the same styling or bending
 a component into the role. Full reference (including every named scale above):
 `/utilities.md`; machine-readable list: `/utilities.json` (or
-`@sig-nine/era-ui/utilities.json`).
+`@signal9/era-ui/utilities.json`).
 
 | Class                | Use it for                                                                                                             |
 | -------------------- | ---------------------------------------------------------------------------------------------------------------------- |
@@ -183,8 +183,8 @@ a component into the role. Full reference (including every named scale above):
 
 ```svelte
 <script lang="ts">
-	import { Button, Badge, OS, AI } from '@sig-nine/era-ui';
-	import * as Select from '@sig-nine/era-ui'; // namespaced parts: Select.Root…
+	import { Button, Badge, OS, AI } from '@signal9/era-ui';
+	import * as Select from '@signal9/era-ui'; // namespaced parts: Select.Root…
 </script>
 ```
 
@@ -192,7 +192,7 @@ a component into the role. Full reference (including every named scale above):
   through; style via `class` (merged with tailwind-merge, consumer wins — the
   named classes conflict-resolve against internals, so `class="h-bar"` on a
   control-tier control just works).
-- `OS` (or `@sig-nine/era-ui/os`): WindowManager + workspaces, Desktop,
+- `OS` (or `@signal9/era-ui/os`): WindowManager + workspaces, Desktop,
   Window, Taskbar (built-in command bar). `AI` (or `/ai`): Conversation,
   Message, Response, PromptInput, Tool/Reasoning/Task over the Step primitive.
 - List-item keyboard highlight is `data-[highlighted]:bg-hover` — never