@jini-ai/cms 0.1.0

package/dist/navigation/menu-service.js

@@ -0,0 +1,382 @@
+import { NAV_DOC_TYPE, } from "./types.js";
+// ---------------------------------------------------------------------------
+// Outbox event publication — each mutating function below
+// enqueues its matching NAVIGATION_EVENTS entry after its repo write(s)
+// succeed, never on a rejection path. Mirrors the host's proven
+// `outbox.enqueue()` call shape.
+// ---------------------------------------------------------------------------
+/**
+ * `payload` is typed as a plain `Record<string, unknown>` (not the specific
+ * `NavMenuChangedPayload`/`NavLocationChangedPayload` shape) so the result
+ * assigns directly to `OutboxPort.enqueue`'s `DomainEvent` parameter (whose
+ * default payload type is `Record<string, unknown>`) without a cast — every
+ * call site below still passes a fresh object literal matching one of those
+ * two contract shapes exactly (`contracts.ts`), just not nominally typed here.
+ */
+function buildEvent(required) {
+    return {
+        id: required.idGen.newId(),
+        name: required.name,
+        occurredAt: required.clock.nowIso(),
+        aggregateId: required.aggregateId,
+        workspaceId: required.workspaceId,
+        payload: required.payload,
+    };
+}
+// ---------------------------------------------------------------------------
+// Typed errors
+// ---------------------------------------------------------------------------
+export class MenuNotFoundError extends Error {
+}
+export class MenuValidationError extends Error {
+}
+export class MenuConflictError extends Error {
+}
+/**
+ * The 409-style purge rejection: hard delete is blocked while the menu is
+ * still bound to at least one theme location (deletion ladder).
+ * Carries the offending location keys so a caller can render "unassign these
+ * first" without a second lookup.
+ */
+export class MenuLocationBoundError extends MenuConflictError {
+    boundLocations;
+    constructor(message, boundLocations) {
+        super(message);
+        this.boundLocations = boundLocations;
+    }
+}
+// ---------------------------------------------------------------------------
+// Tree validation (total/bounded amendment)
+// ---------------------------------------------------------------------------
+/** Default max nesting depth (root = depth 1). Configurable. */
+export const DEFAULT_MAX_TREE_DEPTH = 5;
+/** Default max total item count across the whole tree. */
+export const DEFAULT_MAX_ITEM_COUNT = 500;
+const VALID_TARGET_KINDS = new Set(["entryRef", "termRef", "url", "route"]);
+/** Named deferred seams — recognized, rejected until their resolver ships. */
+const RESERVED_TARGET_KINDS = new Set(["dynamicQuery", "content"]);
+const URL_SCHEME_DENYLIST = ["javascript:", "data:", "vbscript:"];
+/**
+ * Validates a candidate item tree and returns a defensively-cloned copy.
+ *
+ * Checks (total/bounded validation + target integrity):
+ * - every node has a non-empty `id`, unique across the whole tree (id
+ *   stability is a caller responsibility — see `updateMenuTree` doc for the
+ *   simplification this build accepts);
+ * - nesting depth stays within `maxDepth`;
+ * - total item count stays within `maxItemCount`;
+ * - every target's `kind` is one of the four v1 kinds — reserved kinds
+ *   (`dynamicQuery`, `content`) are rejected with a clear "not yet" error
+ *   rather than silently accepted;
+ * - `url` targets reject a scheme denylist (`javascript:`, `data:`, `vbscript:`).
+ *
+ * @complexity O(n) over total node count for one full walk; no per-node
+ * backtracking. Space is O(n) for the cloned tree plus O(n) for the id set.
+ * @overallScore 100
+ */
+export function validateAndCloneTree(items, limits = {}) {
+    const maxDepth = limits.maxDepth ?? DEFAULT_MAX_TREE_DEPTH;
+    const maxItemCount = limits.maxItemCount ?? DEFAULT_MAX_ITEM_COUNT;
+    const seenIds = new Set();
+    let count = 0;
+    function walk(nodes, depth) {
+        if (depth > maxDepth) {
+            throw new MenuValidationError(`menu tree exceeds max nesting depth of ${maxDepth}`);
+        }
+        return nodes.map((node) => {
+            count += 1;
+            if (count > maxItemCount) {
+                throw new MenuValidationError(`menu tree exceeds max item count of ${maxItemCount}`);
+            }
+            if (!node.id || !node.id.trim()) {
+                throw new MenuValidationError("every menu item requires a non-empty id");
+            }
+            if (seenIds.has(node.id)) {
+                throw new MenuValidationError(`duplicate item id '${node.id}' in menu tree`);
+            }
+            seenIds.add(node.id);
+            validateTarget(node.target);
+            const children = node.children ? walk(node.children, depth + 1) : undefined;
+            return { ...node, children };
+        });
+    }
+    return walk(items, 1);
+}
+function validateTarget(target) {
+    const kind = target.kind;
+    if (RESERVED_TARGET_KINDS.has(kind)) {
+        throw new MenuValidationError(`target kind '${kind}' is a reserved seam and is not supported yet`);
+    }
+    if (!VALID_TARGET_KINDS.has(kind)) {
+        throw new MenuValidationError(`unknown target kind '${kind}'`);
+    }
+    if (kind === "url") {
+        const href = target.href.trim().toLowerCase();
+        if (URL_SCHEME_DENYLIST.some((scheme) => href.startsWith(scheme))) {
+            throw new MenuValidationError(`url target uses a disallowed scheme: '${target.href}'`);
+        }
+    }
+}
+function assertValidTitleAndSlug(title, slug) {
+    if (!title)
+        throw new MenuValidationError("title is required");
+    if (!slug.match(/^[a-z0-9-]+$/)) {
+        throw new MenuValidationError("slug must use lowercase letters, numbers, and dashes");
+    }
+}
+/**
+ * Creates a new `menu` entry in `published` status with no location
+ * assignments. Rejects a duplicate slug within the workspace.
+ *
+ * Was `draft` originally (mirroring `posts`), changed 2026-08-09 on explicit product direction: a
+ * menu has no separate review/approval workflow the way a post does, and `resolveForLocation`
+ * (`resolver.ts`) never actually branched on `status` — the field only ever gated the trash/purge
+ * lifecycle. Landing a new menu in `draft` produced a status label at odds with its real behavior
+ * (already fully live wherever it gets bound to a location) rather than gating anything real, so
+ * the default now matches the actual behavior instead of implying a workflow that doesn't exist.
+ *
+ * @complexity O(n) in the initial tree size for validation; O(m) in existing
+ * menu count for the slug-uniqueness scan (repo-dependent).
+ * @overallScore 100
+ */
+export async function createMenu(required, optional = {}) {
+    const { deps, input } = required;
+    const title = input.title.trim();
+    const slug = input.slug.trim().toLowerCase();
+    assertValidTitleAndSlug(title, slug);
+    const duplicate = await deps.repo.findBySlug({ workspaceId: input.workspaceId, slug });
+    if (duplicate)
+        throw new MenuConflictError(`slug '${slug}' already exists`);
+    const items = validateAndCloneTree(input.items ?? [], optional.limits);
+    const menu = {
+        id: deps.idGen.newId(),
+        workspaceId: input.workspaceId,
+        slug,
+        title,
+        status: "published",
+        doc: { type: NAV_DOC_TYPE, version: 1, items },
+        locations: [],
+        updatedAt: deps.clock.nowIso(),
+        version: 1,
+    };
+    await deps.repo.save(menu);
+    await deps.outbox.enqueue(buildEvent({
+        idGen: deps.idGen,
+        clock: deps.clock,
+        name: "navigation.menu.created",
+        workspaceId: menu.workspaceId,
+        aggregateId: menu.id,
+        payload: { menuId: menu.id, slug: menu.slug },
+    }));
+    return { menu };
+}
+/**
+ * Replaces a menu's whole item tree, guarded by optimistic concurrency on the
+ * entry `version` (matches the host's `updatePost` pattern).
+ *
+ * Id-stability note ("an update may not renumber surviving items"):
+ * this build enforces only that ids are present and unique within the
+ * submitted tree (`validateAndCloneTree`). Detecting whether a *specific*
+ * surviving node kept its original id would require diffing against the
+ * previous tree and is deferred — a caller-discipline requirement for now,
+ * not a runtime-enforced invariant.
+ *
+ * @complexity O(n) in the new tree size for validation; O(1) additional repo
+ * calls (one read, at most one slug-uniqueness read, one write).
+ * @overallScore 90
+ * @findings Medium: id-stability across edits (ids not renumbered on survive)
+ * is documented but not runtime-enforced — see doc comment above. Deferred
+ * pending a tree-diff mechanism; would need the previous tree's id set passed
+ * in to check "no id vanished and reappeared elsewhere," which is more than
+ * this slice's scope calls for.
+ */
+export async function updateMenuTree(required, optional = {}) {
+    const { deps, input } = required;
+    const existing = await deps.repo.findById({ workspaceId: input.workspaceId, id: input.id });
+    if (!existing)
+        throw new MenuNotFoundError(`menu '${input.id}' was not found`);
+    if (existing.version !== input.expectedVersion) {
+        throw new MenuConflictError(`menu '${input.id}' was modified concurrently (expected version ${input.expectedVersion}, found ${existing.version})`);
+    }
+    const title = (input.title ?? existing.title).trim();
+    const slug = (input.slug ?? existing.slug).trim().toLowerCase();
+    assertValidTitleAndSlug(title, slug);
+    if (slug !== existing.slug) {
+        const duplicate = await deps.repo.findBySlug({ workspaceId: input.workspaceId, slug });
+        if (duplicate && duplicate.id !== existing.id) {
+            throw new MenuConflictError(`slug '${slug}' already exists`);
+        }
+    }
+    const items = validateAndCloneTree(input.items, optional.limits);
+    const menu = {
+        ...existing,
+        title,
+        slug,
+        doc: { type: NAV_DOC_TYPE, version: existing.doc.version, items },
+        updatedAt: deps.clock.nowIso(),
+        version: existing.version + 1,
+    };
+    await deps.repo.save(menu);
+    await deps.outbox.enqueue(buildEvent({
+        idGen: deps.idGen,
+        clock: deps.clock,
+        name: "navigation.menu.updated",
+        workspaceId: menu.workspaceId,
+        aggregateId: menu.id,
+        payload: { menuId: menu.id, slug: menu.slug },
+    }));
+    return { menu };
+}
+/**
+ * Assigns a menu to a theme location. This writes two
+ * representations that must stay in lockstep:
+ * 1. the menu's own `locations` field (source of truth, revisioned), and
+ * 2. the derived `nav_location_bindings` row (uniqueness index).
+ *
+ * If the location was already bound to a *different* menu, that menu is
+ * **reassigned away** (last-writer-wins, the chosen
+ * default) and its `locations` field is updated to drop the key — recorded as
+ * its own revision-worthy write.
+ *
+ * Atomicity note: these writes are
+ * logically ONE transaction — the binding-index write is a second in-tx
+ * participant alongside a slug-change-capture slot in the host's routing
+ * layer. Neither real cross-write transactions nor that routing layer exist
+ * as running code yet anywhere this library has shipped, so this function
+ * performs the writes sequentially with no rollback if a later step throws.
+ * This is an accepted, documented gap pending the command gateway's
+ * transaction machinery — do not copy this sequencing pattern into code that
+ * has real transactions available.
+ *
+ * @complexity O(1) repo calls (bounded: at most two menu reads/writes plus one
+ * binding upsert), independent of workspace size.
+ * @overallScore 90
+ * @findings Medium: no rollback across the two writes (menu save, then
+ * binding upsert) if the second fails, leaving the derived index stale until
+ * a rebuild. Acceptable because the index is declared rebuildable-by-definition;
+ * flagged as tech debt for when transactions
+ * exist.
+ */
+export async function assignLocation(required, _optional = {}) {
+    const { deps, input } = required;
+    const menu = await deps.repo.findById({ workspaceId: input.workspaceId, id: input.menuId });
+    if (!menu)
+        throw new MenuNotFoundError(`menu '${input.menuId}' was not found`);
+    const now = deps.clock.nowIso();
+    const existingBinding = await deps.bindingRepo.findByLocation({
+        workspaceId: input.workspaceId,
+        locationKey: input.locationKey,
+    });
+    let displacedMenu = null;
+    if (existingBinding && existingBinding.menuId !== input.menuId) {
+        const displaced = await deps.repo.findById({
+            workspaceId: input.workspaceId,
+            id: existingBinding.menuId,
+        });
+        if (displaced) {
+            const updatedDisplaced = {
+                ...displaced,
+                locations: displaced.locations.filter((key) => key !== input.locationKey),
+                updatedAt: now,
+                version: displaced.version + 1,
+            };
+            await deps.repo.save(updatedDisplaced);
+            displacedMenu = updatedDisplaced;
+        }
+    }
+    const updatedMenu = {
+        ...menu,
+        locations: menu.locations.includes(input.locationKey)
+            ? menu.locations
+            : [...menu.locations, input.locationKey],
+        updatedAt: now,
+        version: menu.version + 1,
+    };
+    await deps.repo.save(updatedMenu);
+    const binding = await deps.bindingRepo.upsert({
+        workspaceId: input.workspaceId,
+        locationKey: input.locationKey,
+        menuId: input.menuId,
+        boundAt: now,
+    });
+    if (displacedMenu) {
+        await deps.outbox.enqueue(buildEvent({
+            idGen: deps.idGen,
+            clock: deps.clock,
+            name: "navigation.location.unassigned",
+            workspaceId: input.workspaceId,
+            aggregateId: displacedMenu.id,
+            payload: { locationKey: input.locationKey, menuId: displacedMenu.id },
+        }));
+    }
+    await deps.outbox.enqueue(buildEvent({
+        idGen: deps.idGen,
+        clock: deps.clock,
+        name: "navigation.location.assigned",
+        workspaceId: input.workspaceId,
+        aggregateId: input.menuId,
+        payload: { locationKey: input.locationKey, menuId: input.menuId },
+    }));
+    return { menu: updatedMenu, binding, displacedMenu };
+}
+/**
+ * Deletion ladder (mirrors the media library's):
+ * 1. First call on a non-trashed menu **soft-deletes** it (`status: 'trash'`,
+ *    revisioned) and returns — no purge yet.
+ * 2. A second call on an already-trashed menu attempts the **hard purge**. If
+ *    the menu is still bound to any location, purge is rejected with
+ *    `MenuLocationBoundError` (409-style) listing the bound keys, unless
+ *    `force` is set — permission-gating that error behind
+ *    `navigation.delete.force` is the caller's (gateway's) job, not this
+ *    function's; this function only enforces the *shape* of the guard.
+ * 3. On a successful purge, the menu row and all of its location bindings are
+ *    removed.
+ *
+ * @complexity O(1) repo calls; O(k) bindings scanned where k = locations this
+ * menu holds (small, bounded by registered locations).
+ * @overallScore 100
+ */
+export async function deleteMenu(required, _optional = {}) {
+    const { deps, input } = required;
+    const existing = await deps.repo.findById({ workspaceId: input.workspaceId, id: input.id });
+    if (!existing)
+        throw new MenuNotFoundError(`menu '${input.id}' was not found`);
+    if (existing.status !== "trash") {
+        const trashed = {
+            ...existing,
+            status: "trash",
+            updatedAt: deps.clock.nowIso(),
+            version: existing.version + 1,
+        };
+        await deps.repo.save(trashed);
+        await deps.outbox.enqueue(buildEvent({
+            idGen: deps.idGen,
+            clock: deps.clock,
+            name: "navigation.menu.updated",
+            workspaceId: trashed.workspaceId,
+            aggregateId: trashed.id,
+            payload: { menuId: trashed.id, slug: trashed.slug },
+        }));
+        return { menu: trashed, purged: false };
+    }
+    const bindings = await deps.bindingRepo.listByMenu({
+        workspaceId: input.workspaceId,
+        menuId: input.id,
+    });
+    if (bindings.length > 0 && !input.force) {
+        const boundLocations = bindings.map((row) => row.locationKey);
+        throw new MenuLocationBoundError(`menu '${input.id}' is still bound to location(s): ${boundLocations.join(", ")} — unassign before purging, or use force`, boundLocations);
+    }
+    await deps.repo.remove({ workspaceId: input.workspaceId, id: input.id });
+    await deps.bindingRepo.removeByMenu({ workspaceId: input.workspaceId, menuId: input.id });
+    await deps.outbox.enqueue(buildEvent({
+        idGen: deps.idGen,
+        clock: deps.clock,
+        name: "navigation.menu.deleted",
+        workspaceId: existing.workspaceId,
+        aggregateId: existing.id,
+        payload: { menuId: existing.id, slug: existing.slug },
+    }));
+    return { menu: null, purged: true };
+}
+//# sourceMappingURL=menu-service.js.map

