@kywi-software/core 0.1.0

package/dist/nav/__tests__/nav-locale.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nav-locale.test.d.ts.map

package/dist/nav/__tests__/nav-locale.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-locale.test.d.ts","sourceRoot":"","sources":["../../../src/nav/__tests__/nav-locale.test.ts"],"names":[],"mappings":""}

package/dist/nav/__tests__/nav-locale.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from 'vitest';
+import { selectLocaleNavRows, prefixHrefWithLocale, buildNavTree } from '../builder.js';
+// Home (en, root), About (en + fr siblings), Blog (en only), all nav-eligible.
+const rows = [
+    { id: 'home', parentId: null, title: 'Home', slug: 'home', path: '/', depth: 0, sortOrder: 0, isNav: true, status: 'published', locale: 'en' },
+    { id: 'about-en', parentId: 'home', title: 'About', slug: 'about', path: '/about/', depth: 1, sortOrder: 1, isNav: true, status: 'published', locale: 'en' },
+    { id: 'about-fr', parentId: 'home', title: 'À propos', slug: 'about', path: '/about/', depth: 1, sortOrder: 1, isNav: true, status: 'published', locale: 'fr' },
+    { id: 'blog-en', parentId: 'home', title: 'Blog', slug: 'blog', path: '/blog/', depth: 1, sortOrder: 2, isNav: true, status: 'published', locale: 'en' },
+];
+describe('prefixHrefWithLocale', () => {
+    it('prefixes a normal path', () => {
+        expect(prefixHrefWithLocale('/about/', 'fr')).toBe('/fr/about/');
+    });
+    it('maps root to the bare locale segment', () => {
+        expect(prefixHrefWithLocale('/', 'fr')).toBe('/fr');
+    });
+    it('is idempotent when already prefixed', () => {
+        expect(prefixHrefWithLocale('/fr/about/', 'fr')).toBe('/fr/about/');
+    });
+});
+describe('selectLocaleNavRows', () => {
+    it('default locale returns the English translation, un-prefixed, one per item', () => {
+        const picked = selectLocaleNavRows(rows, 'en', 'en');
+        const about = picked.find((r) => r.slug === 'about');
+        expect(picked.filter((r) => r.slug === 'about')).toHaveLength(1);
+        expect(about?.title).toBe('About');
+        expect(about?.path).toBe('/about/');
+    });
+    it('French locale returns the French translation with a locale-prefixed href', () => {
+        const picked = selectLocaleNavRows(rows, 'fr', 'en');
+        const about = picked.find((r) => r.slug === 'about');
+        expect(about?.title).toBe('À propos');
+        expect(about?.path).toBe('/fr/about/');
+    });
+    it('falls back to the default-locale sibling when a translation is missing', () => {
+        // Blog has no French sibling → falls back to English title, prefixed href.
+        const picked = selectLocaleNavRows(rows, 'fr', 'en');
+        const blog = picked.find((r) => r.slug === 'blog');
+        expect(blog?.title).toBe('Blog');
+        expect(blog?.path).toBe('/fr/blog/');
+    });
+});
+describe('buildNavTree over locale-selected rows (TC-11.013)', () => {
+    it('French tree shows French titles and prefixed URLs; nesting preserved', () => {
+        const tree = buildNavTree(selectLocaleNavRows(rows, 'fr', 'en'), '/');
+        const home = tree.find((n) => n.slug === 'home');
+        expect(home).toBeTruthy();
+        const about = home.children.find((n) => n.slug === 'about');
+        expect(about?.title).toBe('À propos');
+        expect(about?.href).toBe('/fr/about/');
+    });
+    it('English tree is unchanged from the non-localized build (no regression)', () => {
+        const tree = buildNavTree(selectLocaleNavRows(rows, 'en', 'en'), '/');
+        const home = tree.find((n) => n.slug === 'home');
+        expect(home.children.map((n) => n.title).sort()).toEqual(['About', 'Blog']);
+        expect(home.children.find((n) => n.slug === 'about')?.href).toBe('/about/');
+    });
+});
+//# sourceMappingURL=nav-locale.test.js.map

package/dist/nav/__tests__/nav-locale.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-locale.test.js","sourceRoot":"","sources":["../../../src/nav/__tests__/nav-locale.test.ts"],"names":[],"mappings":"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"}

