@kywi-software/core 0.1.0

package/dist/scope/csrf.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** Renders a hidden <input> carrying the CSRF token. */
+export function KywiCsrfToken({ token, name = '_csrf' }) {
+    return _jsx("input", { type: "hidden", name: name, value: token });
+}
+// ─── Server Validation ───────────────────────────────────────────────────────
+/**
+ * Parse the `kywi_csrf` cookie value from a raw Cookie header.
+ */
+function parseCsrfCookie(cookieHeader) {
+    if (!cookieHeader)
+        return '';
+    const match = cookieHeader.match(/(?:^|;\s*)kywi_csrf=([^;]+)/);
+    return match?.[1] ?? '';
+}
+/**
+ * Extract the submitted CSRF token from either:
+ *  1. The `_csrf` form field (application/x-www-form-urlencoded)
+ *  2. The `x-csrf-token` request header (JSON / XHR requests)
+ */
+async function extractSubmittedToken(request) {
+    // Try the header first (non-destructive)
+    const headerToken = request.headers.get('x-csrf-token');
+    if (headerToken)
+        return headerToken;
+    // Fall back to reading the form body
+    try {
+        const contentType = request.headers.get('content-type') ?? '';
+        if (contentType.includes('application/x-www-form-urlencoded')) {
+            const cloned = request.clone();
+            const text = await cloned.text();
+            const params = new URLSearchParams(text);
+            return params.get('_csrf') ?? '';
+        }
+    }
+    catch {
+        // Body may have already been consumed — return empty
+    }
+    return '';
+}
+/**
+ * Validate that the CSRF token submitted in the request matches the one stored
+ * in the `kywi_csrf` cookie. Returns `true` when valid.
+ */
+export async function validateKywiCsrf(request) {
+    const cookieToken = parseCsrfCookie(request.headers.get('cookie'));
+    if (!cookieToken)
+        return false;
+    const submittedToken = await extractSubmittedToken(request);
+    if (!submittedToken)
+        return false;
+    return cookieToken === submittedToken;
+}
+//# sourceMappingURL=csrf.js.map

package/dist/scope/csrf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csrf.js","sourceRoot":"","sources":["../../src/scope/csrf.tsx"],"names":[],"mappings":";AAWA,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,EAAsB;IACzE,OAAO,gBAAO,IAAI,EAAC,QAAQ,EAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAI,CAAA;AAC1D,CAAC;AAED,gFAAgF;AAEhF;;GAEG;AACH,SAAS,eAAe,CAAC,YAA2B;IAClD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAA;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAC/D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACzB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IACnD,yCAAyC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IACvD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAA;IAEnC,qCAAqC;IACrC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QAC7D,IAAI,WAAW,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YAChC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAA;YACxC,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QAClC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IACrD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAClE,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAA;IAE9B,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC3D,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAA;IAEjC,OAAO,WAAW,KAAK,cAAc,CAAA;AACvC,CAAC"}

package/dist/scope/edit-mode-hooks.d.ts

@@ -0,0 +1,25 @@
+export interface KywiEditModeState {
+    /** Whether the user is currently in edit mode. */
+    isEditMode: boolean;
+    /** Whether the current user has permission to edit content. */
+    canEdit: boolean;
+    /** Whether the current user has permission to publish content. */
+    canPublish: boolean;
+    /** Toggle edit mode on/off. */
+    toggleEdit: () => void;
+    /** Enter edit mode. */
+    startEdit: () => void;
+    /** Leave edit mode. */
+    endEdit: () => void;
+}
+export declare function useKywiEditMode(opts?: {
+    canEdit?: boolean;
+    canPublish?: boolean;
+}): KywiEditModeState;
+export declare function useKywiInlineEdit(field: string, initialValue: string, onSave: (field: string, value: string) => Promise<void>): {
+    value: string;
+    setValue: import("react").Dispatch<import("react").SetStateAction<string>>;
+    save: () => Promise<void>;
+    isSaving: boolean;
+};
+//# sourceMappingURL=edit-mode-hooks.d.ts.map

