@kywi-software/core 0.1.0

package/dist/scope/__tests__/text-utils.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest';
+import { kywiStripHtml, kywiSetParagraphs, kywiTruncate } from '../text-utils.js';
+describe('kywiStripHtml', () => {
+    it('strips HTML tags from string', () => {
+        expect(kywiStripHtml('<p>Hello <strong>world</strong></p>')).toBe('Hello world');
+    });
+    it('handles empty string', () => {
+        expect(kywiStripHtml('')).toBe('');
+    });
+    it('handles plain text without tags', () => {
+        expect(kywiStripHtml('no tags here')).toBe('no tags here');
+    });
+    it('strips nested tags', () => {
+        expect(kywiStripHtml('<div><p><em>nested</em></p></div>')).toBe('nested');
+    });
+});
+describe('kywiSetParagraphs', () => {
+    it('wraps double-newline separated blocks in <p> tags', () => {
+        expect(kywiSetParagraphs('Line one\n\nLine two')).toBe('<p>Line one</p><p>Line two</p>');
+    });
+    it('handles single block', () => {
+        expect(kywiSetParagraphs('Just one paragraph')).toBe('<p>Just one paragraph</p>');
+    });
+    it('trims whitespace between paragraphs', () => {
+        const result = kywiSetParagraphs('First\n\n  \n\nSecond');
+        expect(result).toContain('<p>First</p>');
+        expect(result).toContain('<p>Second</p>');
+    });
+});
+describe('kywiTruncate', () => {
+    it('truncates text longer than length with ellipsis', () => {
+        const result = kywiTruncate('A longer sentence here for testing', 10);
+        expect(result.endsWith('...')).toBe(true);
+        expect(result.length).toBeLessThanOrEqual(13); // 10 chars + '...'
+    });
+    it('returns text unchanged when shorter than length', () => {
+        expect(kywiTruncate('Short', 100)).toBe('Short');
+    });
+    it('respects word boundaries', () => {
+        // length=8: "Hello wo" — lastSpace is index 5, so truncates to "Hello..."
+        const result = kywiTruncate('Hello world foo bar', 8);
+        expect(result.endsWith('...')).toBe(true);
+        // Should be "Hello..." not "Hello wo..."
+        expect(result).toBe('Hello...');
+    });
+    it('uses custom suffix when provided', () => {
+        const result = kywiTruncate('A longer sentence here', 10, '…');
+        expect(result.endsWith('…')).toBe(true);
+    });
+    it('handles text exactly at the length limit', () => {
+        const text = 'Exact';
+        expect(kywiTruncate(text, 5)).toBe('Exact');
+    });
+});
+//# sourceMappingURL=text-utils.test.js.map

package/dist/scope/__tests__/text-utils.test.js.map

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

package/dist/scope/breadcrumbs.d.ts

@@ -0,0 +1,10 @@
+import type { KywiNavNode } from '../nav/types.js';
+export type BreadcrumbVariant = 'linked' | 'nolinks' | 'text' | 'schema';
+export interface KywiBreadcrumbsProps {
+    crumbs: KywiNavNode[];
+    variant?: BreadcrumbVariant;
+    separator?: string;
+    className?: string;
+}
+export declare function KywiBreadcrumbs({ crumbs, variant, separator, className, }: KywiBreadcrumbsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/scope/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/scope/breadcrumbs.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAIlD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,OAAkB,EAClB,SAAiB,EACjB,SAAS,GACV,EAAE,oBAAoB,2CAmEtB"}

package/dist/scope/breadcrumbs.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+// ─── Component ────────────────────────────────────────────────────────────────
+export function KywiBreadcrumbs({ crumbs, variant = 'linked', separator = ' > ', className, }) {
+    if (variant === 'schema') {
+        const schemaData = {
+            '@context': 'https://schema.org',
+            '@type': 'BreadcrumbList',
+            itemListElement: crumbs.map((crumb, i) => ({
+                '@type': 'ListItem',
+                position: i + 1,
+                name: crumb.title,
+                item: crumb.href,
+            })),
+        };
+        return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(schemaData) } }));
+    }
+    if (crumbs.length === 0) {
+        return _jsx("nav", { className: className, "aria-label": "breadcrumb" });
+    }
+    if (variant === 'text') {
+        return (_jsx("nav", { className: className, "aria-label": "breadcrumb", children: crumbs.map((crumb, i) => (_jsxs(React.Fragment, { children: [_jsx("span", { children: crumb.title }), i < crumbs.length - 1 && _jsx("span", { "aria-hidden": "true", children: separator })] }, crumb.id))) }));
+    }
+    if (variant === 'nolinks') {
+        return (_jsx("nav", { className: className, "aria-label": "breadcrumb", children: _jsx("ol", { children: crumbs.map((crumb, i) => (_jsx("li", { "aria-current": i === crumbs.length - 1 ? 'page' : undefined, children: _jsx("span", { children: crumb.title }) }, crumb.id))) }) }));
+    }
+    // Default: 'linked' — all items except last get an <a>
+    return (_jsx("nav", { className: className, "aria-label": "breadcrumb", children: _jsx("ol", { children: crumbs.map((crumb, i) => {
+                const isLast = i === crumbs.length - 1;
+                return (_jsx("li", { "aria-current": isLast ? 'page' : undefined, children: isLast ? (_jsx("span", { children: crumb.title })) : (_jsx("a", { href: crumb.href, children: crumb.title })) }, crumb.id));
+            }) }) }));
+}
+//# sourceMappingURL=breadcrumbs.js.map