package/dist/nav/__tests__/redirect-middleware.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redirect-middleware.test.d.ts.map

package/dist/nav/__tests__/redirect-middleware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-middleware.test.d.ts","sourceRoot":"","sources":["../../../src/nav/__tests__/redirect-middleware.test.ts"],"names":[],"mappings":""}

package/dist/nav/__tests__/redirect-middleware.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createRedirectMiddleware } from '../redirect-middleware.js';
+function makeMockDb() {
+    return {}; // DB is passed through to lookupRedirect; we mock lookupRedirect instead
+}
+describe('createRedirectMiddleware', () => {
+    it('returns null when no redirect is found', async () => {
+        const lookup = vi.fn().mockResolvedValue(null);
+        const middleware = createRedirectMiddleware({ lookupFn: lookup });
+        const result = await middleware('site1', '/no-redirect/');
+        expect(result).toBeNull();
+        expect(lookup).toHaveBeenCalledWith('site1', '/no-redirect/');
+    });
+    it('returns a 301 Response when redirect is found', async () => {
+        const lookup = vi.fn().mockResolvedValue('/new-page/');
+        const middleware = createRedirectMiddleware({ lookupFn: lookup });
+        const result = await middleware('site1', '/old-page/');
+        expect(result).toBeInstanceOf(Response);
+        expect(result.status).toBe(301);
+        expect(result.headers.get('Location')).toBe('/new-page/');
+    });
+    it('returns a 301 with full URL when redirect target is found', async () => {
+        const lookup = vi.fn().mockResolvedValue('/blog/new-slug/');
+        const middleware = createRedirectMiddleware({ lookupFn: lookup });
+        const result = await middleware('site1', '/blog/old-slug/');
+        expect(result).not.toBeNull();
+        expect(result.status).toBe(301);
+        expect(result.headers.get('Location')).toBe('/blog/new-slug/');
+    });
+    it('passes siteId through to lookup function', async () => {
+        const lookup = vi.fn().mockResolvedValue(null);
+        const middleware = createRedirectMiddleware({ lookupFn: lookup });
+        await middleware('site-xyz', '/test/');
+        expect(lookup).toHaveBeenCalledWith('site-xyz', '/test/');
+    });
+    it('does not redirect API paths by default', async () => {
+        const lookup = vi.fn().mockResolvedValue('/new/');
+        const middleware = createRedirectMiddleware({
+            lookupFn: lookup,
+            excludePatterns: [/^\/api\//],
+        });
+        const result = await middleware('site1', '/api/content/');
+        expect(result).toBeNull();
+        expect(lookup).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=redirect-middleware.test.js.map

package/dist/nav/__tests__/redirect-middleware.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-middleware.test.js","sourceRoot":"","sources":["../../../src/nav/__tests__/redirect-middleware.test.ts"],"names":[],"mappings":"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"}

package/dist/nav/__tests__/url-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=url-resolver.test.d.ts.map

package/dist/nav/__tests__/url-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-resolver.test.d.ts","sourceRoot":"","sources":["../../../src/nav/__tests__/url-resolver.test.ts"],"names":[],"mappings":""}

package/dist/nav/__tests__/url-resolver.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect, vi } from 'vitest';
+import { normalizePath, pathToSegments, resolveContentByPath, resolveContentBySegments, } from '../url-resolver.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Pure utility functions
+// ─────────────────────────────────────────────────────────────────────────────
+describe('normalizePath', () => {
+    it('adds trailing slash when missing', () => {
+        expect(normalizePath('/about/team')).toBe('/about/team/');
+    });
+    it('preserves trailing slash when present', () => {
+        expect(normalizePath('/about/team/')).toBe('/about/team/');
+    });
+    it('adds leading slash when missing', () => {
+        expect(normalizePath('about/team')).toBe('/about/team/');
+    });
+    it('handles root path', () => {
+        expect(normalizePath('/')).toBe('/');
+    });
+    it('handles single segment without slashes', () => {
+        expect(normalizePath('about')).toBe('/about/');
+    });
+});
+describe('pathToSegments', () => {
+    it('splits "/about/team/" into ["about", "team"]', () => {
+        expect(pathToSegments('/about/team/')).toEqual(['about', 'team']);
+    });
+    it('splits "/home/" into ["home"]', () => {
+        expect(pathToSegments('/home/')).toEqual(['home']);
+    });
+    it('handles path without slashes', () => {
+        expect(pathToSegments('about')).toEqual(['about']);
+    });
+    it('returns empty array for "/"', () => {
+        expect(pathToSegments('/')).toEqual([]);
+    });
+    it('returns empty array for empty string', () => {
+        expect(pathToSegments('')).toEqual([]);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// resolveContentByPath (DB mock)
+// ─────────────────────────────────────────────────────────────────────────────
+const SITE_ID = 'site-1';
+const sampleRow = {
+    id: 'content-1',
+    siteId: SITE_ID,
+    parentId: null,
+    title: 'About',
+    slug: 'about',
+    path: '/about/',
+    depth: 0,
+    status: 'published',
+    baseType: 'content',
+    contentTypeName: 'page',
+};
+function makeMockDb(rows = []) {
+    const limitMock = vi.fn().mockResolvedValue(rows);
+    const chain = {
+        from: vi.fn().mockReturnThis(),
+        where: vi.fn().mockReturnThis(),
+        limit: limitMock,
+    };
+    return {
+        select: vi.fn().mockReturnValue(chain),
+        _limitMock: limitMock,
+    };
+}
+describe('resolveContentByPath', () => {
+    it('returns content when path matches', async () => {
+        const db = makeMockDb([sampleRow]);
+        const result = await resolveContentByPath(db, '/about/', SITE_ID);
+        expect(result).toEqual(sampleRow);
+        expect(db.select).toHaveBeenCalledTimes(1);
+    });
+    it('normalizes path before querying', async () => {
+        const db = makeMockDb([sampleRow]);
+        // Path without trailing slash should still work
+        await resolveContentByPath(db, '/about', SITE_ID);
+        expect(db.select).toHaveBeenCalledTimes(1);
+    });
+    it('returns null when no content matches', async () => {
+        const db = makeMockDb([]);
+        const result = await resolveContentByPath(db, '/nonexistent/', SITE_ID);
+        expect(result).toBeNull();
+    });
+    it('calls limit(1) for efficiency', async () => {
+        const db = makeMockDb([]);
+        await resolveContentByPath(db, '/about/', SITE_ID);
+        expect(db._limitMock).toHaveBeenCalledWith(1);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// resolveContentBySegments (DB mock)
+// ─────────────────────────────────────────────────────────────────────────────
+describe('resolveContentBySegments', () => {
+    it('returns null for empty path', async () => {
+        const db = makeMockDb();
+        const result = await resolveContentBySegments(db, '/', SITE_ID);
+        expect(result).toBeNull();
+    });
+    it('walks single segment and returns resolved content', async () => {
+        // Two queries: first resolves "about" segment, second fetches final row
+        const limitMock = vi.fn()
+            .mockResolvedValueOnce([sampleRow]) // segment lookup
+            .mockResolvedValueOnce([sampleRow]); // final fetch
+        const chain = {
+            from: vi.fn().mockReturnThis(),
+            where: vi.fn().mockReturnThis(),
+            limit: limitMock,
+        };
+        const db = { select: vi.fn().mockReturnValue(chain) };
+        const result = await resolveContentBySegments(db, '/about/', SITE_ID);
+        expect(result).toEqual(sampleRow);
+    });
+    it('returns null when a segment does not exist', async () => {
+        const limitMock = vi.fn()
+            .mockResolvedValueOnce([sampleRow]) // first segment resolves
+            .mockResolvedValueOnce([]); // second segment fails
+        const chain = {
+            from: vi.fn().mockReturnThis(),
+            where: vi.fn().mockReturnThis(),
+            limit: limitMock,
+        };
+        const db = { select: vi.fn().mockReturnValue(chain) };
+        const result = await resolveContentBySegments(db, '/about/nonexistent/', SITE_ID);
+        expect(result).toBeNull();
+    });
+    it('walks multi-segment path', async () => {
+        const teamRow = {
+            ...sampleRow,
+            id: 'content-2',
+            parentId: 'content-1',
+            title: 'Team',
+            slug: 'team',
+            path: '/about/team/',
+            depth: 1,
+        };
+        const limitMock = vi.fn()
+            .mockResolvedValueOnce([sampleRow]) // "about" segment
+            .mockResolvedValueOnce([teamRow]) // "team" segment
+            .mockResolvedValueOnce([teamRow]); // final fetch
+        const chain = {
+            from: vi.fn().mockReturnThis(),
+            where: vi.fn().mockReturnThis(),
+            limit: limitMock,
+        };
+        const db = { select: vi.fn().mockReturnValue(chain) };
+        const result = await resolveContentBySegments(db, '/about/team/', SITE_ID);
+        expect(result).toEqual(teamRow);
+    });
+});
+//# sourceMappingURL=url-resolver.test.js.map

package/dist/nav/__tests__/url-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-resolver.test.js","sourceRoot":"","sources":["../../../src/nav/__tests__/url-resolver.test.ts"],"names":[],"mappings":"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"}

package/dist/nav/builder.d.ts

@@ -0,0 +1,62 @@
+import type { KywiNavNode } from './types.js';
+export interface NavRow {
+    id: string;
+    parentId: string | null;
+    title: string;
+    menuTitle?: string | null;
+    slug: string;
+    path: string;
+    depth: number;
+    sortOrder: number;
+    isNav: boolean;
+    status?: string;
+    groupIds?: string[];
+    /** Content locale of this nav row (e.g. 'en', 'fr'). Absent → default locale. */
+    locale?: string;
+}
+/**
+ * Compute a child path by appending slug + trailing slash to parentPath.
+ */
+export declare function computePath(parentPath: string, slug: string): string;
+/**
+ * Prefix a nav href with a locale segment (e.g. `/about/` → `/fr/about/`).
+ * The site-default locale is served un-prefixed, so only non-default locales
+ * get a prefix. Idempotent when the path already starts with the prefix.
+ */
+export declare function prefixHrefWithLocale(path: string, locale: string): string;
+/**
+ * Locale-aware nav row selection (TC-11.013).
+ *
+ * Localized content is modelled as sibling nodes: same `parentId` + `slug`,
+ * different `locale`. This collapses each such translation group to a single
+ * row for the requested `locale`, falling back to the `defaultLocale` sibling
+ * (then any sibling) when the requested translation is missing. For non-default
+ * locales the surviving row's `path` is prefixed with the locale so nav links
+ * point at the prefixed URL. Nodes with no locale are treated as default-locale.
+ *
+ * Parent/child linkage is by `id`, which this preserves, so a French child of an
+ * English (untranslated) parent still nests correctly.
+ */
+export declare function selectLocaleNavRows<T extends NavRow>(rows: T[], locale: string, defaultLocale: string): T[];
+export interface BuildNavTreeOptions {
+    /** Only include rows with these statuses. Defaults to ['published']. Pass null to disable. */
+    statuses?: string[] | null;
+    /** User ID for permission filtering. When set with userGroupIds, only include rows the user can view. */
+    userId?: string;
+    /** Group IDs the user belongs to, used with userId for permission filtering. */
+    userGroupIds?: string[];
+}
+/**
+ * Build a nav tree from flat rows, filtering out isNav=false,
+ * and marking isActive/isAncestor based on currentPath.
+ *
+ * Uses menuTitle when set, falling back to title.
+ * Filters by status (defaults to 'published' only) and group permissions.
+ */
+export declare function buildNavTree(rows: NavRow[], currentPath: string, opts?: BuildNavTreeOptions): KywiNavNode[];
+/**
+ * Build breadcrumbs for a given nodeId by walking up the parentId chain.
+ * Returns ordered root→target. Returns empty array for unknown nodeId.
+ */
+export declare function buildBreadcrumbs(rows: NavRow[], nodeId: string): KywiNavNode[];
+//# sourceMappingURL=builder.d.ts.map

package/dist/nav/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/nav/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,CAAC,EAAE,CAwBL;AAED,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC1B,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAmE3G;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CA4B9E"}

package/dist/nav/builder.js

@@ -0,0 +1,160 @@
+/**
+ * Compute a child path by appending slug + trailing slash to parentPath.
+ */
+export function computePath(parentPath, slug) {
+    // parentPath always ends with '/'
+    return `${parentPath}${slug}/`;
+}
+/**
+ * Prefix a nav href with a locale segment (e.g. `/about/` → `/fr/about/`).
+ * The site-default locale is served un-prefixed, so only non-default locales
+ * get a prefix. Idempotent when the path already starts with the prefix.
+ */
+export function prefixHrefWithLocale(path, locale) {
+    const seg = `/${locale}`;
+    if (path === '/')
+        return seg;
+    if (path === seg || path.startsWith(`${seg}/`))
+        return path;
+    return `${seg}${path}`;
+}
+/**
+ * Locale-aware nav row selection (TC-11.013).
+ *
+ * Localized content is modelled as sibling nodes: same `parentId` + `slug`,
+ * different `locale`. This collapses each such translation group to a single
+ * row for the requested `locale`, falling back to the `defaultLocale` sibling
+ * (then any sibling) when the requested translation is missing. For non-default
+ * locales the surviving row's `path` is prefixed with the locale so nav links
+ * point at the prefixed URL. Nodes with no locale are treated as default-locale.
+ *
+ * Parent/child linkage is by `id`, which this preserves, so a French child of an
+ * English (untranslated) parent still nests correctly.
+ */
+export function selectLocaleNavRows(rows, locale, defaultLocale) {
+    const localeOf = (r) => r.locale ?? defaultLocale;
+    const groups = new Map();
+    for (const row of rows) {
+        const key = `${row.parentId ?? 'root'}::${row.slug}`;
+        const list = groups.get(key);
+        if (list)
+            list.push(row);
+        else
+            groups.set(key, [row]);
+    }
+    const picked = [];
+    for (const group of groups.values()) {
+        const chosen = group.find((r) => localeOf(r) === locale) ??
+            group.find((r) => localeOf(r) === defaultLocale) ??
+            group[0];
+        if (!chosen)
+            continue;
+        if (locale !== defaultLocale) {
+            picked.push({ ...chosen, path: prefixHrefWithLocale(chosen.path, locale) });
+        }
+        else {
+            picked.push(chosen);
+        }
+    }
+    return picked;
+}
+/**
+ * Build a nav tree from flat rows, filtering out isNav=false,
+ * and marking isActive/isAncestor based on currentPath.
+ *
+ * Uses menuTitle when set, falling back to title.
+ * Filters by status (defaults to 'published' only) and group permissions.
+ */
+export function buildNavTree(rows, currentPath, opts) {
+    // Status filtering: default to 'published' only
+    const statuses = opts?.statuses === null ? null : (opts?.statuses ?? ['published']);
+    let filtered = rows.filter(r => r.isNav);
+    // Apply status filter
+    if (statuses !== null) {
+        filtered = filtered.filter(r => {
+            // Rows without a status field are included (backwards compat)
+            if (r.status === undefined)
+                return true;
+            return statuses.includes(r.status);
+        });
+    }
+    // Apply permission filter: if userId is provided, only include rows the user has access to
+    if (opts?.userId && opts?.userGroupIds) {
+        const userGroups = new Set(opts.userGroupIds);
+        filtered = filtered.filter(r => {
+            // Rows without groupIds are public (no restrictions)
+            if (!r.groupIds || r.groupIds.length === 0)
+                return true;
+            // Check if user's groups overlap with the row's required groups
+            return r.groupIds.some(gid => userGroups.has(gid));
+        });
+    }
+    const navRows = filtered;
+    // Build children map
+    const childrenMap = new Map();
+    for (const row of navRows) {
+        const key = row.parentId;
+        if (!childrenMap.has(key))
+            childrenMap.set(key, []);
+        childrenMap.get(key).push(row);
+    }
+    // Sort each group by sortOrder
+    for (const [, children] of childrenMap) {
+        children.sort((a, b) => a.sortOrder - b.sortOrder);
+    }
+    function buildNode(row) {
+        const childRows = childrenMap.get(row.id) ?? [];
+        const children = childRows.map(buildNode);
+        const isActive = row.path === currentPath;
+        // isAncestor: currentPath starts with this node's path but is not equal to it
+        const isAncestor = !isActive && currentPath.startsWith(row.path);
+        return {
+            id: row.id,
+            title: row.menuTitle ?? row.title,
+            href: row.path,
+            slug: row.slug,
+            depth: row.depth,
+            hasChildren: children.length > 0,
+            isActive,
+            isAncestor,
+            children,
+        };
+    }
+    // Find root nodes (parentId is null or parent not in nav rows)
+    const navRowIds = new Set(navRows.map(r => r.id));
+    const roots = navRows.filter(r => r.parentId === null || !navRowIds.has(r.parentId));
+    return roots.sort((a, b) => a.sortOrder - b.sortOrder).map(buildNode);
+}
+/**
+ * Build breadcrumbs for a given nodeId by walking up the parentId chain.
+ * Returns ordered root→target. Returns empty array for unknown nodeId.
+ */
+export function buildBreadcrumbs(rows, nodeId) {
+    const rowMap = new Map();
+    for (const row of rows) {
+        rowMap.set(row.id, row);
+    }
+    const target = rowMap.get(nodeId);
+    if (!target)
+        return [];
+    const chain = [];
+    let current = target;
+    while (current) {
+        chain.unshift(current);
+        if (current.parentId === null)
+            break;
+        current = rowMap.get(current.parentId);
+    }
+    return chain.map(row => ({
+        id: row.id,
+        title: row.title,
+        href: row.path,
+        slug: row.slug,
+        depth: row.depth,
+        hasChildren: false,
+        isActive: false,
+        isAncestor: false,
+        children: [],
+    }));
+}
+//# sourceMappingURL=builder.js.map

package/dist/nav/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/nav/builder.ts"],"names":[],"mappings":"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"}

package/dist/nav/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/nav/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nav/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/dist/nav/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './builder.js';
+//# sourceMappingURL=index.js.map

package/dist/nav/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nav/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/dist/nav/redirect-middleware.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Redirect middleware for Kywi CMS.
+ *
+ * Checks incoming URL paths against the filename archive and returns
+ * a 301 permanent redirect when an old path is found.
+ */
+export interface RedirectMiddlewareOptions {
+    /** Function that resolves a path to its final redirect target. */
+    lookupFn: (siteId: string, path: string) => Promise<string | null>;
+    /** URL path patterns to exclude from redirect checks (e.g. /api/). */
+    excludePatterns?: RegExp[];
+}
+/**
+ * Create a redirect-checking function.
+ *
+ * Returns a function that, given a siteId and path, returns either:
+ *  - a 301 Response redirecting to the new path, or
+ *  - null if no redirect applies.
+ */
+export declare function createRedirectMiddleware(opts: RedirectMiddlewareOptions): (siteId: string, path: string) => Promise<Response | null>;
+//# sourceMappingURL=redirect-middleware.d.ts.map

package/dist/nav/redirect-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-middleware.d.ts","sourceRoot":"","sources":["../../src/nav/redirect-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,yBAAyB;IACxC,kEAAkE;IAClE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAClE,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,yBAAyB,GAC9B,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAiB5D"}

package/dist/nav/redirect-middleware.js

@@ -0,0 +1,31 @@
+/**
+ * Redirect middleware for Kywi CMS.
+ *
+ * Checks incoming URL paths against the filename archive and returns
+ * a 301 permanent redirect when an old path is found.
+ */
+/**
+ * Create a redirect-checking function.
+ *
+ * Returns a function that, given a siteId and path, returns either:
+ *  - a 301 Response redirecting to the new path, or
+ *  - null if no redirect applies.
+ */
+export function createRedirectMiddleware(opts) {
+    const { lookupFn, excludePatterns = [] } = opts;
+    return async (siteId, path) => {
+        // Skip excluded paths
+        for (const pattern of excludePatterns) {
+            if (pattern.test(path))
+                return null;
+        }
+        const newPath = await lookupFn(siteId, path);
+        if (!newPath)
+            return null;
+        return new Response(null, {
+            status: 301,
+            headers: { Location: newPath },
+        });
+    };
+}
+//# sourceMappingURL=redirect-middleware.js.map

package/dist/nav/redirect-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-middleware.js","sourceRoot":"","sources":["../../src/nav/redirect-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAA+B;IAE/B,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,IAAI,CAAA;IAE/C,OAAO,KAAK,EAAE,MAAc,EAAE,IAAY,EAA4B,EAAE;QACtE,sBAAsB;QACtB,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACtC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAA;QACrC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QAEzB,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;YACxB,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;SAC/B,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}