package/dist/scope/edit-mode-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-mode-hooks.d.ts","sourceRoot":"","sources":["../../src/scope/edit-mode-hooks.tsx"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAA;IACnB,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAA;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,uBAAuB;IACvB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,uBAAuB;IACvB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,eAAe,CAC7B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,iBAAiB,CAOnB;AAID,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;;;;;EAUxD"}

package/dist/scope/edit-mode-hooks.js

@@ -0,0 +1,22 @@
+'use client';
+import { useState, useCallback } from 'react';
+export function useKywiEditMode(opts = {}) {
+    const { canEdit = false, canPublish = false } = opts;
+    const [isEditMode, setIsEditMode] = useState(false);
+    const toggleEdit = useCallback(() => setIsEditMode(prev => !prev), []);
+    const startEdit = useCallback(() => setIsEditMode(true), []);
+    const endEdit = useCallback(() => setIsEditMode(false), []);
+    return { isEditMode, canEdit, canPublish, toggleEdit, startEdit, endEdit };
+}
+// ─── useKywiInlineEdit ────────────────────────────────────────────────────────
+export function useKywiInlineEdit(field, initialValue, onSave) {
+    const [value, setValue] = useState(initialValue);
+    const [isSaving, setIsSaving] = useState(false);
+    const save = useCallback(async () => {
+        setIsSaving(true);
+        await onSave(field, value);
+        setIsSaving(false);
+    }, [field, value, onSave]);
+    return { value, setValue, save, isSaving };
+}
+//# sourceMappingURL=edit-mode-hooks.js.map

package/dist/scope/edit-mode-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-mode-hooks.js","sourceRoot":"","sources":["../../src/scope/edit-mode-hooks.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAmB7C,MAAM,UAAU,eAAe,CAC7B,OAAoD,EAAE;IAEtD,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;IACpD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IACtE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;IAC3D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAC5E,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,YAAoB,EACpB,MAAuD;IAEvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;IAChD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,MAAM,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QAC1B,WAAW,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC5C,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { FeedQuery, FeedResult } from '../feeds/types.js';
+interface UseFeedReturn {
+    data: FeedResult | null;
+    isLoading: boolean;
+    error: Error | null;
+}
+/**
+ * Fetch feed data from the Kywi scope.
+ * Accepts a saved feed slug (string) or an inline FeedQuery.
+ */
+export declare function useKywiFeed(slugOrQuery: string | FeedQuery, options?: {
+    refreshInterval?: number;
+}): UseFeedReturn;
+export {};
+//# sourceMappingURL=feed-hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feed-hook.d.ts","sourceRoot":"","sources":["../../src/scope/feed-hook.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9D,UAAU,aAAa;IACrB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,aAAa,CAyCf"}

package/dist/scope/feed-hook.js

@@ -0,0 +1,50 @@
+'use client';
+import { useState, useEffect } from 'react';
+import { useKywiScope } from './provider.js';
+/**
+ * Fetch feed data from the Kywi scope.
+ * Accepts a saved feed slug (string) or an inline FeedQuery.
+ */
+export function useKywiFeed(slugOrQuery, options) {
+    const { scope } = useKywiScope();
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        let cancelled = false;
+        async function fetchFeed() {
+            setIsLoading(true);
+            setError(null);
+            try {
+                const result = typeof slugOrQuery === 'string'
+                    ? await scope.feeds.get(slugOrQuery)
+                    : await scope.feeds.query(slugOrQuery);
+                if (!cancelled)
+                    setData(result);
+            }
+            catch (err) {
+                if (!cancelled)
+                    setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        }
+        fetchFeed();
+        let intervalId;
+        if (options?.refreshInterval && options.refreshInterval > 0) {
+            intervalId = setInterval(fetchFeed, options.refreshInterval);
+        }
+        return () => {
+            cancelled = true;
+            if (intervalId)
+                clearInterval(intervalId);
+        };
+    }, [
+        typeof slugOrQuery === 'string' ? slugOrQuery : JSON.stringify(slugOrQuery),
+        options?.refreshInterval,
+    ]);
+    return { data, isLoading, error };
+}
+//# sourceMappingURL=feed-hook.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feed-hook.js","sourceRoot":"","sources":["../../src/scope/feed-hook.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAS5C;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,WAA+B,EAC/B,OAAsC;IAEtC,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAA;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAA;IACzD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,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,MAAM,GAAG,OAAO,WAAW,KAAK,QAAQ;oBAC5C,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC;oBACpC,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;gBACxC,IAAI,CAAC,SAAS;oBAAE,OAAO,CAAC,MAAM,CAAC,CAAA;YACjC,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,IAAI,UAAsD,CAAA;QAC1D,IAAI,OAAO,EAAE,eAAe,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC5D,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;QAC9D,CAAC;QAED,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;YAChB,IAAI,UAAU;gBAAE,aAAa,CAAC,UAAU,CAAC,CAAA;QAC3C,CAAC,CAAA;IACH,CAAC,EAAE;QACD,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QAC3E,OAAO,EAAE,eAAe;KACzB,CAAC,CAAA;IAEF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;AACnC,CAAC"}

