@mandolop97/constructor-nexora 1.3.0 → 1.5.0

package/dist/lib/binding-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ════════════════════════════════════════════════════════════════════════════
+ * DATA BINDING UTILITIES
+ * ════════════════════════════════════════════════════════════════════════════
+ *
+ * Utilities for resolving data bindings, hydrating templates with real data,
+ * and transforming bound values.
+ */
+import { NodeBindings, RenderContext, BoundSchemaNode } from '@/types/contract';
+import { Schema, SchemaNode } from '@/types/schema';
+/**
+ * Resolve a nested field path like "product.images[0].url"
+ */
+export declare function resolveFieldPath(data: any, path: string): any;
+/**
+ * Set a value at a nested path
+ */
+export declare function setFieldPath(data: any, path: string, value: any): void;
+/**
+ * Resolve all bindings for a node and return the final props
+ */
+export declare function resolveBindings(node: BoundSchemaNode, context: RenderContext): Record<string, any>;
+/**
+ * Hydrate a template schema with real data.
+ * Creates a new schema with bound values resolved.
+ */
+export declare function hydrateTemplate(template: Schema, data: RenderContext['data']): Schema;
+/**
+ * Hydrate a single node for iteration (e.g., ProductGrid items)
+ */
+export declare function hydrateNodeForItem(node: SchemaNode, item: any, index: number, template: Schema): SchemaNode;
+/**
+ * Create a default binding configuration for a node type
+ */
+export declare function createDefaultBindings(nodeType: string): NodeBindings;
+/**
+ * Check if a node has active bindings
+ */
+export declare function hasActiveBindings(node: SchemaNode): boolean;
+/**
+ * Get the list of props that are currently bound
+ */
+export declare function getBoundProps(node: SchemaNode): string[];
+/**
+ * Register a custom transform function
+ */
+export declare function registerTransform(name: string, fn: (value: any, ...args: any[]) => any): void;
+/**
+ * Get available transform names
+ */
+export declare function getAvailableTransforms(): string[];

package/dist/lib/block-registry.d.ts

