@mandolop97/constructor-nexora 1.5.0 → 1.7.0

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

@@ -1,39 +1,5 @@
 /**
- * Default mock data for builder edit/preview mode.
- * Used to populate data-bound blocks when no real data is available.
+ * @deprecated This file is a backward-compatibility shim.
+ * Import from '@/lib/host-data' instead.
  */
-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;
-};
+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[];