package/dist/scope/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../../src/scope/breadcrumbs.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,iFAAiF;AAEjF,MAAM,UAAU,eAAe,CAAC,EAC9B,MAAM,EACN,OAAO,GAAG,QAAQ,EAClB,SAAS,GAAG,KAAK,EACjB,SAAS,GACY;IACrB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG;YACjB,UAAU,EAAE,oBAAoB;YAChC,OAAO,EAAE,gBAAgB;YACzB,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,CAAC,GAAG,CAAC;gBACf,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;SACJ,CAAA;QACD,OAAO,CACL,iBAAQ,IAAI,EAAC,qBAAqB,EAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,GAAI,CACvG,CAAA;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,cAAK,SAAS,EAAE,SAAS,gBAAa,YAAY,GAAG,CAAA;IAC9D,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,gBAAa,YAAY,YAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CACxB,MAAC,KAAK,CAAC,QAAQ,eACb,yBAAO,KAAK,CAAC,KAAK,GAAQ,EACzB,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,8BAAkB,MAAM,YAAE,SAAS,GAAQ,KAFlD,KAAK,CAAC,EAAE,CAGZ,CAClB,CAAC,GACE,CACP,CAAA;IACH,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,gBAAa,YAAY,YAChD,uBACG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CACxB,6BAAiC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YAC3E,yBAAO,KAAK,CAAC,KAAK,GAAQ,IADnB,KAAK,CAAC,EAAE,CAEZ,CACN,CAAC,GACC,GACD,CACP,CAAA;IACH,CAAC;IAED,uDAAuD;IACvD,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,gBAAa,YAAY,YAChD,uBACG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBACvB,MAAM,MAAM,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;gBACtC,OAAO,CACL,6BAAiC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YACzD,MAAM,CAAC,CAAC,CAAC,CACR,yBAAO,KAAK,CAAC,KAAK,GAAQ,CAC3B,CAAC,CAAC,CAAC,CACF,YAAG,IAAI,EAAE,KAAK,CAAC,IAAI,YAAG,KAAK,CAAC,KAAK,GAAK,CACvC,IALM,KAAK,CAAC,EAAE,CAMZ,CACN,CAAA;YACH,CAAC,CAAC,GACC,GACD,CACP,CAAA;AACH,CAAC"}

package/dist/scope/client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Client-safe scope exports.
+ *
+ * Import from '@kywi-software/core/scope-client' in client components and Next.js app
+ * router pages to avoid pulling in server-only modules (db, sharp, nodemailer,
+ * bcryptjs, drizzle-orm) that cannot run in a browser context.
+ *
+ * Server components and API routes should continue to use '@kywi-software/core' or
+ * '@kywi-software/core/scope' (which includes createKywiScope).
+ */
+export * from './types.js';
+export * from './provider.js';
+export * from './hooks.js';
+export * from './nav-hooks.js';
+export * from './breadcrumbs.js';
+export { KywiContent, KywiNav, KywiBody, KywiSummary, KywiDate, KywiImage, KywiCollection } from './rendering.js';
+export * from './text-utils.js';
+export * from './url-helpers.js';
+export * from './feed-hook.js';
+export * from './i18n-hook.js';
+export { KywiForm } from './kywi-form.js';
+export * from './edit-mode-hooks.js';
+export { KywiEditableAttribute, KywiEditableRegion, KywiEditToolbar, type KywiEditToolbarProps, } from './inline-editing.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/scope/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/scope/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjH,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAA"}