package/dist/scope/head-foot.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+/** Accumulate an HTML snippet to be rendered inside <head>. Duplicates are ignored. */
+export declare function addToKywiHead(html: string): void;
+/** Accumulate an HTML snippet to be rendered before </body>. Duplicates are ignored. */
+export declare function addToKywiFoot(html: string): void;
+/** Reset both queues (used between requests / in tests). */
+export declare function resetKywiQueues(): void;
+/**
+ * Renders all accumulated head HTML snippets.
+ * These snippets originate from CMS plugins/themes and are treated as trusted
+ * content (same trust model as KywiBody in rendering.tsx).
+ */
+export declare function KywiHead(): React.ReactElement | null;
+/**
+ * Renders all accumulated foot HTML snippets.
+ * These snippets originate from CMS plugins/themes and are treated as trusted
+ * content (same trust model as KywiBody in rendering.tsx).
+ */
+export declare function KywiFoot(): React.ReactElement | null;
+//# sourceMappingURL=head-foot.d.ts.map

package/dist/scope/head-foot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-foot.d.ts","sourceRoot":"","sources":["../../src/scope/head-foot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CASpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CASpD"}

package/dist/scope/head-foot.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import React from 'react';
+// ─── Queues ──────────────────────────────────────────────────────────────────
+let headQueue = [];
+let footQueue = [];
+// ─── Mutators ────────────────────────────────────────────────────────────────
+/** Accumulate an HTML snippet to be rendered inside <head>. Duplicates are ignored. */
+export function addToKywiHead(html) {
+    if (!headQueue.includes(html)) {
+        headQueue.push(html);
+    }
+}
+/** Accumulate an HTML snippet to be rendered before </body>. Duplicates are ignored. */
+export function addToKywiFoot(html) {
+    if (!footQueue.includes(html)) {
+        footQueue.push(html);
+    }
+}
+/** Reset both queues (used between requests / in tests). */
+export function resetKywiQueues() {
+    headQueue = [];
+    footQueue = [];
+}
+// ─── Components ──────────────────────────────────────────────────────────────
+/**
+ * Renders all accumulated head HTML snippets.
+ * These snippets originate from CMS plugins/themes and are treated as trusted
+ * content (same trust model as KywiBody in rendering.tsx).
+ */
+export function KywiHead() {
+    if (headQueue.length === 0)
+        return null;
+    // Snippets are CMS/plugin-authored trusted HTML — same trust model as KywiBody
+    // eslint-disable-next-line react/no-danger
+    return _jsx(_Fragment, { children: headQueue.map((snippet, i) => (_jsx(React.Fragment, { children: _jsx("span", { style: { display: 'none' }, dangerouslySetInnerHTML: { __html: snippet } }) }, i))) });
+}
+/**
+ * Renders all accumulated foot HTML snippets.
+ * These snippets originate from CMS plugins/themes and are treated as trusted
+ * content (same trust model as KywiBody in rendering.tsx).
+ */
+export function KywiFoot() {
+    if (footQueue.length === 0)
+        return null;
+    // Snippets are CMS/plugin-authored trusted HTML — same trust model as KywiBody
+    // eslint-disable-next-line react/no-danger
+    return _jsx(_Fragment, { children: footQueue.map((snippet, i) => (_jsx(React.Fragment, { children: _jsx("span", { style: { display: 'none' }, dangerouslySetInnerHTML: { __html: snippet } }) }, i))) });
+}
+//# sourceMappingURL=head-foot.js.map

