@edux-design/tree-select 0.2.4 → 0.3.0

package/docs/DS15_INVENTORY.md

@@ -0,0 +1,52 @@
+# DS15 interaction inventory
+
+Inspected 29 October 2026 against Payload's installed public TreeSelect 0.2.5
+and the local Edux source. Payload files were read only.
+
+| Host | Interaction and local ownership | Replacement boundary |
+| --- | --- | --- |
+| Manuscripts `ManuScriptNavigationTree` | Delegated row click resolves domain metadata and aborts previous asynchronous editor navigation; filtered trees disable reordering. `onDataChange` consumes exact drag metadata. | `onNodeActivate` ID resolves existing metadata. Keep editor readiness, abort controllers and reorder transactions local. |
+| Curricula `CurriculaBuilderPanel` | Delegated click opens node editor. Labels are not inline editable at any configured level; add/delete and multi-drag remain active. | `onNodeActivate`; keep mutations, expansion and selection of domain editor local. |
+| Book Setup `PageBuilderBookSetupNavigationPanel` | Filtered content block tree delegates IDs to section/view changes. Rich labels include icons. | `onNodeActivate`, `currentId`, accessible name override and public row/label classes. Keep filtering and view/section routing local. |
+| Rights `PermissionsWorkspaceSourceNavigation` | Rich labels contain focusable role-button and status tooltip; selected label ref locates private ancestor for nearest scroll. | Row activation/current state, `getItemLabel`, imperative `scrollToItem`; remove nested navigation button. Keep source permissions/status/search local. |
+| Rights `PermissionsWorkspaceAssetNavigation` | Rich label role-button duplicates keyboard navigation; selected label ref scrapes ancestor for scroll. | Row activation/current state, `getItemLabel`, `scrollToItem`; remove nested navigation button. Keep asset mapping/search local. |
+
+Also inspected `pages/PageBuilderBookSetupEdit`: its debug summary and section
+handler scrape row IDs from DOM events, but the handler already accepts a string
+ID. Passing the activation ID at the navigation-panel boundary removes the event
+lookup without moving debug logging or section routing into Edux. No host source
+is modified by this package task.
+
+## Compatibility baseline
+
+The registry 0.2.5 archive matches the source interaction baseline. Existing
+tracked source token work (`be4a9b2`) replaces registry raw state colours/drop
+indicator/shadow classes with semantic equivalents; DS15 retains that source
+baseline and introduces no tokens or further geometry changes. Payload's
+installed 0.2.5 runtime is locally patched and has
+roving row focus, tree/treeitem roles, level/position/set-size attributes,
+`aria-selected` for multi-drag, labelled edit/toggle/move controls and keyboard
+arrow/Home/End/F2 handling. Source and registry lack these. The extension adds supported equivalents while
+preserving registry geometry, data operations and drag metadata.
+
+The installed runtime also uses `--theme-radius` and `--theme-hover-surface`
+fallbacks and `data-selected`; these are local patch hooks, not registry APIs.
+The extension retains source semantic token styling and registry geometry; it
+does not adopt the local theme variable overrides. Public current/selection
+context and row/label classes replace host styling selectors.
+
+## Interaction decisions
+
+- Current item is controlled by `currentId`. Activation never changes it implicitly;
+  hosts can wait for navigation success. `aria-current="page"` expresses current
+  location; `aria-selected` continues to mean drag selection.
+- Plain row pointer clicks and row Enter/Space activate once. Ctrl/Meta/Shift/Alt
+  suppress activation; Ctrl/Meta/Shift retain existing multi-selection behaviour.
+- `defaultPrevented`, editable inputs, row controls and interactive custom label
+  descendants suppress activation. Pointer selection from a drag handle never
+  invokes navigation. Keyboard events from descendants stay with that control.
+- Visible row access is explicit: get element, focus and scroll. Collapsed,
+  filtered and removed targets return null/false. No method implicitly expands
+  or changes current item, selection, routing or domain data.
+- Rich labels need an accessible name: use `getItemLabel(node)`; fallback is a
+  string/number label, otherwise the stable normalised ID.

package/docs/DS15_VERIFICATION.md

