@weaverse/react 5.4.2 → 5.5.0-beta.0

package/dist/index.d.mts

@@ -3,6 +3,7 @@ export * from '@weaverse/core';
 import * as react from 'react';
 import { ReactElement, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UIMatch } from 'react-router';
 
 declare let WeaverseContext: react.Context<Weaverse>;
 declare let WeaverseContextProvider: react.Provider<Weaverse>;
@@ -11,6 +12,50 @@ declare let WeaverseItemContext: react.Context<{
     parentId: string;
 }>;
 
+interface RouteKeyedDataContext {
+    root?: Record<string, unknown>;
+    [routeKey: `routes/${string}`]: Record<string, unknown>;
+}
+type WeaverseDataContext = RouteKeyedDataContext & Record<string, unknown>;
+/**
+ * Hook to get flat route-keyed data context from matches
+ * Returns: {root: {...}, "routes/xxx": {...}}
+ * No more useLoaderData dependency - everything comes from matches
+ */
+declare function useWeaverseDataContext(): WeaverseDataContext;
+/**
+ * Helper function to create flat route-keyed data context from useMatches() result
+ * Returns: {root: {...}, "routes/xxx": {...}}
+ */
+declare function createWeaverseDataContext(matches: UIMatch<unknown, unknown>[]): WeaverseDataContext;
+
+/**
+ * Replaces data connector placeholders in content with actual values from data context
+ * Supports {{path}} syntax with dot notation, array indexing, and route prefixes
+ *
+ * Enhanced syntax:
+ * - {{root.siteSettings.title}} - Access root route data
+ * - {{layout.navigation.items}} - Access layout route data
+ * - {{parent.category.name}} - Access parent route data
+ * - {{current.product.title}} - Access current route data
+ * - {{user.name}} - Auto-resolved from combined data (backward compatible)
+ *
+ * @param content - The content string containing {{}} placeholders
+ * @param dataContext - The enhanced WeaverseDataContext with route-keyed data
+ * @returns The content with placeholders replaced by actual values
+ */
+declare function replaceContentDataConnectors(content: string, dataContext: WeaverseDataContext | Record<string, unknown> | null | undefined): string;
+/**
+ * Recursively replaces data connector placeholders in any data structure
+ * Handles strings, objects, arrays, and nested combinations
+ *
+ * @param data - The data to process (string, object, array, or primitive)
+ * @param dataContext - The data context for replacements
+ * @param visited - Set to track visited objects for circular reference protection
+ * @returns The data with all string placeholders replaced
+ */
+declare function replaceContentDataConnectorsDeep<T>(data: T, dataContext: WeaverseDataContext | Record<string, unknown> | null | undefined, visited?: WeakSet<WeakKey>): T;
+
 declare function useWeaverse<T = Weaverse>(): T;
 declare let useItemInstance: (id?: string) => WeaverseItemStore | null;
 declare let useParentInstance: () => WeaverseItemStore | null;