package/dist/scope/head-foot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-foot.js","sourceRoot":"","sources":["../../src/scope/head-foot.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,gFAAgF;AAEhF,IAAI,SAAS,GAAa,EAAE,CAAA;AAC5B,IAAI,SAAS,GAAa,EAAE,CAAA;AAE5B,gFAAgF;AAEhF,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,SAAS,GAAG,EAAE,CAAA;IACd,SAAS,GAAG,EAAE,CAAA;AAChB,CAAC;AAED,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,+EAA+E;IAC/E,2CAA2C;IAC3C,OAAO,4BAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CACtC,KAAC,KAAK,CAAC,QAAQ,cACb,eAAM,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAI,IAD/D,CAAC,CAEL,CAClB,CAAC,GAAI,CAAA;AACR,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,+EAA+E;IAC/E,2CAA2C;IAC3C,OAAO,4BAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CACtC,KAAC,KAAK,CAAC,QAAQ,cACb,eAAM,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAI,IAD/D,CAAC,CAEL,CAClB,CAAC,GAAI,CAAA;AACR,CAAC"}

package/dist/scope/hooks.d.ts

@@ -0,0 +1,39 @@
+export declare function useKywiContent(): Record<string, unknown> | null;
+export declare function useKywiSite(): Record<string, unknown> | null;
+export interface KywiUserShape {
+    id: string | null;
+    email: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    role: string;
+    isActive: boolean;
+    isAuthenticated: boolean;
+    isSuperAdmin: boolean;
+    isSiteAdmin: boolean;
+    [key: string]: unknown;
+}
+export declare function useKywiUser(): KywiUserShape;
+export interface KywiEventShape {
+    currentPath: string;
+    contentId: string | null;
+}
+export declare function useKywiEvent(): KywiEventShape;
+export interface KywiCurrentUrlShape {
+    /** The full href (path + query string) as provided to the provider */
+    href: string;
+    /** The pathname portion (before any '?') */
+    path: string;
+    /** Path segments split by '/' with empty segments filtered out */
+    segments: string[];
+    /** Parsed URLSearchParams from the query string */
+    searchParams: URLSearchParams;
+}
+export declare function useKywiCurrentUrl(): KywiCurrentUrlShape;
+export interface KywiMetaShape {
+    metaTitle: string | null;
+    metaDescription: string | null;
+    metaKeywords: string | null;
+    ogImage: string | null;
+}
+export declare function useKywiMeta(): KywiMetaShape;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/scope/hooks.tsx"],"names":[],"mappings":"AAMA,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG/D;AAID,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG5D;AAID,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,WAAW,IAAI,aAAa,CA+B3C;AAID,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,wBAAgB,YAAY,IAAI,cAAc,CAM7C;AAID,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,mDAAmD;IACnD,YAAY,EAAE,eAAe,CAAA;CAC9B;AAED,wBAAgB,iBAAiB,IAAI,mBAAmB,CASvD;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,wBAAgB,WAAW,IAAI,aAAa,CAkB3C"}

package/dist/scope/hooks.js

