@kywi-software/core 0.1.0

package/dist/scope/nav-hooks.js

@@ -0,0 +1,322 @@
+'use client';
+import { useMemo } from 'react';
+import { useKywiScope } from './provider.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function findNodeById(nodes, id) {
+    for (const node of nodes) {
+        if (node.id === id)
+            return node;
+        const found = findNodeById(node.children, id);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function pruneToDepth(nodes, viewDepth) {
+    return nodes.map(node => ({
+        ...node,
+        children: node.depth < viewDepth - 1 ? pruneToDepth(node.children, viewDepth) : [],
+    }));
+}
+function pruneToRelativeDepth(nodes, maxLevels, currentLevel = 1) {
+    if (currentLevel >= maxLevels) {
+        return nodes.map(node => ({ ...node, children: [] }));
+    }
+    return nodes.map(node => ({
+        ...node,
+        children: pruneToRelativeDepth(node.children, maxLevels, currentLevel + 1),
+    }));
+}
+function getSiblings(nodes, targetId) {
+    for (const node of nodes) {
+        if (node.children.some(c => c.id === targetId)) {
+            return node.children;
+        }
+        const found = getSiblings(node.children, targetId);
+        if (found)
+            return found;
+    }
+    return null;
+}
+export function useKywiPrimaryNav(opts = {}) {
+    const { navTree } = useKywiScope();
+    const { viewDepth, showHome = true } = opts;
+    return useMemo(() => {
+        // Top-level: children of root if there is a single root, otherwise all roots
+        let topLevel;
+        if (navTree.length === 1 && navTree[0]) {
+            topLevel = navTree[0].children;
+        }
+        else {
+            topLevel = navTree;
+        }
+        let result = topLevel;
+        // Optionally remove home node (first node with slug 'home' or href '/')
+        if (!showHome) {
+            result = result.filter(n => n.slug !== 'home' && n.href !== '/');
+        }
+        // Prune to viewDepth if specified
+        if (viewDepth !== undefined) {
+            result = pruneToDepth(result, viewDepth);
+        }
+        return result;
+    }, [navTree, viewDepth, showHome]);
+}
+export function useKywiSubNav(opts = {}) {
+    const { navTree, currentContent } = useKywiScope();
+    const { parentId, viewDepth } = opts;
+    return useMemo(() => {
+        // Resolve the target node ID
+        const targetId = parentId ?? (currentContent ? String(currentContent.id ?? '') : null);
+        if (!targetId)
+            return [];
+        const node = findNodeById(navTree, targetId);
+        if (!node)
+            return [];
+        let children = node.children;
+        if (viewDepth !== undefined) {
+            children = pruneToDepth(children, viewDepth);
+        }
+        return children;
+    }, [navTree, parentId, currentContent, viewDepth]);
+}
+export function useKywiSequentialNav(opts = {}) {
+    const { navTree, currentContent } = useKywiScope();
+    const { nodeId } = opts;
+    return useMemo(() => {
+        const targetId = nodeId ?? (currentContent ? String(currentContent.id ?? '') : null);
+        if (!targetId)
+            return { previous: null, next: null };
+        // Find siblings containing the target node
+        const siblings = getSiblings(navTree, targetId);
+        if (!siblings || siblings.length === 0) {
+            // Check if target is a top-level node — use navTree as siblings
+            const topLevel = navTree.length === 1 && navTree[0] ? navTree[0].children : navTree;
+            const idx = topLevel.findIndex(n => n.id === targetId);
+            if (idx === -1)
+                return { previous: null, next: null };
+            return {
+                previous: idx > 0 ? (topLevel[idx - 1] ?? null) : null,
+                next: idx < topLevel.length - 1 ? (topLevel[idx + 1] ?? null) : null,
+            };
+        }
+        const idx = siblings.findIndex(n => n.id === targetId);
+        if (idx === -1)
+            return { previous: null, next: null };
+        return {
+            previous: idx > 0 ? (siblings[idx - 1] ?? null) : null,
+            next: idx < siblings.length - 1 ? (siblings[idx + 1] ?? null) : null,
+        };
+    }, [navTree, nodeId, currentContent]);
+}
+// ─── useKywiBreadcrumbs ───────────────────────────────────────────────────────
+export function useKywiBreadcrumbs() {
+    const { navTree, currentPath } = useKywiScope();
+    return useMemo(() => {
+        function findPath(nodes, target) {
+            for (const node of nodes) {
+                if (node.href === target)
+                    return [node];
+                if (node.children.length > 0) {
+                    const childPath = findPath(node.children, target);
+                    if (childPath.length > 0)
+                        return [node, ...childPath];
+                }
+            }
+            return [];
+        }
+        return currentPath ? findPath(navTree, currentPath) : [];
+    }, [navTree, currentPath]);
+}
+// ─── useKywiFooterNav ─────────────────────────────────────────────────────────
+export function useKywiFooterNav() {
+    return useKywiPrimaryNav({ viewDepth: 1 });
+}
+// ─── useKywiPeerNav ───────────────────────────────────────────────────────────
+export function useKywiPeerNav() {
+    const { navTree, currentPath } = useKywiScope();
+    return useMemo(() => {
+        if (!currentPath)
+            return [];
+        function findSiblings(nodes, target, parent) {
+            for (const node of nodes) {
+                if (node.href === target)
+                    return parent ?? nodes;
+                if (node.children.length > 0) {
+                    const result = findSiblings(node.children, target, node.children);
+                    if (result.length > 0)
+                        return result;
+                }
+            }
+            return [];
+        }
+        return findSiblings(navTree, currentPath, null);
+    }, [navTree, currentPath]);
+}
+// ─── useKywiContentByParent ───────────────────────────────────────────────────
+export function useKywiContentByParent(parentId) {
+    return useKywiSubNav(parentId !== undefined ? { parentId } : {});
+}
+/**
+ * Multi-level tree navigation to N depth.
+ * Returns the full tree (or subtree from `rootId`) pruned to `maxDepth` levels.
+ */
+export function useKywiNestedNav(opts = {}) {
+    const { navTree } = useKywiScope();
+    const { rootId, maxDepth } = opts;
+    return useMemo(() => {
+        let nodes;
+        if (rootId) {
+            const root = findNodeById(navTree, rootId);
+            if (!root)
+                return [];
+            nodes = root.children;
+        }
+        else {
+            nodes = navTree.length === 1 && navTree[0] ? navTree[0].children : navTree;
+        }
+        if (maxDepth !== undefined) {
+            nodes = pruneToRelativeDepth(nodes, maxDepth);
+        }
+        return nodes;
+    }, [navTree, rootId, maxDepth]);
+}
+// ─── useKywiFolderNav ────────────────────────────────────────────────────────
+/**
+ * Returns children of the nearest folder ancestor for the current path.
+ * If the current node itself is a folder, returns its children.
+ */
+export function useKywiFolderNav() {
+    const { navTree, currentPath } = useKywiScope();
+    return useMemo(() => {
+        if (!currentPath)
+            return [];
+        // Build path from root to current node
+        function findPathToNode(nodes, target) {
+            for (const node of nodes) {
+                if (node.href === target)
+                    return [node];
+                if (node.children.length > 0) {
+                    const childPath = findPathToNode(node.children, target);
+                    if (childPath.length > 0)
+                        return [node, ...childPath];
+                }
+            }
+            return [];
+        }
+        const pathNodes = findPathToNode(navTree, currentPath);
+        if (pathNodes.length === 0)
+            return [];
+        // Check if current node is a folder — return its children
+        const currentNode = pathNodes[pathNodes.length - 1];
+        const nodeRecord = currentNode;
+        if (nodeRecord.baseType === 'folder' && currentNode.children.length > 0) {
+            return currentNode.children;
+        }
+        // Walk backwards to find nearest folder ancestor
+        for (let i = pathNodes.length - 2; i >= 0; i--) {
+            const ancestor = pathNodes[i];
+            const ancestorRecord = ancestor;
+            if (ancestorRecord.baseType === 'folder') {
+                return ancestor.children;
+            }
+        }
+        // No folder ancestor found — return empty
+        return [];
+    }, [navTree, currentPath]);
+}
+// ─── useKywiStandardNav ──────────────────────────────────────────────────────
+/**
+ * Standard navigation: top-level items with children of the active section expanded,
+ * and non-active sections pruned to depth 0 (no children).
+ */
+export function useKywiStandardNav() {
+    const { navTree, currentPath } = useKywiScope();
+    return useMemo(() => {
+        const topLevel = navTree.length === 1 && navTree[0] ? navTree[0].children : navTree;
+        function isAncestorOrActive(node, target) {
+            if (node.href === target)
+                return true;
+            return node.children.some(child => isAncestorOrActive(child, target));
+        }
+        return topLevel.map(node => {
+            const active = currentPath ? isAncestorOrActive(node, currentPath) : false;
+            return {
+                ...node,
+                children: active ? node.children : [],
+            };
+        });
+    }, [navTree, currentPath]);
+}
+/**
+ * Returns children of a specific node by ID ("portal" into any part of the tree).
+ */
+export function useKywiPortalNav(opts) {
+    const { navTree } = useKywiScope();
+    const { nodeId, viewDepth } = opts;
+    return useMemo(() => {
+        const node = findNodeById(navTree, nodeId);
+        if (!node)
+            return [];
+        let children = node.children;
+        if (viewDepth !== undefined) {
+            children = pruneToRelativeDepth(children, viewDepth);
+        }
+        return children;
+    }, [navTree, nodeId, viewDepth]);
+}
+// ─── useKywiSessionNav ──────────────────────────────────────────────────────
+/**
+ * Permission-filtered navigation.
+ * Filters out nodes that have a `requiredRole` property when the current user
+ * does not have that role. Admin/superadmin users see all nodes.
+ */
+export function useKywiSessionNav() {
+    const { navTree, currentUser } = useKywiScope();
+    return useMemo(() => {
+        const userRole = currentUser ? String(currentUser.role ?? 'guest') : 'guest';
+        const isAdmin = userRole === 'admin' || userRole === 'superadmin';
+        function filterByPermission(nodes) {
+            return nodes
+                .filter(node => {
+                const nodeRecord = node;
+                const requiredRole = nodeRecord.requiredRole;
+                if (!requiredRole)
+                    return true;
+                if (isAdmin)
+                    return true;
+                return userRole === requiredRole;
+            })
+                .map(node => ({
+                ...node,
+                children: filterByPermission(node.children),
+            }));
+        }
+        const topLevel = navTree.length === 1 && navTree[0] ? navTree[0].children : navTree;
+        return filterByPermission(topLevel);
+    }, [navTree, currentUser]);
+}
+/**
+ * Returns children of a gallery node with image data extracted.
+ */
+export function useKywiGalleryNav(opts) {
+    const { navTree } = useKywiScope();
+    const { parentId } = opts;
+    return useMemo(() => {
+        const node = findNodeById(navTree, parentId);
+        if (!node)
+            return [];
+        return node.children.map(child => {
+            const childRecord = child;
+            return {
+                id: child.id,
+                title: child.title,
+                href: child.href,
+                slug: child.slug,
+                imageUrl: typeof childRecord.imageUrl === 'string' ? childRecord.imageUrl : '',
+                imageAlt: typeof childRecord.imageAlt === 'string' ? childRecord.imageAlt : child.title,
+            };
+        });
+    }, [navTree, parentId]);
+}
+//# sourceMappingURL=nav-hooks.js.map

package/dist/scope/nav-hooks.js.map

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

package/dist/scope/provider.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { KywiScope } from './types.js';
+import type { KywiNavNode } from '../nav/types.js';
+export interface KywiContextValue {
+    scope: KywiScope;
+    currentContent: Record<string, unknown> | null;
+    currentSite: Record<string, unknown> | null;
+    currentUser: Record<string, unknown> | null;
+    currentPath: string;
+    navTree: KywiNavNode[];
+}
+export interface KywiProviderProps {
+    scope: KywiScope;
+    currentContent?: Record<string, unknown> | null;
+    currentSite?: Record<string, unknown> | null;
+    currentUser?: Record<string, unknown> | null;
+    currentPath?: string;
+    navTree?: KywiNavNode[];
+    children: React.ReactNode;
+}
+export declare function KywiProvider({ scope, currentContent, currentSite, currentUser, currentPath, navTree, children, }: KywiProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useKywiScope(): KywiContextValue;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/scope/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoC,MAAM,OAAO,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAIlD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAA;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3C,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAQD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,cAAqB,EACrB,WAAkB,EAClB,WAAkB,EAClB,WAAiB,EACjB,OAAY,EACZ,QAAQ,GACT,EAAE,iBAAiB,2CAWnB;AAID,wBAAgB,YAAY,IAAI,gBAAgB,CAM/C"}

package/dist/scope/provider.js

@@ -0,0 +1,25 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+// ─── Context ──────────────────────────────────────────────────────────────────
+const KywiContext = createContext(null);
+export function KywiProvider({ scope, currentContent = null, currentSite = null, currentUser = null, currentPath = '/', navTree = [], children, }) {
+    const value = {
+        scope,
+        currentContent,
+        currentSite,
+        currentUser,
+        currentPath,
+        navTree,
+    };
+    return _jsx(KywiContext.Provider, { value: value, children: children });
+}
+// ─── Hook ─────────────────────────────────────────────────────────────────────
+export function useKywiScope() {
+    const ctx = useContext(KywiContext);
+    if (!ctx) {
+        throw new Error('useKywiScope must be used within a KywiProvider');
+    }
+    return ctx;
+}
+//# sourceMappingURL=provider.js.map

package/dist/scope/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/scope/provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAexD,iFAAiF;AAEjF,MAAM,WAAW,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAA;AAchE,MAAM,UAAU,YAAY,CAAC,EAC3B,KAAK,EACL,cAAc,GAAG,IAAI,EACrB,WAAW,GAAG,IAAI,EAClB,WAAW,GAAG,IAAI,EAClB,WAAW,GAAG,GAAG,EACjB,OAAO,GAAG,EAAE,EACZ,QAAQ,GACU;IAClB,MAAM,KAAK,GAAqB;QAC9B,KAAK;QACL,cAAc;QACd,WAAW;QACX,WAAW;QACX,WAAW;QACX,OAAO;KACR,CAAA;IAED,OAAO,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAwB,CAAA;AAC9E,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/scope/rendering.d.ts

@@ -0,0 +1,177 @@
+import React from 'react';
+export interface NavItem {
+    id: string;
+    title: string;
+    slug: string;
+    path: string;
+    children?: NavItem[];
+}
+export interface KywiContentProps {
+    title?: string;
+    /** CMS-authored HTML from the WYSIWYG admin editor (trusted content). */
+    body?: string;
+    className?: string;
+    children?: React.ReactNode;
+}
+export declare function KywiContent({ title, body, className, children }: KywiContentProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiNavProps {
+    items: NavItem[];
+    currentPath: string;
+    className?: string;
+    depth?: number;
+}
+export declare function KywiNav({ items, currentPath, className, depth }: KywiNavProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiBodyProps {
+    /** CMS-authored HTML from the admin WYSIWYG editor (trusted content). */
+    content: string;
+    className?: string;
+    /** Show a meta/hero image above the body. */
+    showMetaImage?: boolean;
+    /** URL for the meta image. */
+    metaImageSrc?: string;
+    /** Alt text for the meta image. */
+    metaImageAlt?: string;
+    /** Size variant for the meta image (e.g. 'small', 'medium', 'large'). */
+    metaImageSize?: 'small' | 'medium' | 'large';
+    /** Show an h1 title above the body. */
+    showTitle?: boolean;
+    /** Title text to render. */
+    title?: string;
+    /** Show breadcrumbs above the body. */
+    showBreadcrumbs?: boolean;
+    /** Breadcrumbs React element to render. */
+    breadcrumbs?: React.ReactNode;
+    /** Content node ID — rendered as data-node-id attribute. */
+    nodeId?: string;
+}
+export declare function KywiBody({ content, className, showMetaImage, metaImageSrc, metaImageAlt, metaImageSize, showTitle, title, showBreadcrumbs, breadcrumbs, nodeId, }: KywiBodyProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiSummaryProps {
+    text: string;
+    className?: string;
+}
+export declare function KywiSummary({ text, className }: KywiSummaryProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiDateProps {
+    date: Date;
+    className?: string;
+}
+export declare function KywiDate({ date, className }: KywiDateProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiImageProps {
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+    className?: string;
+}
+export declare function KywiImage({ src, alt, width, height, className }: KywiImageProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiCollectionProps {
+    className?: string;
+    children?: React.ReactNode;
+}
+export declare function KywiCollection({ className, children }: KywiCollectionProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiContentTypeBodyProps {
+    baseType: string;
+    title?: string;
+    /** CMS-authored HTML body (trusted admin content). */
+    body?: string;
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Auto-dispatch by baseType: folder -> folder layout, event -> event layout, etc.
+ */
+export declare function KywiContentTypeBody({ baseType, title, body, className, children }: KywiContentTypeBodyProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiMultiPageContentProps {
+    /** CMS-authored HTML with <!-- pagebreak --> markers (trusted admin content). */
+    content: string;
+    currentPage: number;
+    className?: string;
+    /** Base URL for page links (defaults to current page). */
+    baseUrl?: string;
+}
+/**
+ * Split CMS content on `<!-- pagebreak -->` markers and render pagination.
+ */
+export declare function KywiMultiPageContent({ content, currentPage, className, baseUrl }: KywiMultiPageContentProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiSectionProps {
+    region: string;
+    as?: keyof React.JSX.IntrinsicElements;
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Named region wrapper for layout sections.
+ * Usage: `<KywiSection region="sidebar" as="aside">`
+ */
+export declare function KywiSection({ region, as: Element, className, children }: KywiSectionProps): React.ReactElement<{
+    className: string;
+    'data-region': string;
+}, string | React.JSXElementConstructor<any>>;
+export interface KywiModuleProps {
+    name: string;
+    props?: Record<string, unknown>;
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Explicit module embedding placeholder.
+ * Usage: `<KywiModule name="feedDisplay" props={{ limit: 5 }} />`
+ */
+export declare function KywiModule({ name, props: moduleProps, className, children }: KywiModuleProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiComponentProps {
+    slug?: string;
+    id?: string;
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Embed a Component content node by slug or id.
+ */
+export declare function KywiComponent({ slug, id, className, children }: KywiComponentProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiFeedDisplayProps {
+    items: Array<Record<string, unknown>>;
+    layout?: 'list' | 'grid' | 'carousel';
+    showSummary?: boolean;
+    showImage?: boolean;
+    showDate?: boolean;
+    className?: string;
+}
+/**
+ * Standalone feed display component.
+ * Renders a list of content items with configurable layout.
+ */
+export declare function KywiFeedDisplay({ items, layout, showSummary, showImage, showDate, className, }: KywiFeedDisplayProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiTagCloudTag {
+    name: string;
+    count: number;
+    href: string;
+}
+export interface KywiTagCloudProps {
+    tags: KywiTagCloudTag[];
+    className?: string;
+    /** Number of weight buckets (1-5). Defaults to 5. */
+    weightBuckets?: number;
+}
+/**
+ * Weighted tag cloud component.
+ * Assigns weight classes based on relative tag count.
+ */
+export declare function KywiTagCloud({ tags, className, weightBuckets }: KywiTagCloudProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiThemeIncludeProps {
+    file: string;
+    className?: string;
+}
+/**
+ * Template file inclusion from the theme directory.
+ * Renders a placeholder div that server-side rendering resolves to the file content.
+ */
+export declare function KywiThemeInclude({ file, className }: KywiThemeIncludeProps): import("react/jsx-runtime").JSX.Element;
+export interface KywiIncludeProps {
+    file: string;
+    className?: string;
+}
+/**
+ * Generic template file inclusion.
+ * Renders a placeholder div that server-side rendering resolves to the file content.
+ */
+export declare function KywiInclude({ file, className }: KywiIncludeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=rendering.d.ts.map

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

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