package/dist/navigation/menu-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-service.js","sourceRoot":"","sources":["../../src/navigation/menu-service.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,YAAY,GAQb,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,0DAA0D;AAC1D,wEAAwE;AACxE,gEAAgE;AAChE,iCAAiC;AACjC,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAS,UAAU,CAAC,QAOnB;IACC,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE;QAC1B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE;QACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAC/C,MAAM,OAAO,mBAAoB,SAAQ,KAAK;CAAG;AACjD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAE/C;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,iBAAiB;IAClD,cAAc,CAA4B;IAEnD,YAAY,OAAe,EAAE,cAAyC;QACpE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAED,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AACpF,8EAA8E;AAC9E,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;AAC3E,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AAOlE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA6B,EAC7B,SAA+B,EAAE;IAEjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,sBAAsB,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,sBAAsB,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,SAAS,IAAI,CAAC,KAA6B,EAAE,KAAa;QACxD,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,mBAAmB,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxB,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,GAAG,YAAY,EAAE,CAAC;gBACzB,MAAM,IAAI,mBAAmB,CAAC,uCAAuC,YAAY,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChC,MAAM,IAAI,mBAAmB,CAAC,yCAAyC,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrB,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,cAAc,CAAC,MAAiB;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,mBAAmB,CAC3B,gBAAgB,IAAI,+CAA+C,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,IAAI,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,GAAI,MAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChE,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,mBAAmB,CAC3B,yCAA0C,MAAuB,CAAC,IAAI,GAAG,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa,EAAE,IAAY;IAC1D,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,mBAAmB,CAAC,sDAAsD,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AA+BD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAA4B,EAC5B,WAA+B,EAAE;IAEjC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,IAAI,SAAS;QAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEvE,MAAM,IAAI,GAAiB;QACzB,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI;QACJ,KAAK;QACL,MAAM,EAAE,WAAyB;QACjC,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;QAC9C,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QAC9B,OAAO,EAAE,CAAC;KACX,CAAC;IAEF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,UAAU,CAAC;QACT,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,EAAE;QACpB,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAC9C,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAmCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgC,EAChC,WAAmC,EAAE;IAErC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE/E,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,eAAe,EAAE,CAAC;QAC/C,MAAM,IAAI,iBAAiB,CACzB,SAAS,KAAK,CAAC,EAAE,iDAAiD,KAAK,CAAC,eAAe,WAAW,QAAQ,CAAC,OAAO,GAAG,CACtH,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAErC,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,IAAI,SAAS,IAAI,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,iBAAiB,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEjE,MAAM,IAAI,GAAiB;QACzB,GAAG,QAAQ;QACX,KAAK;QACL,IAAI;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE;QACjE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QAC9B,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,CAAC;KAC9B,CAAC;IAEF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,UAAU,CAAC;QACT,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,EAAE;QACpB,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAC9C,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgC,EAChC,YAAoC,EAAE;IAEtC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAE/E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;QAC5D,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC;IAEH,IAAI,aAAa,GAAwB,IAAI,CAAC;IAC9C,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACzC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,EAAE,EAAE,eAAe,CAAC,MAAM;SAC3B,CAAC,CAAC;QACH,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,gBAAgB,GAAiB;gBACrC,GAAG,SAAS;gBACZ,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,WAAW,CAAC;gBACzE,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,CAAC;aAC/B,CAAC;YACF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACvC,aAAa,GAAG,gBAAgB,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAiB;QAChC,GAAG,IAAI;QACP,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;YACnD,CAAC,CAAC,IAAI,CAAC,SAAS;YAChB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QAC1C,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC;KAC1B,CAAC;IACF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QAC5C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,GAAG;KACb,CAAC,CAAC;IAEH,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,UAAU,CAAC;YACT,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,gCAAgC;YACtC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE,aAAa,CAAC,EAAE;YAC7B,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,EAAE;SACtE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,UAAU,CAAC;QACT,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;KAClE,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AACvD,CAAC;AA8BD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAA4B,EAC5B,YAAgC,EAAE;IAElC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE/E,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,OAAO,GAAiB;YAC5B,GAAG,QAAQ;YACX,MAAM,EAAE,OAAqB;YAC7B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAC9B,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,CAAC;SAC9B,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE9B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,UAAU,CAAC;YACT,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,EAAE;YACvB,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;SACpD,CAAC,CACH,CAAC;QAEF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;QACjD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,EAAE;KACjB,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9D,MAAM,IAAI,sBAAsB,CAC9B,SAAS,KAAK,CAAC,EAAE,oCAAoC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C,EACxH,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAE1F,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,UAAU,CAAC;QACT,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,EAAE;QACxB,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;KACtD,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/navigation/ports.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @file Ports + typed-call contracts for the `navigation` library.
+ *
+ * The rule-of-two applied honestly to navigation:
+ *
+ * - **`NavLocationBindingRepoPort` IS a port.** It persists the derived
+ *   `nav_location_bindings` index and has two real adapters, one built now:
+ *   in-memory (dev/tests) + SQLite (persistent, host-supplied) — the same shape
+ *   every other repo in this library already follows.
+ *
+ * - **Menus themselves add NO new persistence port.** A menu is a generic
+ *   entry; it rides the existing entries repo (in-memory + SQLite), which
+ *   already passes rule-of-two. Inventing a `MenuRepoPort` would be a second
+ *   store for data that already has one.
+ *
+ * - **`NavTargetResolver` is NOT a port — it is one evaluator.** Resolving a
+ *   target ref to an href/label is ordinary core code over routing + entries +
+ *   taxonomy (typed calls). There is exactly one production
+ *   implementation, so — following the identity library's self-application of the rule-of-two to
+ *   `authorize()` ("no PolicyPort; one evaluator") — it stays a plain typed-call
+ *   contract, refactored into a port only if a second real resolver appears.
+ *
+ * INTERFACES ONLY. No feature logic lives here.
+ */
+import type { ISODateTime, UUID } from "../core/ports.js";
+import type { NavLocationBindingRow, NavLocationDescriptor, NavLocationKey, NavMenuDoc, NavMenuEntry, ResolvedNav } from "./types.js";
+/**
+ * Persistence for the derived `nav_location_bindings` index. Writes happen only inside the same transaction as the menu-entry
+ * mutation that changed `locations` (single write chokepoint); this
+ * port is the storage seam, not a second write path. `rebuildForWorkspace`
+ * exists because the index is **rebuildable by definition** —
+ * a full rescan of menu entries can always reconstruct it.
+ */
+export interface NavLocationBindingRepoPort {
+    /** The menu currently bound to a location, if any. */
+    findByLocation(required: {
+        workspaceId: UUID;
+        locationKey: NavLocationKey;
+    }): Promise<NavLocationBindingRow | null>;
+    /** All locations a given menu currently fills. */
+    listByMenu(required: {
+        workspaceId: UUID;
+        menuId: UUID;
+    }): Promise<NavLocationBindingRow[]>;
+    /** Every binding in the workspace (admin overview + render prefetch). */
+    listByWorkspace(required: {
+        workspaceId: UUID;
+    }): Promise<NavLocationBindingRow[]>;
+    /**
+     * Assign a location to a menu. Honors `UNIQUE (workspace_id, location_key)` —
+     * claiming a location already bound elsewhere **reassigns** it (last writer
+     * wins) and the caller records the displaced menu's revision through the
+     * chokepoint. Returns the row that now holds the binding.
+     */
+    upsert(required: {
+        workspaceId: UUID;
+        locationKey: NavLocationKey;
+        menuId: UUID;
+        boundAt: ISODateTime;
+    }): Promise<NavLocationBindingRow>;
+    /** Remove a single location binding (unassign). */
+    remove(required: {
+        workspaceId: UUID;
+        locationKey: NavLocationKey;
+    }): Promise<void>;
+    /** Drop every binding for a menu (menu purge). */
+    removeByMenu(required: {
+        workspaceId: UUID;
+        menuId: UUID;
+    }): Promise<void>;
+    /**
+     * Rebuild the whole workspace's index from the authoritative menu entries.
+     * The index is derived + rebuildable, so this is always safe.
+     */
+    rebuildForWorkspace(required: {
+        workspaceId: UUID;
+        bindings: readonly NavLocationBindingRow[];
+    }): Promise<void>;
+}
+/** Context needed to compute hrefs + active-state during resolution. */
+export interface NavResolveContext {
+    readonly workspaceId: UUID;
+    /**
+     * The current request route/path, used to compute `isCurrent`/`isActive`.
+     * Absent for non-request resolution (e.g. an AI preview).
+     */
+    readonly currentPath?: string | undefined;
+}
+/**
+ * Resolves a stored `NavMenuDoc` into a render-ready `ResolvedNav` — targets to
+ * hrefs, labels filled from targets, active-state computed, unavailable targets
+ * flagged. One production evaluator (routing + entries + taxonomy typed calls),
+ * so this is a contract, not a port (see file header). The theme receives only
+ * the resolved data.
+ */
+export interface NavTargetResolver {
+    resolve(required: {
+        context: NavResolveContext;
+        menuId: UUID;
+        locationKey: NavLocationKey;
+        title: string;
+        doc: NavMenuDoc;
+    }): Promise<ResolvedNav>;
+}
+/**
+ * The navigation library's public read surface over the entries repo, exposed as
+ * typed calls so callers (theme renderer, routing, AI tools) never
+ * reach into storage. Reuses the entries repo underneath — adds no new port.
+ */
+export interface NavMenuReadModel {
+    /** Load a menu entry as the typed navigation projection. */
+    getMenu(required: {
+        workspaceId: UUID;
+        menuId: UUID;
+    }): Promise<NavMenuEntry | null>;
+    getMenuBySlug(required: {
+        workspaceId: UUID;
+        slug: string;
+    }): Promise<NavMenuEntry | null>;
+    listMenus(required: {
+        workspaceId: UUID;
+    }): Promise<NavMenuEntry[]>;
+    /**
+     * Resolve the menu bound to a theme location, already rendered to
+     * `ResolvedNav`. Returns `null` when the location has no menu. This is the one
+     * call the theme renderer makes.
+     */
+    resolveForLocation(required: {
+        context: NavResolveContext;
+        locationKey: NavLocationKey;
+    }): Promise<ResolvedNav | null>;
+}
+/**
+ * Registry of theme/plugin-declared locations (populated by the
+ * `navigation.locations.register` hook). Read-only lookup; the
+ * writable side is the hook, not this contract.
+ */
+export interface NavLocationRegistry {
+    list(required: {
+        workspaceId: UUID;
+    }): NavLocationDescriptor[];
+    get(required: {
+        workspaceId: UUID;
+        key: NavLocationKey;
+    }): NavLocationDescriptor | null;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/navigation/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/navigation/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,cAAc,CAAC,QAAQ,EAAE;QACvB,WAAW,EAAE,IAAI,CAAC;QAClB,WAAW,EAAE,cAAc,CAAC;KAC7B,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAE1C,kDAAkD;IAClD,UAAU,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE5F,yEAAyE;IACzE,eAAe,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE;QACf,WAAW,EAAE,IAAI,CAAC;QAClB,WAAW,EAAE,cAAc,CAAC;QAC5B,MAAM,EAAE,IAAI,CAAC;QACb,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEnC,mDAAmD;IACnD,MAAM,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,kDAAkD;IAClD,YAAY,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE;QAC5B,WAAW,EAAE,IAAI,CAAC;QAClB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;KAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAMD,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,QAAQ,EAAE;QAChB,OAAO,EAAE,iBAAiB,CAAC;QAC3B,MAAM,EAAE,IAAI,CAAC;QACb,WAAW,EAAE,cAAc,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,UAAU,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACrF,aAAa,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC3F,SAAS,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACpE;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE;QAC3B,OAAO,EAAE,iBAAiB,CAAC;QAC3B,WAAW,EAAE,cAAc,CAAC;KAC7B,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAA;KAAE,GAAG,qBAAqB,EAAE,CAAC;IAC/D,GAAG,CAAC,QAAQ,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,cAAc,CAAA;KAAE,GAAG,qBAAqB,GAAG,IAAI,CAAC;CACzF"}

package/dist/navigation/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/navigation/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/navigation/ports.ts"],"names":[],"mappings":""}

package/dist/navigation/read-model.d.ts

@@ -0,0 +1,11 @@
+import type { NavLocationBindingRepoPort, NavMenuReadModel } from "./ports.js";
+import type { MenuRepoPort } from "./repo.memory.js";
+import { type ResolveTargetHrefFn } from "./resolver.js";
+export interface NavMenuReadModelDeps {
+    menuRepo: MenuRepoPort;
+    bindingRepo: NavLocationBindingRepoPort;
+    /** Overridable for tests / once a host's routing library lands; defaults to the honest placeholder documented above. */
+    resolveTargetHref?: ResolveTargetHrefFn | undefined;
+}
+export declare function createNavMenuReadModel(deps: NavMenuReadModelDeps): NavMenuReadModel;
+//# sourceMappingURL=read-model.d.ts.map

package/dist/navigation/read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model.d.ts","sourceRoot":"","sources":["../../src/navigation/read-model.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,0BAA0B,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG7E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,0BAA0B,CAAC;IACxC,wHAAwH;IACxH,iBAAiB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACrD;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CA2BnF"}

package/dist/navigation/read-model.js

@@ -0,0 +1,27 @@
+import { resolveForLocation } from "./resolver.js";
+const DEFAULT_RESOLVE_TARGET_HREF = async () => null;
+export function createNavMenuReadModel(deps) {
+    const resolveTargetHref = deps.resolveTargetHref ?? DEFAULT_RESOLVE_TARGET_HREF;
+    return {
+        async getMenu(required) {
+            return deps.menuRepo.findById({ workspaceId: required.workspaceId, id: required.menuId });
+        },
+        async getMenuBySlug(required) {
+            return deps.menuRepo.findBySlug(required);
+        },
+        async listMenus(required) {
+            return deps.menuRepo.list(required);
+        },
+        async resolveForLocation(required) {
+            return resolveForLocation({
+                deps: { menuRepo: deps.menuRepo, bindingRepo: deps.bindingRepo, resolveTargetHref },
+                input: {
+                    workspaceId: required.context.workspaceId,
+                    locationKey: required.locationKey,
+                    currentPath: required.context.currentPath,
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=read-model.js.map

package/dist/navigation/read-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model.js","sourceRoot":"","sources":["../../src/navigation/read-model.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,kBAAkB,EAA4B,MAAM,eAAe,CAAC;AAU7E,MAAM,2BAA2B,GAAwB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;AAE1E,MAAM,UAAU,sBAAsB,CAAC,IAA0B;IAC/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,2BAA2B,CAAC;IAEhF,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,QAA6C;YACzD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,QAA6C;YAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,QAA+B;YAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,QAAqE;YAC5F,OAAO,kBAAkB,CAAC;gBACxB,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,EAAE;gBACnF,KAAK,EAAE;oBACL,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW;oBACzC,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW;iBAC1C;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}