@@ -0,0 +1,75 @@
+'use client';
+import { useKywiScope } from './provider.js';
+// ─── useKywiContent ───────────────────────────────────────────────────────────
+export function useKywiContent() {
+    const { currentContent } = useKywiScope();
+    return currentContent;
+}
+// ─── useKywiSite ──────────────────────────────────────────────────────────────
+export function useKywiSite() {
+    const { currentSite } = useKywiScope();
+    return currentSite;
+}
+export function useKywiUser() {
+    const { currentUser } = useKywiScope();
+    if (!currentUser) {
+        return {
+            id: null,
+            email: null,
+            firstName: null,
+            lastName: null,
+            role: 'guest',
+            isActive: false,
+            isAuthenticated: false,
+            isSuperAdmin: false,
+            isSiteAdmin: false,
+        };
+    }
+    const role = String(currentUser.role ?? 'reader');
+    return {
+        ...currentUser,
+        id: currentUser.id != null ? String(currentUser.id) : null,
+        email: currentUser.email != null ? String(currentUser.email) : null,
+        firstName: currentUser.firstName != null ? String(currentUser.firstName) : null,
+        lastName: currentUser.lastName != null ? String(currentUser.lastName) : null,
+        role,
+        isActive: currentUser.isActive === true,
+        isAuthenticated: true,
+        isSuperAdmin: role === 'superadmin',
+        isSiteAdmin: role === 'admin' || role === 'superadmin',
+    };
+}
+export function useKywiEvent() {
+    const { currentPath, currentContent } = useKywiScope();
+    return {
+        currentPath,
+        contentId: currentContent ? String(currentContent.id ?? '') || null : null,
+    };
+}
+export function useKywiCurrentUrl() {
+    const { currentPath } = useKywiScope();
+    const qIndex = currentPath.indexOf('?');
+    const path = qIndex >= 0 ? currentPath.slice(0, qIndex) : currentPath;
+    const queryString = qIndex >= 0 ? currentPath.slice(qIndex + 1) : '';
+    const segments = path.split('/').filter(Boolean);
+    const searchParams = new URLSearchParams(queryString);
+    return { href: currentPath, path, segments, searchParams };
+}
+export function useKywiMeta() {
+    const { currentContent } = useKywiScope();
+    if (!currentContent) {
+        return {
+            metaTitle: null,
+            metaDescription: null,
+            metaKeywords: null,
+            ogImage: null,
+        };
+    }
+    return {
+        metaTitle: currentContent.metaTitle != null ? String(currentContent.metaTitle) : null,
+        metaDescription: currentContent.metaDescription != null ? String(currentContent.metaDescription) : null,
+        metaKeywords: currentContent.metaKeywords != null ? String(currentContent.metaKeywords) : null,
+        ogImage: currentContent.ogImage != null ? String(currentContent.ogImage) : null,
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/scope/hooks.js.map

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

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

@@ -0,0 +1,2 @@
+export declare function useKywiRbKey(key: string, vars?: Record<string, string>): string;
+//# sourceMappingURL=i18n-hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-hook.d.ts","sourceRoot":"","sources":["../../src/scope/i18n-hook.tsx"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI/E"}

package/dist/scope/i18n-hook.js

@@ -0,0 +1,9 @@
+'use client';
+import { useKywiScope } from './provider.js';
+export function useKywiRbKey(key, vars) {
+    const { scope } = useKywiScope();
+    if (!scope.i18n)
+        return key;
+    return scope.i18n.get(key, undefined, vars);
+}
+//# sourceMappingURL=i18n-hook.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-hook.js","sourceRoot":"","sources":["../../src/scope/i18n-hook.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,IAA6B;IACrE,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAA;IAChC,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,GAAG,CAAA;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;AAC7C,CAAC"}

package/dist/scope/index.d.ts

@@ -0,0 +1,22 @@
+export * from './types.js';
+export * from './create-scope.js';
+export * from './provider.js';
+export * from './hooks.js';
+export * from './nav-hooks.js';
+export * from './breadcrumbs.js';
+export { KywiJsonLd, type KywiJsonLdProps } from './jsonld.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 { KywiWizardForm } from './kywi-wizard-form.js';
+export * from './content-accessors.js';
+export * from './media-scope.js';
+export * from './search-hook.js';
+export * from './edit-mode-hooks.js';
+export { addToKywiHead, addToKywiFoot, KywiHead, KywiFoot, resetKywiQueues } from './head-foot.js';
+export { KywiCsrfToken, validateKywiCsrf } from './csrf.js';
+export { KywiEditableAttribute, KywiEditableRegion, KywiEditToolbar, } from './inline-editing.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scope/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC9D,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,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}

package/dist/scope/index.js

@@ -0,0 +1,22 @@
+export * from './types.js';
+export * from './create-scope.js';
+export * from './provider.js';
+export * from './hooks.js';
+export * from './nav-hooks.js';
+export * from './breadcrumbs.js';
+export { KywiJsonLd } from './jsonld.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 { KywiWizardForm } from './kywi-wizard-form.js';
+export * from './content-accessors.js';
+export * from './media-scope.js';
+export * from './search-hook.js';
+export * from './edit-mode-hooks.js';
+export { addToKywiHead, addToKywiFoot, KywiHead, KywiFoot, resetKywiQueues } from './head-foot.js';
+export { KywiCsrfToken, validateKywiCsrf } from './csrf.js';
+export { KywiEditableAttribute, KywiEditableRegion, KywiEditToolbar, } from './inline-editing.js';
+//# sourceMappingURL=index.js.map

package/dist/scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scope/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,UAAU,EAAwB,MAAM,aAAa,CAAA;AAC9D,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,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}

package/dist/scope/inline-editing.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+export type KywiEditableType = 'text' | 'richtext' | 'image';
+export interface KywiEditableAttributeProps {
+    /** The content field name this element maps to. */
+    field: string;
+    /** The editing affordance type. */
+    type: KywiEditableType;
+    /** The content record ID this field belongs to. */
+    contentId: string;
+    /** Additional CSS class names. */
+    className?: string;
+    children: React.ReactNode;
+}
+/**
+ * Wraps a content field with `data-kywi-editable` attributes so the
+ * front-end inline editor can discover and activate it.
+ *
+ * Protocol:
+ *  - `data-kywi-editable="fieldName"`
+ *  - `data-kywi-type="text|richtext|image"`
+ *  - `data-kywi-content-id="..."`
+ */
+export declare function KywiEditableAttribute({ field, type, contentId, className, children, }: KywiEditableAttributeProps): React.ReactElement;
+export interface KywiEditableRegionProps {
+    /** Layout region identifier (e.g. "main", "sidebar", "footer"). */
+    region: string;
+    /** Additional CSS class names. */
+    className?: string;
+    children: React.ReactNode;
+}
+/**
+ * Wraps a layout region for inline editing. Regions group editable
+ * attributes and provide a drag-drop target for module reordering.
+ */
+export declare function KywiEditableRegion({ region, className, children, }: KywiEditableRegionProps): React.ReactElement;
+export interface KywiEditToolbarProps {
+    /** Whether the user is currently in edit mode. */
+    isEditMode: boolean;
+    /** Whether the current user has permission to edit. */
+    canEdit: boolean;
+    /** Whether the current user has permission to publish. */
+    canPublish: boolean;
+    /** Callback when Edit / Done button is clicked. */
+    onToggleEdit?: () => void;
+    /** Callback when Publish button is clicked. */
+    onPublish?: () => void;
+    /** Additional CSS class names. */
+    className?: string;
+    /** Optional page title shown in the browse-mode bar. */
+    pageTitle?: string;
+    /** Optional publish status shown as a badge in the browse-mode bar. */
+    pageStatus?: string;
+    /** Optional href for a quick "Admin" link in the browse-mode bar. */
+    adminHref?: string;
+}
+export declare function KywiEditToolbar({ isEditMode, canEdit, canPublish, onToggleEdit, onPublish, className, pageTitle, pageStatus, adminHref, }: KywiEditToolbarProps): React.ReactElement | null;
+//# sourceMappingURL=inline-editing.d.ts.map

package/dist/scope/inline-editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-editing.d.ts","sourceRoot":"","sources":["../../src/scope/inline-editing.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAIxC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;AAE5D,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,IAAI,EAAE,gBAAgB,CAAA;IACtB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,GACT,EAAE,0BAA0B,GAAG,KAAK,CAAC,YAAY,CAYjD;AAID,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,SAAS,EACT,QAAQ,GACT,EAAE,uBAAuB,GAAG,KAAK,CAAC,YAAY,CAO9C;AAID,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAA;IACnB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAYD,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAsDlD"}

package/dist/scope/inline-editing.js

@@ -0,0 +1,54 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from 'react';
+/**
+ * Wraps a content field with `data-kywi-editable` attributes so the
+ * front-end inline editor can discover and activate it.
+ *
+ * Protocol:
+ *  - `data-kywi-editable="fieldName"`
+ *  - `data-kywi-type="text|richtext|image"`
+ *  - `data-kywi-content-id="..."`
+ */
+export function KywiEditableAttribute({ field, type, contentId, className, children, }) {
+    const cls = ['kywi-editable', className].filter(Boolean).join(' ');
+    return (_jsx("div", { className: cls, "data-kywi-editable": field, "data-kywi-type": type, "data-kywi-content-id": contentId, children: children }));
+}
+/**
+ * Wraps a layout region for inline editing. Regions group editable
+ * attributes and provide a drag-drop target for module reordering.
+ */
+export function KywiEditableRegion({ region, className, children, }) {
+    const cls = ['kywi-editable-region', className].filter(Boolean).join(' ');
+    return (_jsx("div", { className: cls, "data-kywi-region": region, children: children }));
+}
+/**
+ * Browse-mode toolbar with edit/publish controls. Hidden when the current
+ * user does not have edit permission — this is the security boundary that keeps
+ * the affordance off anonymous/read-only visitors' pages.
+ *
+ * In browse mode it can additionally surface the page's publish status, title,
+ * and an Admin link; in edit mode it collapses to Done/Publish controls.
+ */
+const BROWSING_OFFSET_CLASS = 'kywi-frontend-edit--browsing';
+export function KywiEditToolbar({ isEditMode, canEdit, canPublish, onToggleEdit, onPublish, className, pageTitle, pageStatus, adminHref, }) {
+    // The bar is `position: fixed; top: 0`, so while it's visible in browse mode
+    // it would otherwise sit on top of the page's own header. Push the whole
+    // document down by the bar's height for as long as it's mounted, and undo
+    // that on unmount/edit-mode-entry so the offset never leaks past the bar's
+    // actual lifetime.
+    const isBrowsingBarVisible = canEdit && !isEditMode;
+    useEffect(() => {
+        if (!isBrowsingBarVisible)
+            return;
+        document.documentElement.classList.add(BROWSING_OFFSET_CLASS);
+        return () => {
+            document.documentElement.classList.remove(BROWSING_OFFSET_CLASS);
+        };
+    }, [isBrowsingBarVisible]);
+    if (!canEdit)
+        return null;
+    const cls = ['kywi-edit-toolbar', className].filter(Boolean).join(' ');
+    return (_jsx("div", { className: cls, role: "toolbar", "aria-label": "Edit controls", children: isEditMode ? (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "kywi-edit-toolbar-done", onClick: onToggleEdit, children: "Done" }), canPublish && (_jsx("button", { type: "button", className: "kywi-edit-toolbar-publish", onClick: onPublish, children: "Publish" }))] })) : (_jsxs(_Fragment, { children: [pageStatus && (_jsxs("span", { className: "kywi-edit-toolbar-status", children: [_jsx("span", { className: "kywi-edit-toolbar-status-dot" }), pageStatus.charAt(0).toUpperCase() + pageStatus.slice(1)] })), pageTitle && _jsx("span", { className: "kywi-edit-toolbar-title", children: pageTitle }), _jsx("span", { className: "kywi-edit-toolbar-spacer" }), adminHref && (_jsx("a", { className: "kywi-edit-toolbar-link", href: adminHref, children: "Admin" })), _jsx("button", { type: "button", className: "kywi-edit-toolbar-edit", onClick: onToggleEdit, children: "Edit Page" })] })) }));
+}
+//# sourceMappingURL=inline-editing.js.map

package/dist/scope/inline-editing.js.map

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

package/dist/scope/jsonld.d.ts

@@ -0,0 +1,21 @@
+import type { KywiConfig } from '../config/types.js';
+import type { AxContentNode } from '../ax/types.js';
+export interface KywiJsonLdProps {
+    /** The resolved content node the page is rendering (merged base + custom fields). */
+    node: AxContentNode | Record<string, unknown>;
+    /** The site config (for the ax.jsonLd mapping). */
+    config: KywiConfig;
+    /** Absolute origin for the emitted `url`. */
+    baseUrl: string;
+    /** Optional explicit site id; defaults to the node's own `siteId`. */
+    siteId?: string;
+}
+/**
+ * Server component that emits per-page JSON-LD as an `application/ld+json`
+ * script tag — the same shape as `KywiBreadcrumbs` `variant='schema'`. It maps
+ * the *same* node the page renders through `generateJsonLd`, so the human page
+ * and the structured data can never disagree. Returns null when JSON-LD is
+ * disabled or the mapping yields nothing.
+ */
+export declare function KywiJsonLd({ node, config, baseUrl, siteId }: KywiJsonLdProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=jsonld.d.ts.map