package/dist/scope/client.js

@@ -0,0 +1,24 @@
+/**
+ * Client-safe scope exports.
+ *
+ * Import from '@kywi-software/core/scope-client' in client components and Next.js app
+ * router pages to avoid pulling in server-only modules (db, sharp, nodemailer,
+ * bcryptjs, drizzle-orm) that cannot run in a browser context.
+ *
+ * Server components and API routes should continue to use '@kywi-software/core' or
+ * '@kywi-software/core/scope' (which includes createKywiScope).
+ */
+export * from './types.js';
+export * from './provider.js';
+export * from './hooks.js';
+export * from './nav-hooks.js';
+export * from './breadcrumbs.js';
+export { KywiContent, KywiNav, KywiBody, KywiSummary, KywiDate, KywiImage, KywiCollection } from './rendering.js';
+export * from './text-utils.js';
+export * from './url-helpers.js';
+export * from './feed-hook.js';
+export * from './i18n-hook.js';
+export { KywiForm } from './kywi-form.js';
+export * from './edit-mode-hooks.js';
+export { KywiEditableAttribute, KywiEditableRegion, KywiEditToolbar, } from './inline-editing.js';
+//# sourceMappingURL=client.js.map

package/dist/scope/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/scope/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjH,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAEhB,MAAM,qBAAqB,CAAA"}

package/dist/scope/content-accessors.d.ts

@@ -0,0 +1,43 @@
+import type { KywiContentNode } from '../config/types.js';
+import type { KywiImageOptions } from './url-helpers.js';
+export declare function getContentField<T = unknown>(content: KywiContentNode, field: string): T | undefined;
+export declare function getContentTitle(content: KywiContentNode): string;
+export declare function getContentBody(content: KywiContentNode): string | undefined;
+export declare function getContentSummary(content: KywiContentNode): string | undefined;
+export declare function getContentStatus(content: KywiContentNode): string;
+export declare function getContentSlug(content: KywiContentNode): string;
+export declare function isPublished(content: KywiContentNode): boolean;
+export declare function getContentUrl(content: KywiContentNode): string;
+/**
+ * Get an image URL for a content field that holds a media file ID.
+ * Returns null when the field is missing or empty.
+ */
+export declare function getContentImageUrl(content: KywiContentNode, fieldName: string, opts?: KywiImageOptions): string | null;
+/**
+ * Get a file download URL for a content field that holds a media file ID.
+ * Returns null when the field is missing or empty.
+ */
+export declare function getContentFileUrl(content: KywiContentNode, fieldName: string): string | null;
+/**
+ * Return the related content items attached to a content record.
+ * Related content is expected in the `_relatedContent` runtime field
+ * (populated by the scope or API layer when relationships are loaded).
+ */
+export declare function getContentRelatedContent(content: KywiContentNode): Array<{
+    id: string;
+    title: string;
+    slug: string;
+    status: string;
+    contentTypeName: string;
+}>;
+/**
+ * Return the categories assigned to a content record.
+ * Categories are expected in the `_categories` runtime field
+ * (populated by the scope or API layer when categories are loaded).
+ */
+export declare function getContentCategories(content: KywiContentNode): Array<{
+    id: string;
+    name: string;
+    slug: string;
+}>;
+//# sourceMappingURL=content-accessors.d.ts.map

package/dist/scope/content-accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-accessors.d.ts","sourceRoot":"","sources":["../../src/scope/content-accessors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAEnG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAyB;AAC1F,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAA8C;AAC1H,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAAiD;AAChI,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAA0B;AAC5F,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAwB;AACxF,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAA0C;AACxG,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAA8C;AAE7G;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,gBAAgB,GACtB,MAAM,GAAG,IAAI,CAIf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAIf;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAI7F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,GACvB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAInD"}

