@cosmicdrift/kumiko-framework 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @cosmicdrift/kumiko-framework
 
+## 0.4.0
+
+### Minor Changes
+
+- 825e7d2: Visual-Tree V.1.4 → V.1.6 — Feature-complete Editor + Folder-Hierarchy + Roving-tabindex.
+
+  **V.1.4** — explicit `folder?: string` Schema-Field auf text-block-entity. Slug bleibt
+  kebab-only validiert, Folder explizit gesetzt. Tree gruppiert via `groupBlocksByFolder`
+  (ersetzt `groupBlocksBySlugPrefix`). `Subscribe<T>` Signature um optional `emitError`
+  erweitert für explicit async-error-Pfade. ProviderBranch zeigt Error-Banner mit
+  Retry-Button. Drift-Test pinnt seedTextBlock-vs-set.write Slug-Validation.
+
+  **V.1.4b** — URL-State-Routing für Editor-Target via `nav.searchParams`. F5 + Back-Button
+  stellen den Editor-State wieder her. Format: `?t=text-content:edit&a_slug=...&a_lang=...`.
+  Plus `useDispatchTarget` hook ersetzt globalen `dispatchTarget` als empfohlenen Production-
+  Pfad (legacy bleibt für Test-Hooks).
+
+  **V.1.5** — Arrow-Key-Navigation (`<aside role="tree">`, ARIA-tree-Pattern) + SSE-driven
+  Tree-Refresh. `ClientFeatureDefinition.treeEntities?: string[]` listet Entity-Namen pro
+  Provider; live-events triggern provider-re-mount → Stale-Tree-state="stub"→"filled"
+  flippt nach save automatisch.
+
+  **V.1.5c+d** — Active-Node-Highlight (explicit blue + 2px border-l + scrollIntoView),
+  VS-Code-Polish (compact spacing, focus-visible, folder-icon-color text-amber, indent-
+  guides per ancestor-depth), Folder-Wrapper für legal-pages ("📁 Legal" + slug-first
+  Verschachtelung) und text-content ("📁 Content").
+
+  **V.1.6** — Multi-level Folder-Splitting (`folder="page/marketing"` → nested folders,
+  walk-or-create-pattern, folder/leaf-collision-tolerant). Roving-tabindex (nur focused-
+  treeitem hat tabIndex=0, Tab cyclt aus dem Tree raus).
+
+  35/35 kumiko check PASS, 13/13 group-blocks + 22/22 text-content integration tests grün.
+  Browser + Keyboard lokal validated.
+
+  **Breaking**: `TreeContext` Type entfernt (V.1.2 SR2-Rip — war nie genutzt). Provider sind
+  session-bound: `TreeChildrenSubscribe = () => Subscribe<T>` statt `(ctx) => Subscribe<T>`.
+
+  **V.1.7-Followups**: useEffect-deps in VisualTree-focus-init (Performance), Cancellation-
+  Token in TreeProvider's fetch (emit-after-unmount-warning), inline-rename, drag-drop,
+  file-icons per slug-extension, parent-jump bei ArrowLeft auf collapsed-item.
+
 ## 0.3.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -159,7 +159,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.3.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.4.0",
     "@types/uuid": "^11.0.0",
     "bun-types": "^1.3.13",
     "drizzle-kit": "^0.31.10",

package/src/engine/index.ts

