@kywi-software/core 0.1.0

package/dist/scope/rendering.js

@@ -0,0 +1,151 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+export function KywiContent({ title, body, className, children }) {
+    const cls = ['kywi-content', className].filter(Boolean).join(' ');
+    return (_jsxs("article", { className: cls, children: [title && _jsx("h1", { children: title }), body !== undefined && (
+            // body is CMS-authored HTML from the admin WYSIWYG editor — trusted content
+            // eslint-disable-next-line react/no-danger
+            _jsx("div", { className: "kywi-content-body", dangerouslySetInnerHTML: { __html: body } })), children] }));
+}
+function NavList({ items, currentPath, depth, }) {
+    return (_jsx("ul", { children: items.map((item) => {
+            const isActive = item.path === currentPath;
+            const liClass = isActive ? 'kywi-nav-item active' : 'kywi-nav-item';
+            return (_jsxs("li", { className: liClass, children: [_jsx("a", { href: item.path, children: item.title }), item.children && item.children.length > 0 && (_jsx(NavList, { items: item.children, currentPath: currentPath, depth: depth + 1 }))] }, item.id));
+        }) }));
+}
+export function KywiNav({ items, currentPath, className, depth = 0 }) {
+    const cls = ['kywi-nav', className].filter(Boolean).join(' ');
+    return (_jsx("nav", { className: cls, children: _jsx(NavList, { items: items, currentPath: currentPath, depth: depth }) }));
+}
+export function KywiBody({ content, className, showMetaImage, metaImageSrc, metaImageAlt, metaImageSize, showTitle, title, showBreadcrumbs, breadcrumbs, nodeId, }) {
+    const cls = ['kywi-body', className].filter(Boolean).join(' ');
+    const divProps = { className: cls };
+    if (nodeId)
+        divProps['data-node-id'] = nodeId;
+    return (_jsxs("div", { ...divProps, children: [showBreadcrumbs && breadcrumbs, showMetaImage && metaImageSrc && (_jsx("div", { className: ['kywi-meta-image', metaImageSize ? `kywi-meta-image--${metaImageSize}` : ''].filter(Boolean).join(' '), children: _jsx("img", { src: metaImageSrc, alt: metaImageAlt ?? '' }) })), showTitle && title && _jsx("h1", { className: "kywi-body-title", children: title }), _jsx("div", { className: "kywi-body-content", dangerouslySetInnerHTML: { __html: content } })] }));
+}
+export function KywiSummary({ text, className }) {
+    const cls = ['kywi-summary', className].filter(Boolean).join(' ');
+    return _jsx("p", { className: cls, children: text });
+}
+export function KywiDate({ date, className }) {
+    const cls = ['kywi-date', className].filter(Boolean).join(' ');
+    return (_jsx("time", { className: cls, dateTime: date.toISOString(), children: date.toLocaleDateString() }));
+}
+export function KywiImage({ src, alt, width, height, className }) {
+    const cls = ['kywi-image', className].filter(Boolean).join(' ');
+    return _jsx("img", { className: cls, src: src, alt: alt, width: width, height: height });
+}
+export function KywiCollection({ className, children }) {
+    const cls = ['kywi-collection', className].filter(Boolean).join(' ');
+    return _jsx("div", { className: cls, children: children });
+}
+/**
+ * Auto-dispatch by baseType: folder -> folder layout, event -> event layout, etc.
+ */
+export function KywiContentTypeBody({ baseType, title, body, className, children }) {
+    const cls = ['kywi-content-type', `kywi-content-type--${baseType}`, className].filter(Boolean).join(' ');
+    return (_jsxs("article", { className: cls, "data-base-type": baseType, children: [title && _jsx("h1", { className: "kywi-content-type-title", children: title }), body !== undefined && (
+            // body is CMS-authored HTML from the admin WYSIWYG editor — trusted content
+            // eslint-disable-next-line react/no-danger
+            _jsx("div", { className: "kywi-content-type-body", dangerouslySetInnerHTML: { __html: body } })), children] }));
+}
+/**
+ * Split CMS content on `<!-- pagebreak -->` markers and render pagination.
+ */
+export function KywiMultiPageContent({ content, currentPage, className, baseUrl = '' }) {
+    const cls = ['kywi-multipage', className].filter(Boolean).join(' ');
+    const pages = content.split(/<!--\s*pagebreak\s*-->/);
+    const totalPages = pages.length;
+    // Clamp to valid page range
+    const pageIndex = Math.max(0, Math.min(currentPage - 1, totalPages - 1));
+    const pageContent = pages[pageIndex] ?? '';
+    return (_jsxs("div", { className: cls, children: [_jsx("div", { className: "kywi-multipage-content", dangerouslySetInnerHTML: { __html: pageContent } }), totalPages > 1 && (_jsx("nav", { className: "kywi-pagination", children: pages.map((_, i) => {
+                    const pageNum = i + 1;
+                    const isCurrentPage = i === pageIndex;
+                    return (_jsx("a", { href: baseUrl ? `${baseUrl}?page=${pageNum}` : `?page=${pageNum}`, className: ['kywi-pagination-link', isCurrentPage ? 'active' : ''].filter(Boolean).join(' '), "aria-current": isCurrentPage ? 'page' : undefined, children: pageNum }, pageNum));
+                }) }))] }));
+}
+/**
+ * Named region wrapper for layout sections.
+ * Usage: `<KywiSection region="sidebar" as="aside">`
+ */
+export function KywiSection({ region, as: Element = 'div', className, children }) {
+    const cls = ['kywi-section', `kywi-section--${region}`, className].filter(Boolean).join(' ');
+    return React.createElement(Element, { className: cls, 'data-region': region }, children);
+}
+/**
+ * Explicit module embedding placeholder.
+ * Usage: `<KywiModule name="feedDisplay" props={{ limit: 5 }} />`
+ */
+export function KywiModule({ name, props: moduleProps, className, children }) {
+    const cls = ['kywi-module', `kywi-module--${name}`, className].filter(Boolean).join(' ');
+    const divProps = {
+        className: cls,
+        'data-module': name,
+    };
+    if (moduleProps) {
+        divProps['data-module-props'] = JSON.stringify(moduleProps);
+    }
+    return _jsx("div", { ...divProps, children: children });
+}
+/**
+ * Embed a Component content node by slug or id.
+ */
+export function KywiComponent({ slug, id, className, children }) {
+    const cls = ['kywi-component', className].filter(Boolean).join(' ');
+    const divProps = { className: cls };
+    if (slug)
+        divProps['data-component'] = slug;
+    if (id)
+        divProps['data-component-id'] = id;
+    return _jsx("div", { ...divProps, children: children });
+}
+/**
+ * Standalone feed display component.
+ * Renders a list of content items with configurable layout.
+ */
+export function KywiFeedDisplay({ items, layout = 'list', showSummary = false, showImage = false, showDate = false, className, }) {
+    const cls = ['kywi-feed-display', `kywi-feed-display--${layout}`, className].filter(Boolean).join(' ');
+    return (_jsx("div", { className: cls, children: items.map((item, index) => {
+            const itemId = item.id != null ? String(item.id) : String(index);
+            const itemTitle = item.title != null ? String(item.title) : '';
+            const itemSummary = item.summary != null ? String(item.summary) : '';
+            const itemImage = item.image != null ? String(item.image) : '';
+            const itemDate = item.date != null ? String(item.date) : '';
+            const itemHref = item.href != null ? String(item.href) : item.slug != null ? `/${String(item.slug)}` : '#';
+            return (_jsxs("div", { className: "kywi-feed-item", children: [showImage && itemImage && (_jsx("img", { className: "kywi-feed-item-image", src: itemImage, alt: itemTitle })), _jsxs("div", { className: "kywi-feed-item-content", children: [_jsx("h3", { className: "kywi-feed-item-title", children: _jsx("a", { href: itemHref, children: itemTitle }) }), showSummary && itemSummary && (_jsx("p", { className: "kywi-feed-item-summary", children: itemSummary })), showDate && itemDate && (_jsx("span", { className: "kywi-feed-item-date", children: itemDate }))] })] }, itemId));
+        }) }));
+}
+/**
+ * Weighted tag cloud component.
+ * Assigns weight classes based on relative tag count.
+ */
+export function KywiTagCloud({ tags, className, weightBuckets = 5 }) {
+    const cls = ['kywi-tag-cloud', className].filter(Boolean).join(' ');
+    // Compute weight bucket for each tag
+    const maxCount = Math.max(...tags.map(t => t.count), 1);
+    const buckets = Math.max(1, Math.min(weightBuckets, 5));
+    return (_jsx("div", { className: cls, children: tags.map(tag => {
+            const weight = Math.ceil((tag.count / maxCount) * buckets);
+            return (_jsx("a", { href: tag.href, className: `kywi-tag kywi-tag--weight-${weight}`, children: tag.name }, tag.name));
+        }) }));
+}
+/**
+ * Template file inclusion from the theme directory.
+ * Renders a placeholder div that server-side rendering resolves to the file content.
+ */
+export function KywiThemeInclude({ file, className }) {
+    const cls = ['kywi-theme-include', className].filter(Boolean).join(' ');
+    return _jsx("div", { className: cls, "data-include": file });
+}
+/**
+ * Generic template file inclusion.
+ * Renders a placeholder div that server-side rendering resolves to the file content.
+ */
+export function KywiInclude({ file, className }) {
+    const cls = ['kywi-include', className].filter(Boolean).join(' ');
+    return _jsx("div", { className: cls, "data-include": file });
+}
+//# sourceMappingURL=rendering.js.map