package/dist/scope/content-accessors.js

@@ -0,0 +1,54 @@
+import { createKywiImageUrl, createKywiFileUrl } from './url-helpers.js';
+export function getContentField(content, field) {
+    return content[field];
+}
+export function getContentTitle(content) { return content.title; }
+export function getContentBody(content) { return content.body; }
+export function getContentSummary(content) { return content.summary; }
+export function getContentStatus(content) { return content.status; }
+export function getContentSlug(content) { return content.slug; }
+export function isPublished(content) { return content.status === 'published'; }
+export function getContentUrl(content) { return content.path || `/${content.slug}`; }
+/**
+ * Get an image URL for a content field that holds a media file ID.
+ * Returns null when the field is missing or empty.
+ */
+export function getContentImageUrl(content, fieldName, opts) {
+    const fileId = content[fieldName];
+    if (typeof fileId !== 'string' || fileId === '')
+        return null;
+    return createKywiImageUrl(fileId, opts);
+}
+/**
+ * Get a file download URL for a content field that holds a media file ID.
+ * Returns null when the field is missing or empty.
+ */
+export function getContentFileUrl(content, fieldName) {
+    const fileId = content[fieldName];
+    if (typeof fileId !== 'string' || fileId === '')
+        return null;
+    return createKywiFileUrl(fileId);
+}
+/**
+ * Return the related content items attached to a content record.
+ * Related content is expected in the `_relatedContent` runtime field
+ * (populated by the scope or API layer when relationships are loaded).
+ */
+export function getContentRelatedContent(content) {
+    const related = content._relatedContent;
+    if (!Array.isArray(related))
+        return [];
+    return related;
+}
+/**
+ * Return the categories assigned to a content record.
+ * Categories are expected in the `_categories` runtime field
+ * (populated by the scope or API layer when categories are loaded).
+ */
+export function getContentCategories(content) {
+    const cats = content._categories;
+    if (!Array.isArray(cats))
+        return [];
+    return cats;
+}
+//# sourceMappingURL=content-accessors.js.map

package/dist/scope/content-accessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-accessors.js","sourceRoot":"","sources":["../../src/scope/content-accessors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGxE,MAAM,UAAU,eAAe,CAAc,OAAwB,EAAE,KAAa;IAClF,OAAO,OAAO,CAAC,KAAK,CAAkB,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAwB,IAAY,OAAO,OAAO,CAAC,KAAK,CAAA,CAAC,CAAC;AAC1F,MAAM,UAAU,cAAc,CAAC,OAAwB,IAAwB,OAAO,OAAO,CAAC,IAA0B,CAAA,CAAC,CAAC;AAC1H,MAAM,UAAU,iBAAiB,CAAC,OAAwB,IAAwB,OAAO,OAAO,CAAC,OAA6B,CAAA,CAAC,CAAC;AAChI,MAAM,UAAU,gBAAgB,CAAC,OAAwB,IAAY,OAAO,OAAO,CAAC,MAAM,CAAA,CAAC,CAAC;AAC5F,MAAM,UAAU,cAAc,CAAC,OAAwB,IAAY,OAAO,OAAO,CAAC,IAAI,CAAA,CAAC,CAAC;AACxF,MAAM,UAAU,WAAW,CAAC,OAAwB,IAAa,OAAO,OAAO,CAAC,MAAM,KAAK,WAAW,CAAA,CAAC,CAAC;AACxG,MAAM,UAAU,aAAa,CAAC,OAAwB,IAAY,OAAO,OAAO,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA,CAAC,CAAC;AAE7G;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,SAAiB,EACjB,IAAuB;IAEvB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC5D,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAwB,EACxB,SAAiB;IAEjB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC5D,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAwB;IAExB,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAA;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,OAAO,OAAsG,CAAA;AAC/G,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwB;IAExB,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAA;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IACnC,OAAO,IAAyD,CAAA;AAClE,CAAC"}

package/dist/scope/create-scope.d.ts

