@mandolop97/constructor-nexora 1.3.1 → 1.7.0

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

@@ -1,12 +1,20 @@
-import { NodeType, NodeProps, NodeStyle, TemplateType } from '@/types/schema';
-import React from 'react';
+import { NodeType, NodeProps, NodeStyle, TemplateType, SchemaNode } from '@/types/schema';
+import { PageType } from '@/types/page-types';
+export interface ArrayFieldDef {
+    key: string;
+    label: string;
+    type: 'text' | 'textarea' | 'number' | 'image' | 'toggle';
+    placeholder?: string;
+    rows?: number;
+    defaultValue?: any;
+}
 export interface InspectorFieldDef {
     /** Property key on NodeProps */
     key: string;
     /** 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' | 'array';
     /** Options for 'select' type */
     options?: {
         label: string;
@@ -28,10 +36,22 @@ export interface InspectorFieldDef {
     children?: InspectorFieldDef[];
     /** Default value */
     defaultValue?: any;
+    /** For binding type: allowed data sources */
+    allowedDataSources?: string[];
+    /** For binding type: available fields */
+    bindableFields?: string[];
+    /** For 'array' type: field definitions per item */
+    arrayFields?: ArrayFieldDef[];
+    /** For 'array' type: default values for new items */
+    newItemDefaults?: Record<string, any>;
+    /** For 'array' type: add button label */
+    addLabel?: string;
+    /** For 'array' type: max items */
+    maxItems?: number;
 }
 export interface CompositeNodeTree {
     rootId: string;
-    nodes: Record<string, import('@/types/schema').SchemaNode>;
+    nodes: Record<string, SchemaNode>;
 }
 export interface BlockDefinition {
     type: NodeType;
@@ -47,6 +67,12 @@ 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;
+    /** Restrict this block to specific page types */
+    allowedPageTypes?: PageType[];
 }
 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/host-data.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Default sample data for builder edit/preview mode.
+ * Used to populate data-bound blocks when no real host data is available.
+ */
+export declare const DEFAULT_SAMPLE_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_SAMPLE_COLLECTIONS: {
+    id: string;
+    name: string;
+    slug: string;
+    image: string;
+    description: string;
+    productCount: number;
+}[];
+export declare const DEFAULT_SAMPLE_SETTINGS: {
+    storeName: string;
+    currency: string;
+    language: string;
+};
+/**
+ * Build a complete RenderContext data object from host data.
+ */
+export declare function buildHostData(hostData?: Record<string, any>): {
+    products: any;
+    collections: any;
+    settings: any;
+    pages: any;
+    custom: any;
+};
+/** @deprecated Use DEFAULT_SAMPLE_PRODUCTS */
+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;
+}[];
+/** @deprecated Use DEFAULT_SAMPLE_COLLECTIONS */
+export declare const DEFAULT_MOCK_COLLECTIONS: {
+    id: string;
+    name: string;
+    slug: string;
+    image: string;
+    description: string;
+    productCount: number;
+}[];
+/** @deprecated Use DEFAULT_SAMPLE_SETTINGS */
+export declare const DEFAULT_MOCK_SETTINGS: {
+    storeName: string;
+    currency: string;
+    language: string;
+};
+/** @deprecated Use buildHostData */
+export declare const buildMockRenderData: typeof buildHostData;

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

@@ -0,0 +1,5 @@
+/**
+ * @deprecated This file is a backward-compatibility shim.
+ * Import from '@/lib/host-data' instead.
+ */
+export { DEFAULT_SAMPLE_PRODUCTS as DEFAULT_MOCK_PRODUCTS, DEFAULT_SAMPLE_COLLECTIONS as DEFAULT_MOCK_COLLECTIONS, DEFAULT_SAMPLE_SETTINGS as DEFAULT_MOCK_SETTINGS, buildHostData as buildMockRenderData, DEFAULT_SAMPLE_PRODUCTS, DEFAULT_SAMPLE_COLLECTIONS, DEFAULT_SAMPLE_SETTINGS, buildHostData, } from './host-data';

package/dist/lib/publish-validator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ════════════════════════════════════════════════════════════════════════════
+ * NEXORA — PUBLISH VALIDATOR
+ * ════════════════════════════════════════════════════════════════════════════
+ * Validates a schema before publishing to catch structural issues,
+ * missing required props, orphan nodes, and binding errors.
+ */
+import { Schema, NodeType } from '@/types/schema';
+import { PageType } from '@/types/page-types';
+export type ValidationSeverity = 'error' | 'warning';
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    nodeId?: string;
+    nodeType?: string;
+    message: string;
+    code: string;
+}
+export interface PublishValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+interface ValidatorOptions {
+    /** Current page type for compatibility checks */
+    pageType?: PageType;
+    /** Whether to check bindings */
+    checkBindings?: boolean;
+    /** Custom required props per node type */
+    requiredProps?: Partial<Record<NodeType, string[]>>;
+}
+export declare function validateForPublish(schema: Schema, options?: ValidatorOptions): PublishValidationResult;
+export {};