@@ -32,4 +77,4 @@ type ItemComponentProps = {
 declare const useSafeExternalStore: (subscribe: any, getSnapshot: any, getServerSnapshot?: any) => any;
 declare let WeaverseRoot: react.MemoExoticComponent<({ context }: WeaverseRootPropsType) => react_jsx_runtime.JSX.Element | null>;
 
-export { type ItemComponentProps, WeaverseContext, WeaverseContextProvider, type WeaverseElementProps, WeaverseItemContext, WeaverseRoot, type WeaverseRootPropsType, useChildInstances, useItemInstance, useParentInstance, useSafeExternalStore, useWeaverse };
+export { type ItemComponentProps, WeaverseContext, WeaverseContextProvider, type WeaverseDataContext, type WeaverseElementProps, WeaverseItemContext, WeaverseRoot, type WeaverseRootPropsType, createWeaverseDataContext, replaceContentDataConnectors, replaceContentDataConnectorsDeep, useChildInstances, useItemInstance, useParentInstance, useSafeExternalStore, useWeaverse, useWeaverseDataContext };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from '@weaverse/core';
 import * as react from 'react';
 import { ReactElement, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UIMatch } from 'react-router';
 
 declare let WeaverseContext: react.Context<Weaverse>;
 declare let WeaverseContextProvider: react.Provider<Weaverse>;
@@ -11,6 +12,50 @@ declare let WeaverseItemContext: react.Context<{
     parentId: string;
 }>;
 
+interface RouteKeyedDataContext {
+    root?: Record<string, unknown>;
+    [routeKey: `routes/${string}`]: Record<string, unknown>;
+}
+type WeaverseDataContext = RouteKeyedDataContext & Record<string, unknown>;
+/**
+ * Hook to get flat route-keyed data context from matches
+ * Returns: {root: {...}, "routes/xxx": {...}}
+ * No more useLoaderData dependency - everything comes from matches
+ */
+declare function useWeaverseDataContext(): WeaverseDataContext;
+/**
+ * Helper function to create flat route-keyed data context from useMatches() result
+ * Returns: {root: {...}, "routes/xxx": {...}}
+ */
+declare function createWeaverseDataContext(matches: UIMatch<unknown, unknown>[]): WeaverseDataContext;
+
+/**
+ * Replaces data connector placeholders in content with actual values from data context
+ * Supports {{path}} syntax with dot notation, array indexing, and route prefixes
+ *
+ * Enhanced syntax:
+ * - {{root.siteSettings.title}} - Access root route data
+ * - {{layout.navigation.items}} - Access layout route data
+ * - {{parent.category.name}} - Access parent route data
+ * - {{current.product.title}} - Access current route data
+ * - {{user.name}} - Auto-resolved from combined data (backward compatible)
+ *
+ * @param content - The content string containing {{}} placeholders
+ * @param dataContext - The enhanced WeaverseDataContext with route-keyed data
+ * @returns The content with placeholders replaced by actual values
+ */
+declare function replaceContentDataConnectors(content: string, dataContext: WeaverseDataContext | Record<string, unknown> | null | undefined): string;
+/**
+ * Recursively replaces data connector placeholders in any data structure
+ * Handles strings, objects, arrays, and nested combinations
+ *
+ * @param data - The data to process (string, object, array, or primitive)
+ * @param dataContext - The data context for replacements
+ * @param visited - Set to track visited objects for circular reference protection
+ * @returns The data with all string placeholders replaced
+ */
+declare function replaceContentDataConnectorsDeep<T>(data: T, dataContext: WeaverseDataContext | Record<string, unknown> | null | undefined, visited?: WeakSet<WeakKey>): T;
+
 declare function useWeaverse<T = Weaverse>(): T;
 declare let useItemInstance: (id?: string) => WeaverseItemStore | null;
 declare let useParentInstance: () => WeaverseItemStore | null;
@@ -32,4 +77,4 @@ type ItemComponentProps = {
 declare const useSafeExternalStore: (subscribe: any, getSnapshot: any, getServerSnapshot?: any) => any;
 declare let WeaverseRoot: react.MemoExoticComponent<({ context }: WeaverseRootPropsType) => react_jsx_runtime.JSX.Element | null>;
 
-export { type ItemComponentProps, WeaverseContext, WeaverseContextProvider, type WeaverseElementProps, WeaverseItemContext, WeaverseRoot, type WeaverseRootPropsType, useChildInstances, useItemInstance, useParentInstance, useSafeExternalStore, useWeaverse };
+export { type ItemComponentProps, WeaverseContext, WeaverseContextProvider, type WeaverseDataContext, type WeaverseElementProps, WeaverseItemContext, WeaverseRoot, type WeaverseRootPropsType, createWeaverseDataContext, replaceContentDataConnectors, replaceContentDataConnectorsDeep, useChildInstances, useItemInstance, useParentInstance, useSafeExternalStore, useWeaverse, useWeaverseDataContext };