@@ -0,0 +1,28 @@
+import type { KywiConfig } from '../config/types.js';
+import type { KywiDb } from '../db/client.js';
+import type { ResourceBundles } from '../i18n/types.js';
+import type { KywiScope } from './types.js';
+export interface CreateKywiScopeOptions {
+    /**
+     * Base path the API handler is mounted at, used to build media URLs. Defaults
+     * to `/api/kywi` (decoupled-mode convention); a coupled app that mounts the
+     * handler elsewhere (e.g. the reference app at `/api/v1`) passes its own so
+     * `media.getImageUrl` resolves to a URL that actually serves the file.
+     */
+    mediaBaseUrl?: string;
+}
+/**
+ * Factory function that builds a KywiScope from config and db.
+ * Equivalent to the map-building in createKywiApiHandler.
+ */
+export declare function createKywiScope(config: KywiConfig, db: KywiDb, bundles?: ResourceBundles, options?: CreateKywiScopeOptions): KywiScope;
+/**
+ * Attach a custom key/value to an existing scope's extensions namespace.
+ * Useful for plugins that need to register their own sub-scopes.
+ *
+ * @example
+ *   setKywiScopeKey(scope, 'analytics', { track(event) { ... } })
+ *   // later: (scope.extensions.analytics as AnalyticsScope).track('pageview')
+ */
+export declare function setKywiScopeKey(scope: KywiScope, key: string, value: unknown): void;
+//# sourceMappingURL=create-scope.d.ts.map

package/dist/scope/create-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scope.d.ts","sourceRoot":"","sources":["../../src/scope/create-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAmB7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAgH,MAAM,YAAY,CAAA;AAIzJ,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,SAAS,CA+OX;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEnF"}

package/dist/scope/create-scope.js