@@ -293,7 +293,6 @@ export type {
   TreeActionDef,
   TreeActionsHandle,
   TreeChildrenSubscribe,
-  TreeContext,
   TreeNode,
   TreeNodeState,
   UnsafeAppendEventFn,

package/src/engine/types/feature.ts

@@ -573,9 +573,10 @@ export type FeatureRegistrar<TFeature extends string = string> = {
   // that emits the top-level Tree-Knoten when the Visual-Workspace
   // (navigation: "tree") mounts. At-most-one call per feature.
   //
-  // Provider receives a TreeContext (Phase-0-stub, opaque) and an
-  // emit-function; returns an unsubscribe-function. Initial-emit synchron
-  // oder async, weitere Emits beliebig oft (e.g. on entity-update SSE).
+  // Provider returns a Subscribe-Function (emit-fn → unsubscribe-fn).
+  // Initial-emit synchron oder async, weitere Emits beliebig oft (e.g.
+  // on entity-update SSE). Provider sind session-bound; tenantId fließt
+  // über die Backend-Session bei fetch/dispatch, nicht über ein ctx-Arg.
   //
   // A feature without r.tree() is invisible in `navigation: "tree"`-
   // workspaces — that's the Zero-Whitelist-Filter from visual-tree.md A2:

package/src/engine/types/identifiers.ts

@@ -1,4 +1,3 @@
-// @runtime client
 // Domain-identifier type aliases. Used everywhere a tenantId/userId/aggregateId
 // travels through the framework. One declaration per concept so future
 // representation changes (branded types, UUID validation, opaque wrappers)

package/src/engine/types/index.ts

@@ -218,7 +218,6 @@ export type {
   TreeActionDef,
   TreeActionsHandle,
   TreeChildrenSubscribe,
-  TreeContext,
   TreeNode,
   TreeNodeState,
 } from "./tree-node";

package/src/engine/types/tree-node.ts

@@ -23,7 +23,6 @@
 //
 // Siehe docs/plans/architecture/visual-tree.md A4.
 
-import type { TenantId } from "./identifiers";
 import type { TargetRef } from "./target-ref";
 
 export type TreeNodeState = "filled" | "stub" | "empty" | "loading" | "error";
@@ -75,25 +74,28 @@ export type TreeNode = {
 // Subscribe<T> — Provider implementiert: emit(initial); ...emit(updated);
 // und gibt unsubscribe-Function zurück. Caller (Tree-Component) ruft
 // unsubscribe auf wenn Knoten unmounted/eingeklappt wird.
-export type Subscribe<T> = (emit: (value: T) => void) => () => void;
+//
+// **V.1.4 emitError**: optional callback für async-error-Pfade (fetch-
+// fail, SSE-disconnect). Provider die explizit Errors signalisieren
+// wollen rufen `emitError(e)` statt empty-emit; VisualTree zeigt
+// Error-Banner mit Retry-Button. Sync-Throws im Provider-Body werden
+// vom useEffect-try/catch abgefangen — emitError ist nur für async.
+export type Subscribe<T> = (
+  emit: (value: T) => void,
+  emitError?: (error: Error) => void,
+) => () => void;
 
 // TreeChildrenSubscribe — Lazy-Variante für dynamic Children. Wird
-// erst aufgerufen wenn der Knoten im UI ausgeklappt wird. ctx ist
-// für Phase 0 ein opaque empty Type; V.1.1 erweitert ihn um Query-/
-// Subscribe-Helpers (entity-list, slug-list etc.).
-export type TreeChildrenSubscribe = (ctx: TreeContext) => Subscribe<readonly TreeNode[]>;
-
-// TreeContext — Provider erhält context-Objekt mit den minimal-nötigen
-// React-Tree-State-Bridges. V.1.1 startet mit `tenantId` only (Provider
-// braucht tenant-awareness sonst stale-tenant-Bug bei Tenant-Switch);
-// `query` und `subscribe` werden additiv ergänzt wenn ein konkreter
-// Konsument sie braucht (V.1.2: text-content slug-list-query, später
-// SSE-driven re-emit). Memory `[Keine Optionen ohne Bedarf]` — surface
-// wächst mit Bedarfen, nicht mit Spekulation. Siehe visual-tree.md
-// V.1.1-Decision D1.
-export type TreeContext = Readonly<{
-  readonly tenantId: TenantId;
-}>;
+// erst aufgerufen wenn der Knoten im UI ausgeklappt wird. Kein ctx-
+// Argument: Provider sind session-bound; Backend liest tenantId aus
+// session bei jedem fetch/dispatch. V.1.1 hatte ein ctx mit tenantId,
+// das aber im Browser nie echten Tenant trug (war auf SYSTEM_TENANT_ID
+// gepinnt) und vom einzigen V.1.2-Consumer (text-content) ignoriert
+// wurde. SR2-Rip 2026-05-18: Dead-API entfernt; wenn später ein
+// Provider tenant-aware-rendern muss (z.B. cross-tenant-Dashboards
+// für SystemAdmin), wird ctx mit echtem Tenant-Source aus dem Auth-
+// Layer re-introduziert. YAGNI bis dahin.
+export type TreeChildrenSubscribe = () => Subscribe<readonly TreeNode[]>;
 
 // TreeActionDef — Schema-Eintrag pro Action in der treeActions-Map
 // eines Features. Phase 0: Args sind ein optionales Type-Sample