package/dist/scope/rendering.js.map

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

package/dist/scope/search-hook.d.ts

@@ -0,0 +1,21 @@
+interface UseSearchReturn {
+    results: Array<{
+        id: string;
+        title: string;
+        slug: string;
+        contentTypeName: string;
+    }>;
+    isLoading: boolean;
+    error: Error | null;
+    total: number;
+    page: number;
+    totalPages: number;
+}
+export declare function useKywiSearch(query: string, opts?: {
+    contentType?: string;
+    limit?: number;
+    page?: number;
+    siteId?: string;
+}): UseSearchReturn;
+export {};
+//# sourceMappingURL=search-hook.d.ts.map

package/dist/scope/search-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-hook.d.ts","sourceRoot":"","sources":["../../src/scope/search-hook.tsx"],"names":[],"mappings":"AAIA,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpF,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,eAAe,CA6DjB"}

package/dist/scope/search-hook.js

@@ -0,0 +1,62 @@
+'use client';
+import { useState, useEffect } from 'react';
+import { useKywiScope } from './provider.js';
+export function useKywiSearch(query, opts) {
+    const { scope } = useKywiScope();
+    const [results, setResults] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [total, setTotal] = useState(0);
+    const [page, setPage] = useState(opts?.page ?? 1);
+    const [totalPages, setTotalPages] = useState(0);
+    useEffect(() => {
+        if (!query.trim()) {
+            setResults([]);
+            setTotal(0);
+            setPage(opts?.page ?? 1);
+            setTotalPages(0);
+            setIsLoading(false);
+            return;
+        }
+        let cancelled = false;
+        async function runSearch() {
+            setIsLoading(true);
+            setError(null);
+            try {
+                const feedResult = await scope.feeds.query({
+                    contentType: opts?.contentType ?? '',
+                    search: query,
+                    limit: opts?.limit ?? 20,
+                    page: opts?.page ?? 1,
+                    siteId: opts?.siteId,
+                    status: 'published',
+                });
+                if (!cancelled) {
+                    setResults(feedResult.items.map(item => ({
+                        id: String(item.id ?? ''),
+                        title: String(item.title ?? ''),
+                        slug: String(item.slug ?? ''),
+                        contentTypeName: String(item.contentTypeName ?? ''),
+                    })));
+                    setTotal(feedResult.total);
+                    setPage(feedResult.page);
+                    setTotalPages(feedResult.totalPages);
+                }
+            }
+            catch (err) {
+                if (!cancelled)
+                    setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        }
+        runSearch();
+        return () => {
+            cancelled = true;
+        };
+    }, [query, opts?.contentType, opts?.limit, opts?.page, opts?.siteId]);
+    return { results, isLoading, error, total, page, totalPages };
+}
+//# sourceMappingURL=search-hook.js.map

package/dist/scope/search-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-hook.js","sourceRoot":"","sources":["../../src/scope/search-hook.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAW5C,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,IAA+E;IAE/E,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAA;IAChC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAA6B,EAAE,CAAC,CAAA;IACtE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IACrC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAA;IACjD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,UAAU,CAAC,EAAE,CAAC,CAAA;YACd,QAAQ,CAAC,CAAC,CAAC,CAAA;YACX,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAA;YACxB,aAAa,CAAC,CAAC,CAAC,CAAA;YAChB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QAErB,KAAK,UAAU,SAAS;YACtB,YAAY,CAAC,IAAI,CAAC,CAAA;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;YACd,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;oBACzC,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE;oBACpC,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;oBACxB,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;oBACrB,MAAM,EAAE,IAAI,EAAE,MAAM;oBACpB,MAAM,EAAE,WAAW;iBACpB,CAAC,CAAA;gBACF,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,UAAU,CACR,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC5B,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;wBACzB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;wBAC/B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;wBAC7B,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;qBACpD,CAAC,CAAC,CACJ,CAAA;oBACD,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;oBAC1B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;oBACxB,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;gBACtC,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,SAAS;oBAAE,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC/E,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAED,SAAS,EAAE,CAAA;QAEX,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAErE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAC/D,CAAC"}

package/dist/scope/text-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Strip HTML tags from a string.
+ */
+export declare function kywiStripHtml(html: string): string;
+/**
+ * Split text on double newlines and wrap each block in <p> tags.
+ */
+export declare function kywiSetParagraphs(text: string): string;
+/**
+ * Truncate text to length characters, respecting word boundaries.
+ * If text fits within length, returns it unchanged.
+ * Otherwise finds last space before length and appends suffix.
+ */
+export declare function kywiTruncate(text: string, length: number, suffix?: string): string;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/scope/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../../src/scope/text-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAc,GAAG,MAAM,CAazF"}

package/dist/scope/text-utils.js

@@ -0,0 +1,35 @@
+/**
+ * Strip HTML tags from a string.
+ */
+export function kywiStripHtml(html) {
+    return html.replace(/<[^>]*>/g, '');
+}
+/**
+ * Split text on double newlines and wrap each block in <p> tags.
+ */
+export function kywiSetParagraphs(text) {
+    const blocks = text.split(/\n\s*\n/);
+    return blocks
+        .map(block => block.trim())
+        .filter(block => block.length > 0)
+        .map(block => `<p>${block}</p>`)
+        .join('');
+}
+/**
+ * Truncate text to length characters, respecting word boundaries.
+ * If text fits within length, returns it unchanged.
+ * Otherwise finds last space before length and appends suffix.
+ */
+export function kywiTruncate(text, length, suffix = '...') {
+    if (text.length <= length)
+        return text;
+    // Find last space at or before the length limit
+    const slice = text.slice(0, length);
+    const lastSpace = slice.lastIndexOf(' ');
+    if (lastSpace === -1) {
+        // No space found — cut at length
+        return slice + suffix;
+    }
+    return slice.slice(0, lastSpace) + suffix;
+}
+//# sourceMappingURL=text-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.js","sourceRoot":"","sources":["../../src/scope/text-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACpC,OAAO,MAAM;SACV,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC;SAC/B,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,SAAiB,KAAK;IAC/E,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAA;IAEtC,gDAAgD;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAExC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,iCAAiC;QACjC,OAAO,KAAK,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,MAAM,CAAA;AAC3C,CAAC"}

package/dist/scope/types.d.ts

@@ -0,0 +1,69 @@
+import type { KywiNavNode } from '../nav/types.js';
+import type { ContentWithCustomFields } from '../db/content-queries.js';
+import type { PaginationParams, SortParams, FilterParams } from '../api/pagination.js';
+export interface KywiContentScope {
+    getBySlug(slug: string, siteId: string, options?: {
+        locale?: string;
+    }): Promise<ContentWithCustomFields | null>;
+    getById(id: string): Promise<ContentWithCustomFields | null>;
+    /** Batch fetch multiple content items by ID, preserving input order. */
+    getByIds(ids: string[]): Promise<ContentWithCustomFields[]>;
+    getChildren(parentId: string): Promise<ContentWithCustomFields[]>;
+    list(contentTypeName: string, siteId: string, pagination: PaginationParams, sort: SortParams, filters: FilterParams): Promise<{
+        rows: ContentWithCustomFields[];
+        total: number;
+    }>;
+    create(contentTypeName: string, siteId: string, data: Record<string, unknown>, userId: string | null): Promise<ContentWithCustomFields>;
+    update(contentTypeName: string, id: string, data: Record<string, unknown>, userId: string | null): Promise<ContentWithCustomFields | null>;
+    delete(id: string): Promise<boolean>;
+    publish(id: string): Promise<ContentWithCustomFields | null>;
+    /** Return version history for a content item. */
+    getVersions(id: string): Promise<Array<Record<string, unknown>>>;
+    /** Restore a content item to a previous version snapshot. */
+    restoreVersion(id: string, versionId: string): Promise<ContentWithCustomFields | null>;
+}
+export interface KywiNavScope {
+    /**
+     * Build the public nav tree. Pass `opts.locale` to get the localized tree:
+     * each nav item collapses to its translation for that locale (falling back to
+     * the site default when missing), and non-default-locale hrefs are prefixed
+     * with the locale segment. Omitting the locale returns the site-default tree.
+     */
+    getTree(siteId: string, currentPath: string, opts?: {
+        locale?: string;
+    }): Promise<KywiNavNode[]>;
+    getBreadcrumbs(siteId: string, nodeId: string): Promise<KywiNavNode[]>;
+    getChildren(parentId: string): Promise<KywiNavNode[]>;
+}
+export interface KywiSiteScope {
+    getConfig(siteId: string): Promise<Record<string, unknown> | null>;
+    list(): Promise<Record<string, unknown>[]>;
+}
+export interface KywiUserScope {
+    getCurrent(id: string): Promise<Record<string, unknown> | null>;
+    getById(id: string): Promise<Record<string, unknown> | null>;
+}
+export interface KywiFeedScope {
+    query(feedQuery: import('../feeds/types.js').FeedQuery): Promise<import('../feeds/types.js').FeedResult>;
+    get(slug: string): Promise<import('../feeds/types.js').FeedResult>;
+}
+export interface KywiI18nScope {
+    get(key: string, locale?: string, vars?: Record<string, string>): string;
+    getLocale(): string;
+}
+export interface KywiMediaScopeDb {
+    getById(id: string): Promise<Record<string, unknown> | null>;
+    getImageUrl(id: string, size?: string): string;
+}
+export interface KywiScope {
+    content: KywiContentScope;
+    nav: KywiNavScope;
+    site: KywiSiteScope;
+    user: KywiUserScope;
+    feeds: KywiFeedScope;
+    media?: KywiMediaScopeDb;
+    i18n?: KywiI18nScope;
+    /** Plugin extension point — attach custom scope methods via `scope.extensions.myPlugin = { ... }` */
+    extensions: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/scope/types.js

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

package/dist/scope/types.js.map

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

package/dist/scope/url-helpers.d.ts

@@ -0,0 +1,26 @@
+export interface KywiImageOptions {
+    size?: string;
+    w?: number;
+    h?: number;
+}
+/**
+ * Build an href from a nav node or slug string.
+ * - If string: ensure it has a leading '/'
+ * - If object: use .path first, then .slug with leading '/'
+ */
+export declare function createKywiHref(nodeOrSlug: string | {
+    path?: string;
+    slug?: string;
+}): string;
+/**
+ * Build a media image URL with optional size variant or on-the-fly resize.
+ * - `opts.size`   → /api/kywi/media/:id/variant/:size  (pre-generated variant)
+ * - `opts.w`/`h`  → /api/kywi/media/:id/resize?w=…&h=… (on-the-fly resize)
+ * - no opts       → /api/kywi/media/:id/file
+ */
+export declare function createKywiImageUrl(fileId: string, opts?: KywiImageOptions): string;
+/**
+ * Build a media file URL (no image transforms).
+ */
+export declare function createKywiFileUrl(fileId: string): string;
+//# sourceMappingURL=url-helpers.d.ts.map

package/dist/scope/url-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-helpers.d.ts","sourceRoot":"","sources":["../../src/scope/url-helpers.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAc5F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,MAAM,CAWtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/scope/url-helpers.js

@@ -0,0 +1,46 @@
+// ─── Types ────────────────────────────────────────────────────────────────────
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Build an href from a nav node or slug string.
+ * - If string: ensure it has a leading '/'
+ * - If object: use .path first, then .slug with leading '/'
+ */
+export function createKywiHref(nodeOrSlug) {
+    if (typeof nodeOrSlug === 'string') {
+        return nodeOrSlug.startsWith('/') ? nodeOrSlug : `/${nodeOrSlug}`;
+    }
+    if (nodeOrSlug.path) {
+        return nodeOrSlug.path.startsWith('/') ? nodeOrSlug.path : `/${nodeOrSlug.path}`;
+    }
+    if (nodeOrSlug.slug) {
+        return nodeOrSlug.slug.startsWith('/') ? nodeOrSlug.slug : `/${nodeOrSlug.slug}`;
+    }
+    return '/';
+}
+/**
+ * Build a media image URL with optional size variant or on-the-fly resize.
+ * - `opts.size`   → /api/kywi/media/:id/variant/:size  (pre-generated variant)
+ * - `opts.w`/`h`  → /api/kywi/media/:id/resize?w=…&h=… (on-the-fly resize)
+ * - no opts       → /api/kywi/media/:id/file
+ */
+export function createKywiImageUrl(fileId, opts = {}) {
+    if (opts.size !== undefined) {
+        return `/api/kywi/media/${fileId}/variant/${opts.size}`;
+    }
+    if (opts.w !== undefined || opts.h !== undefined) {
+        const params = new URLSearchParams();
+        if (opts.w !== undefined)
+            params.set('w', String(opts.w));
+        if (opts.h !== undefined)
+            params.set('h', String(opts.h));
+        return `/api/kywi/media/${fileId}/resize?${params}`;
+    }
+    return `/api/kywi/media/${fileId}/file`;
+}
+/**
+ * Build a media file URL (no image transforms).
+ */
+export function createKywiFileUrl(fileId) {
+    return `/api/kywi/media/${fileId}/file`;
+}
+//# sourceMappingURL=url-helpers.js.map

package/dist/scope/url-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-helpers.js","sourceRoot":"","sources":["../../src/scope/url-helpers.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAQjF,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAAqD;IAClF,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAA;IACnE,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAA;IAClF,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAA;IAClF,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,OAAyB,EAAE;IAC5E,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,mBAAmB,MAAM,YAAY,IAAI,CAAC,IAAI,EAAE,CAAA;IACzD,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACzD,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACzD,OAAO,mBAAmB,MAAM,WAAW,MAAM,EAAE,CAAA;IACrD,CAAC;IACD,OAAO,mBAAmB,MAAM,OAAO,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,mBAAmB,MAAM,OAAO,CAAA;AACzC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Server-only exports for @kywi-software/core.
+ *
+ * Use this entry point in Next.js API routes and server components
+ * to avoid importing client-side React components that use hooks.
+ *
+ * import { createDb, createKywiApiHandler, parseKywiConfig } from '@kywi-software/core/server'
+ */
+export { createDb, type KywiDb } from './db/client.js';
+export { explainDbError, resolveDatabaseUrl, resolveAuthSecret, redactDbUrl } from './db/env-guard.js';
+export { createKywiApiHandler, type KywiApiHandler, type KywiApiOptions } from './api/index.js';
+export { parseKywiConfig } from './config/parse.js';
+export { defineKywiConfig, defineContentType, defineSite, defineTheme } from './config/define.js';
+export type { KywiConfig, ContentTypeConfig, KywiContext } from './config/types.js';
+export { createStorageProvider, createLocalStorage, createS3Storage } from './media/index.js';
+export type { StorageProvider, MediaConfig } from './media/types.js';
+export { runScheduler, startScheduler, type SchedulerHandle } from './versioning/scheduler.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACtG,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACjG,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACnF,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC7F,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/server.js

@@ -0,0 +1,16 @@
+/**
+ * Server-only exports for @kywi-software/core.
+ *
+ * Use this entry point in Next.js API routes and server components
+ * to avoid importing client-side React components that use hooks.
+ *
+ * import { createDb, createKywiApiHandler, parseKywiConfig } from '@kywi-software/core/server'
+ */
+export { createDb } from './db/client.js';
+export { explainDbError, resolveDatabaseUrl, resolveAuthSecret, redactDbUrl } from './db/env-guard.js';
+export { createKywiApiHandler } from './api/index.js';
+export { parseKywiConfig } from './config/parse.js';
+export { defineKywiConfig, defineContentType, defineSite, defineTheme } from './config/define.js';
+export { createStorageProvider, createLocalStorage, createS3Storage } from './media/index.js';
+export { runScheduler, startScheduler } from './versioning/scheduler.js';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACtG,OAAO,EAAE,oBAAoB,EAA4C,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEjG,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE7F,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwB,MAAM,2BAA2B,CAAA"}

package/dist/versioning/__tests__/scheduler.test.d.ts

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

package/dist/versioning/__tests__/scheduler.test.d.ts.map

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