@@ -0,0 +1,234 @@
+import { getContentById, getContentBySlug, listContent, createContent, updateContent, deleteContent, publishContent, } from '../db/content-queries.js';
+import { getNavContentForSite, getChildren as getNavChildren } from '../db/tree-queries.js';
+import { buildNavTree, buildBreadcrumbs, selectLocaleNavRows } from '../nav/builder.js';
+import { getSiteById, listSites, resolveSiteId } from '../db/site-queries.js';
+import { getUserById } from '../db/user-queries.js';
+import { buildCustomFieldTable } from '../db/dynamic-schema.js';
+import { getFeedBySlug } from '../db/feed-queries.js';
+import { executeFeedQuery } from '../feeds/engine.js';
+import { resolveTranslation } from '../i18n/resolver.js';
+import { getMediaById } from '../db/media-queries.js';
+import { collectPluginContributions } from '../hooks/plugin-loader.js';
+/**
+ * Factory function that builds a KywiScope from config and db.
+ * Equivalent to the map-building in createKywiApiHandler.
+ */
+export function createKywiScope(config, db, bundles, options) {
+    const mediaBaseUrl = options?.mediaBaseUrl ?? '/api/kywi';
+    // Build maps from config (same pattern as createKywiApiHandler)
+    const contentTypeMap = new Map();
+    const customTableMap = new Map();
+    for (const ct of config.contentTypes) {
+        contentTypeMap.set(ct.name, ct);
+        customTableMap.set(ct.name, buildCustomFieldTable(ct));
+    }
+    // ─── Content Sub-scope ──────────────────────────────────────────────────────
+    // Resolve the content-type custom field table (kywi_ct_*) for a fetched base
+    // row, so getById/getBySlug merge in custom fields (e.g. an article's excerpt)
+    // instead of returning only base columns. Mirrors the by-id route pattern:
+    // fetch the base row to learn its type, then re-fetch through the join.
+    const customTableFor = (row) => (row && typeof row.contentTypeName === 'string' ? customTableMap.get(row.contentTypeName) : null) ?? null;
+    async function fetchByIdWithCustom(id) {
+        const base = await getContentById(db, null, id);
+        const customTable = customTableFor(base);
+        return customTable ? getContentById(db, customTable, id) : base;
+    }
+    const content = {
+        getById: fetchByIdWithCustom,
+        async getByIds(ids) {
+            // Fetch all in parallel, preserving input order, filtering nulls
+            const results = await Promise.all(ids.map(fetchByIdWithCustom));
+            return results.filter((r) => r !== null);
+        },
+        async getBySlug(slug, siteId, options) {
+            const base = await getContentBySlug(db, null, slug, siteId, options);
+            const customTable = customTableFor(base);
+            return customTable ? getContentBySlug(db, customTable, slug, siteId, options) : base;
+        },
+        async getChildren(parentId) {
+            const rows = await getNavChildren(db, parentId);
+            return rows;
+        },
+        async list(contentTypeName, siteId, pagination, sort, filters) {
+            const contentType = contentTypeMap.get(contentTypeName);
+            if (!contentType)
+                return { rows: [], total: 0 };
+            const customTable = customTableMap.get(contentTypeName) ?? null;
+            return listContent(db, contentType, customTable, siteId, pagination, sort, filters);
+        },
+        async create(contentTypeName, siteId, data, userId) {
+            const contentType = contentTypeMap.get(contentTypeName);
+            if (!contentType)
+                throw new Error(`Unknown content type: ${contentTypeName}`);
+            const customTable = customTableMap.get(contentTypeName) ?? null;
+            return createContent(db, contentType, customTable, siteId, data, userId);
+        },
+        async update(contentTypeName, id, data, userId) {
+            const contentType = contentTypeMap.get(contentTypeName);
+            if (!contentType)
+                throw new Error(`Unknown content type: ${contentTypeName}`);
+            const customTable = customTableMap.get(contentTypeName) ?? null;
+            return updateContent(db, contentType, customTable, id, data, userId);
+        },
+        async delete(id) {
+            return deleteContent(db, id);
+        },
+        async publish(id) {
+            return publishContent(db, id);
+        },
+        async getVersions(id) {
+            const { kywiContentVersions } = await import('../schema/base.js');
+            const { eq, asc } = await import('drizzle-orm');
+            return db
+                .select()
+                .from(kywiContentVersions)
+                .where(eq(kywiContentVersions.contentId, id))
+                .orderBy(asc(kywiContentVersions.version));
+        },
+        async restoreVersion(id, versionId) {
+            const { kywiContentVersions } = await import('../schema/base.js');
+            const { eq } = await import('drizzle-orm');
+            // Fetch the version snapshot
+            const [versionRow] = await db
+                .select()
+                .from(kywiContentVersions)
+                .where(eq(kywiContentVersions.id, versionId))
+                .limit(1);
+            if (!versionRow)
+                return null;
+            const snapshot = versionRow.snapshot;
+            // Update the content with the snapshot data
+            const { kywiContent } = await import('../schema/base.js');
+            const [updated] = await db
+                .update(kywiContent)
+                .set({ ...snapshot, updatedAt: new Date() })
+                .where(eq(kywiContent.id, id))
+                .returning();
+            return updated ?? null;
+        },
+    };
+    // ─── Nav Sub-scope ──────────────────────────────────────────────────────────
+    const navDefaultLocale = config.sites[0]?.defaultLocale ?? 'en';
+    const nav = {
+        async getTree(siteId, currentPath, opts) {
+            const rows = await getNavContentForSite(db, siteId);
+            const locale = opts?.locale ?? navDefaultLocale;
+            const localized = selectLocaleNavRows(rows, locale, navDefaultLocale);
+            return buildNavTree(localized, currentPath);
+        },
+        async getBreadcrumbs(siteId, nodeId) {
+            const rows = await getNavContentForSite(db, siteId);
+            return buildBreadcrumbs(rows, nodeId);
+        },
+        async getChildren(parentId) {
+            const rows = await getNavChildren(db, parentId);
+            return rows.map(row => ({
+                id: row.id,
+                title: row.title,
+                href: row.path,
+                slug: row.slug,
+                depth: row.depth,
+                hasChildren: false,
+                isActive: false,
+                isAncestor: false,
+                children: [],
+            }));
+        },
+    };
+    // ─── Site Sub-scope ─────────────────────────────────────────────────────────
+    const site = {
+        async getConfig(siteId) {
+            return getSiteById(db, siteId);
+        },
+        async list() {
+            return listSites(db);
+        },
+    };
+    // ─── User Sub-scope ─────────────────────────────────────────────────────────
+    const user = {
+        async getById(id) {
+            const row = await getUserById(db, id);
+            if (!row)
+                return null;
+            // Strip passwordHash before returning
+            const { passwordHash: _pw, ...safe } = row;
+            return safe;
+        },
+        async getCurrent(id) {
+            const row = await getUserById(db, id);
+            if (!row)
+                return null;
+            const { passwordHash: _pw, ...safe } = row;
+            return safe;
+        },
+    };
+    // ─── Feed Sub-scope ─────────────────────────────────────────────────────────
+    const defaultSiteId = config.sites[0]?.id ?? '';
+    const feeds = {
+        async query(feedQuery) {
+            return executeFeedQuery(db, feedQuery, contentTypeMap, customTableMap);
+        },
+        async get(slug) {
+            // config.sites[0].id is the human-readable site *slug* ("default"), but
+            // kywi_feeds.siteId is a UUID FK. Resolve the slug to the DB UUID before
+            // the lookup so a saved feed can actually be found (the "config slug leaked
+            // into a uuid column" bug class). A UUID passes through untouched.
+            const siteUuid = (await resolveSiteId(db, defaultSiteId)) ?? defaultSiteId;
+            const feed = await getFeedBySlug(db, slug, siteUuid);
+            if (!feed)
+                throw new Error(`Feed not found: ${slug}`);
+            return executeFeedQuery(db, feed.query, contentTypeMap, customTableMap);
+        },
+    };
+    // ─── I18n Sub-scope ────────────────────────────────────────────────────────
+    const defaultLocale = config.sites[0]?.defaultLocale ?? 'en';
+    const i18n = bundles ? {
+        get(key, locale, vars) {
+            const effectiveLocale = locale ?? defaultLocale;
+            return resolveTranslation(bundles, key, effectiveLocale, defaultLocale, vars);
+        },
+        getLocale() {
+            return defaultLocale;
+        },
+    } : undefined;
+    // ─── Media Sub-scope ────────────────────────────────────────────────────────
+    const media = {
+        async getById(id) {
+            // The scope is bound to a single site (config.sites[0]); scope the media
+            // lookup to that site's UUID so a media id from another site does not leak
+            // through this accessor.
+            const siteUuid = (await resolveSiteId(db, defaultSiteId)) ?? defaultSiteId;
+            const row = await getMediaById(db, id, siteUuid);
+            return row;
+        },
+        getImageUrl(id, size) {
+            return size
+                ? `${mediaBaseUrl}/media/${id}/variant/${size}`
+                : `${mediaBaseUrl}/media/${id}/file`;
+        },
+    };
+    const scope = { content, nav, site, user, feeds, media, extensions: {} };
+    if (i18n !== undefined) {
+        scope.i18n = i18n;
+    }
+    // Attach inline plugins' scopeExtensions (G2) into the extensions namespace so
+    // templates/route handlers can call e.g. `scope.extensions.myPlugin.foo()`.
+    // Factory-form extensions are resolved with the plugin's static config.
+    const pluginExtensions = collectPluginContributions(config.plugins ?? []).scopeExtensions;
+    for (const [key, value] of Object.entries(pluginExtensions)) {
+        setKywiScopeKey(scope, key, value);
+    }
+    return scope;
+}
+/**
+ * Attach a custom key/value to an existing scope's extensions namespace.
+ * Useful for plugins that need to register their own sub-scopes.
+ *
+ * @example
+ *   setKywiScopeKey(scope, 'analytics', { track(event) { ... } })
+ *   // later: (scope.extensions.analytics as AnalyticsScope).track('pageview')
+ */
+export function setKywiScopeKey(scope, key, value) {
+    scope.extensions[key] = value;
+}
+//# sourceMappingURL=create-scope.js.map

package/dist/scope/create-scope.js.map

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

package/dist/scope/csrf.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+export interface KywiCsrfTokenProps {
+    /** The CSRF token value to embed in the form. */
+    token: string;
+    /** Hidden input field name (default `_csrf`). */
+    name?: string;
+}
+/** Renders a hidden <input> carrying the CSRF token. */
+export declare function KywiCsrfToken({ token, name }: KywiCsrfTokenProps): React.ReactElement;
+/**
+ * Validate that the CSRF token submitted in the request matches the one stored
+ * in the `kywi_csrf` cookie. Returns `true` when valid.
+ */
+export declare function validateKywiCsrf(request: Request): Promise<boolean>;
+//# sourceMappingURL=csrf.d.ts.map

package/dist/scope/csrf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csrf.d.ts","sourceRoot":"","sources":["../../src/scope/csrf.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,IAAc,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAE/F;AAsCD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzE"}