@@ -1,4 +1,4 @@
-import { NodeType, NodeProps, NodeStyle, TemplateType } from '@/types/schema';
+import { NodeType, NodeProps, NodeStyle, TemplateType, SchemaNode } from '@/types/schema';
 import React from 'react';
 export interface InspectorFieldDef {
     /** Property key on NodeProps */
@@ -6,7 +6,7 @@ export interface InspectorFieldDef {
     /** Display label */
     label: string;
     /** Field type */
-    type: 'text' | 'select' | 'color' | 'number' | 'image' | 'toggle' | 'slider' | 'textarea' | 'link' | 'icon' | 'spacing' | 'group';
+    type: 'text' | 'select' | 'color' | 'number' | 'image' | 'toggle' | 'slider' | 'textarea' | 'link' | 'icon' | 'spacing' | 'group' | 'binding';
     /** Options for 'select' type */
     options?: {
         label: string;
@@ -28,10 +28,14 @@ export interface InspectorFieldDef {
     children?: InspectorFieldDef[];
     /** Default value */
     defaultValue?: any;
+    /** For binding type: allowed data sources */
+    allowedDataSources?: string[];
+    /** For binding type: available fields */
+    bindableFields?: string[];
 }
 export interface CompositeNodeTree {
     rootId: string;
-    nodes: Record<string, import('@/types/schema').SchemaNode>;
+    nodes: Record<string, SchemaNode>;
 }
 export interface BlockDefinition {
     type: NodeType;
@@ -47,6 +51,10 @@ export interface BlockDefinition {
     allowedTemplateTypes?: TemplateType[];
     /** Factory that generates a composite tree of child nodes when this block is created */
     compositeFactory?: () => CompositeNodeTree;
+    /** Whether this block supports data binding */
+    supportsBinding?: boolean;
+    /** Description for documentation */
+    description?: string;
 }
 export declare const blockRegistry: BlockDefinition[];
 export declare function getBlockDef(type: NodeType): BlockDefinition | undefined;

package/dist/lib/card-template-utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Utilities for hydrating a Product Card template with real product data.
+ * The template is stored as a schema in page_schemas (slug: '__template/product-card').
+ */
+import { SchemaNode } from '@/types/schema';
+export interface ProductData {
+    id: string;
+    name: string;
+    price: number;
+    original_price?: number | null;
+    image_url?: string | null;
+    badge?: string | null;
+    description?: string | null;
+    category?: string | null;
+    in_stock?: boolean | null;
+    sku?: string | null;
+}
+/**
+ * Clones a template's node tree and injects product data into the appropriate nodes.
+ * Detection strategy:
+ *  - Image node → src = product.image_url
+ *  - Text with level 'h3' → text = product.name
+ *  - Text with fontWeight '600' (price) → text = formatted price
+ *  - Text with textDecoration 'line-through' → text = original price (hidden if null)
+ *  - Badge → text = product.badge (hidden if null)
+ *  - Button → locked, emits addToCart event
+ */
+export declare function hydrateCardTemplate(templateNodes: Record<string, SchemaNode>, rootNodeId: string, product: ProductData): {
+    nodes: Record<string, SchemaNode>;
+    rootId: string;
+};
+/**
+ * Formats a number as a currency string.
+ */
+export declare function formatPrice(price: number): string;

package/dist/lib/default-schemas.d.ts

@@ -1,4 +1,19 @@
-import { Schema } from '@/types/schema';
+import { Schema, SchemaNode } from '@/types/schema';
+type Nodes = Record<string, SchemaNode>;
+/**
+ * Creates a composite ProductCard node tree with individually editable sub-elements.
+ * Returns the rootId and all generated nodes for merging into a schema.
+ */
+export declare function productCardNodes(id: string, opts: {
+    name: string;
+    price: string;
+    image: string;
+    badge?: string;
+    originalPrice?: string;
+}): {
+    rootId: string;
+    nodes: Nodes;
+};
 export declare function createHomeSchema(): Schema;
 export declare function createProductsSchema(): Schema;
 export declare function createFAQSchema(): Schema;
@@ -14,3 +29,4 @@ export interface PageSchemaDefinition {
 }
 export declare const PAGE_DEFINITIONS: PageSchemaDefinition[];
 export declare function getDefaultSchemaForSlug(slug: string): Schema;
+export {};

package/dist/lib/mock-data.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Default mock data for builder edit/preview mode.
+ * Used to populate data-bound blocks when no real data is available.
+ */
+export declare const DEFAULT_MOCK_PRODUCTS: {
+    id: string;
+    name: string;
+    price: number;
+    original_price: number;
+    image_url: string;
+    category: string;
+    badge: string;
+    sku: string;
+    in_stock: boolean;
+    description: string;
+}[];
+export declare const DEFAULT_MOCK_COLLECTIONS: {
+    id: string;
+    name: string;
+    slug: string;
+    image: string;
+    description: string;
+    productCount: number;
+}[];
+export declare const DEFAULT_MOCK_SETTINGS: {
+    storeName: string;
+    currency: string;
+    language: string;
+};
+/**
+ * Build a complete RenderContext data object from mock data
+ */
+export declare function buildMockRenderData(mockData?: Record<string, any>): {
+    products: any;
+    collections: any;
+    settings: any;
+    pages: any;
+    custom: any;
+};

package/dist/lib/style-utils.d.ts

@@ -14,3 +14,16 @@ export declare function generatePseudoStateCSS(nodeId: string, style: NodeStyle)
  * Generate @container query CSS for responsive overrides.
  */
 export declare function generateResponsiveCSS(nodeId: string, style: NodeStyle): string;
+/**
+ * Merge global styles into a node's style object.
+ * Local node styles take priority over global styles.
+ */
+export declare function mergeGlobalStyles(nodeStyle: NodeStyle, appliedIds: string[] | undefined, globalStyles: Record<string, {
+    label: string;
+    style: Partial<NodeStyle>;
+}> | undefined): NodeStyle;
+/**
+ * Convert ThemeTokens into inline CSS custom properties (same logic as PageRenderer).
+ * Useful for scoping a template's theme onto a container div.
+ */
+export declare function themeTokensToCSS(t: import('@/types/schema').ThemeTokens): React.CSSProperties;