package/dist/lib/render-context-utils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ════════════════════════════════════════════════════════════════════════════
+ * RENDER CONTEXT UTILITIES
+ * ════════════════════════════════════════════════════════════════════════════
+ *
+ * Helper functions for building and validating RenderContext objects.
+ * Used by both the builder and consumer templates.
+ */
+import { RenderContext, PageContext, RenderMode } from '@/types/contract';
+import { ThemeTokens, SchemaNode } from '@/types/schema';
+export interface BuildRenderContextOptions {
+    mode: RenderMode;
+    page?: Partial<PageContext>;
+    products?: any[];
+    collections?: any[];
+    pages?: any[];
+    settings?: Record<string, any>;
+    cardTemplate?: {
+        nodes: Record<string, SchemaNode>;
+        rootNodeId: string;
+        themeTokens?: ThemeTokens;
+    };
+    custom?: Record<string, any>;
+    theme?: ThemeTokens;
+    resolveAssetUrl?: (path: string) => string;
+    /** Use sample data when data is not provided */
+    useSampleData?: boolean;
+}
+/**
+ * Build a complete RenderContext from options.
+ *
+ * This is the recommended way to create a RenderContext in both
+ * builder (edit mode) and template (public/preview mode).
+ */
+export declare function buildRenderContext(options: BuildRenderContextOptions): RenderContext;
+/**
+ * Validate a RenderContext and return any issues.
+ * Used for debugging and pre-render checks.
+ */
+export declare function validateRenderContext(ctx: RenderContext | undefined): string[];
+/**
+ * Check if RenderContext is "strict" (has all required fields for production).
+ * V1.1 will make these fields required; this helper aids migration.
+ */
+export declare function isStrictRenderContext(ctx: RenderContext): boolean;
+/**
+ * Build RenderContext for edit mode using hostData.
+ * This is the standard builder context builder.
+ */
+export declare function buildEditContext(hostData: Record<string, any> | undefined, theme?: ThemeTokens): RenderContext;
+/**
+ * Create an iteration context for collection rendering (e.g., ProductGrid).
+ * Clones the parent context and adds currentItem/currentIndex.
+ */
+export declare function createIterationContext(parentContext: RenderContext, item: any, index: number): RenderContext;

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

@@ -0,0 +1,66 @@
+/**
+ * ════════════════════════════════════════════════════════════════════════════
+ * SLOT UTILITIES
+ * ════════════════════════════════════════════════════════════════════════════
+ *
+ * Runtime utilities for handling slot behavior in the builder and renderer.
+ */
+import { SchemaNode, Schema } from '@/types/schema';
+import { SlotBehavior, SlotAssignment } from '@/types/contract';
+/**
+ * Get the slot assignment for a node, if any.
+ */
+export declare function getSlotAssignment(node: SchemaNode): SlotAssignment | undefined;
+/**
+ * Check if a node is assigned to a specific slot.
+ */
+export declare function isInSlot(node: SchemaNode, slotName: string): boolean;
+/**
+ * Get the behavior of a node's slot.
+ * Returns 'editable' as default if no slot is assigned.
+ */
+export declare function getSlotBehavior(node: SchemaNode): SlotBehavior;
+/**
+ * Check if a node is locked (cannot be edited/moved/deleted).
+ */
+export declare function isSlotLocked(node: SchemaNode): boolean;
+/**
+ * Check if a node is editable in the current context.
+ */
+export declare function isSlotEditable(node: SchemaNode): boolean;
+/**
+ * Check if a node is dynamic (data-driven).
+ */
+export declare function isSlotDynamic(node: SchemaNode): boolean;
+/**
+ * Get all nodes assigned to a specific slot.
+ */
+export declare function getNodesInSlot(schema: Schema, slotName: string): SchemaNode[];
+/**
+ * Get the fallback node ID for a slot, if configured.
+ */
+export declare function getSlotFallback(node: SchemaNode): string | undefined;
+/**
+ * Build slot constraints for the Inspector.
+ * Returns which props/actions should be disabled based on slot behavior.
+ */
+export interface SlotConstraints {
+    /** Can edit props in inspector */
+    canEditProps: boolean;
+    /** Can edit styles in inspector */
+    canEditStyles: boolean;
+    /** Can delete the node */
+    canDelete: boolean;
+    /** Can move/reorder the node */
+    canMove: boolean;
+    /** Can duplicate the node */
+    canDuplicate: boolean;
+    /** Reason for restrictions (shown to user) */
+    restrictionReason?: string;
+}
+export declare function getSlotConstraints(node: SchemaNode): SlotConstraints;
+/**
+ * Validate slot assignments in a schema.
+ * Returns issues found.
+ */
+export declare function validateSlots(schema: Schema): string[];

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;