@@ -0,0 +1,62 @@
+# DS15 package verification
+
+Verified 29 October 2026. The primary registry baseline was read from
+`/private/tmp/edux-ds14-26-20261029/public-baselines/tree-select/package`.
+Payload's installed 0.2.5 is a locally modified preview and is not used as proof
+of registry capability. See [inventory](DS15_INVENTORY.md).
+
+## Public contract
+
+`onNodeActivate({id,node,event,inputSource,depth,parentId,hasChildren})`, controlled
+`currentId`, rich accessible names through `getItemLabel`, row/label class slots,
+label state/context and a forwarded `TreeSelectHandle` are additive. The handle
+exposes `getRowElement`, `focusItem` and `scrollToItem`; missing targets never
+expand or navigate. Native root div attributes/events remain available; the ref
+is explicitly an imperative handle rather than a div.
+
+Mutation output is `TreeSelectNode[]` with unknown extension metadata because
+built-in add operations create only id/label nodes. Activation/render contexts
+retain the supplied subtype. Hosts validate/enrich created data themselves.
+Existing mutation helpers and reorder metadata have not changed.
+
+## Checks completed
+
+- `npm run build --workspace=@edux-design/tree-select`: ESM, CJS and public
+  declarations built successfully from `src/index.ts`.
+- `npm run check-types --workspace=@edux-design/tree-select`: passed.
+- `npx eslint --config eslint.components.config.mjs packages/tree-select/src`:
+  passed with no warnings.
+- `npx vitest run packages/tree-select/src/elements`: 77 tests passed across
+  five files, including existing reorder/data/guard coverage and eight new
+  interaction tests. New coverage checks event payload/source, current versus
+  drag selection, cancellation, repeat keys, interactive children/status,
+  rename/actions isolation, collapsed/filtered/removed targets, focus/scroll
+  separation, ref cleanup/instance isolation and keyboard navigation.
+- Strict positive/negative public-declaration consumer
+  `test/interaction-api.tsx`: passed via the built workspace package. Covers
+  native root events, discriminated activation events, native row access,
+  imperative ref, generic node metadata, existing props and rejection of invalid
+  IDs/ref/events/labels/expansion/unknown props and unsound mutation metadata.
+- `node packages/tree-select/test/interaction-public-runtime.cjs`: passed ESM
+  and CJS public imports and SSR tree/current/name/level/root attribute output.
+- `npm exec --workspace=docs -- vitest run --config vite.config.ts
+  TreeSelectInteraction.stories`: five Chromium stories passed. Explicit
+  `axe.run` returned no violations for navigation, editing, modifier multi-drag,
+  narrow filtering and four light/dark/blue/teal theme combinations. Keyboard
+  activation/expansion, F2 editing and drag-handle navigation isolation were
+  exercised. Existing Tooltip async act warnings remain in browser logs.
+
+The first browser runs needed Vite's new dnd/axe dependencies to finish cache
+optimisation; the final completed run passed. Package owner checks use workspace
+builds. The coordinator owns the subsequent normal fresh-tarball installed
+public types/runtime/browser gate, versioning and combined Storybook run.
+No Payload source, manifests, lockfiles, versions, Changesets, publication or Git
+history were modified by this package worker. The coordinator changed the
+package build/dev entry to `src/index.ts`.
+
+## Remaining consumer boundary
+
+The named five hosts and PageBuilder parent still require migration and host
+regression acceptance. Private CSS-only selectors for per-node action suppression
+are outside this API; no per-node action policy API is claimed. Routing,
+permissions, filtering, editor cancellation and all mutations remain local.

package/package.json

@@ -1,27 +1,24 @@
 {
   "name": "@edux-design/tree-select",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "private": false,
   "sideEffects": [
     "**/*.css"
   ],
   "files": [
-    "dist"
+    "dist",
+    "docs",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     }
   },
-  "scripts": {
-    "lint": "eslint . --max-warnings 0",
-    "build": "tsup src/index.js --format esm,cjs --dts --external react,react-dom",
-    "dev": "tsup src/index.js --watch --format esm,cjs --dts --external react,react-dom",
-    "check-types": "tsc --noEmit"
-  },
   "dependencies": {
     "@dnd-kit/core": "6.3.1",
     "@dnd-kit/sortable": "^8.0.0",
@@ -36,9 +33,5 @@
   "peerDependencies": {
     "react": ">=18",
     "react-dom": ">=18"
-  },
-  "devDependencies": {
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.2"
   }
 }