@bravostudioai/react 0.1.31 → 0.1.34

package/dist/src/lib/dataPatching.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Data patching utilities for fixing layout and component issues
+ *
+ * Applies heuristic-based fixes to page data to correct common layout problems
+ * that occur during the Figma-to-Encore conversion process.
+ */
+/**
+ * Recursively patches page data to fix layout issues
+ *
+ * Current heuristics:
+ * 1. Horizontal layout detection - If children widths sum to ~100% or ~375px,
+ *    force HORIZONTAL layout mode to prevent vertical stacking
+ *
+ * @param clientData - The client data object from page definition
+ * @returns Patched client data (mutates in place)
+ */
+export declare function patchPageData(clientData: any): any;
+//# sourceMappingURL=dataPatching.d.ts.map

package/dist/src/lib/dataPatching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataPatching.d.ts","sourceRoot":"","sources":["../../../src/lib/dataPatching.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CA0DlD"}

package/dist/src/lib/dynamicModules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamicModules.d.ts","sourceRoot":"","sources":["../../../src/lib/dynamicModules.ts"],"names":[],"mappings":"AAUA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAyGvD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,gBAoE1C;AAOD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"dynamicModules.d.ts","sourceRoot":"","sources":["../../../src/lib/dynamicModules.ts"],"names":[],"mappings":"AAWA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAuGvD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,gBAoE1C;AAOD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/lib/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/lib/fetcher.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,iBAAiB,cAEtB,CAAC;AAIF,QAAA,MAAM,OAAO,GAAI,KAAK,MAAM,QA2F3B,CAAC;AAEF,eAAe,OAAO,CAAC;AACvB,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,CAAC"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/lib/fetcher.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,iBAAiB,cAEtB,CAAC;AAIF,QAAA,MAAM,OAAO,GAAI,KAAK,MAAM,QAmF3B,CAAC;AAEF,eAAe,OAAO,CAAC;AACvB,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,CAAC"}

package/dist/src/lib/logger.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Centralized logging utility for encore-lib
+ *
+ * Provides conditional logging based on environment.
+ * Debug logs only appear in development mode.
+ */
+/**
+ * Logger instance with environment-aware methods
+ */
+export declare const logger: {
+    /**
+     * Debug-level logging (only in development)
+     * Use for detailed diagnostic information
+     */
+    debug: (...args: any[]) => void;
+    /**
+     * Info-level logging (only in development)
+     * Use for general informational messages
+     */
+    info: (...args: any[]) => void;
+    /**
+     * Warning-level logging (always shown)
+     * Use for recoverable issues that need attention
+     */
+    warn: (...args: any[]) => void;
+    /**
+     * Error-level logging (always shown)
+     * Use for errors and exceptions
+     */
+    error: (...args: any[]) => void;
+};
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;;OAGG;qBACc,GAAG,EAAE;IAMtB;;;OAGG;oBACa,GAAG,EAAE;IAMrB;;;OAGG;oBACa,GAAG,EAAE;IAIrB;;;OAGG;qBACc,GAAG,EAAE;CAGvB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/lib/moduleRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"moduleRegistry.d.ts","sourceRoot":"","sources":["../../../src/lib/moduleRegistry.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAEvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,OAE5C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKnD"}
+{"version":3,"file":"moduleRegistry.d.ts","sourceRoot":"","sources":["../../../src/lib/moduleRegistry.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAEvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,OAE5C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKnD"}

package/dist/src/stores/useEncoreState.d.ts

@@ -1,33 +1,75 @@
-type EncoreState = {
+/**
+ * Global state for the Encore runtime
+ *
+ * Manages app data, form inputs, authentication, and UI state across
+ * all Encore components in the application.
+ */
+export type EncoreState = {
+    /** Current app definition loaded from Encore service */
     app: any;
+    /** Base URL for Encore service API requests */
     baseURL: string;
+    /** Authentication token with expiration and refresh capability */
     accessToken?: {
         expireAt: number;
         token: string;
         refreshToken: string;
         params: string;
     };
+    /** Currently loaded app ID */
     appId?: string;
+    /** Form input values organized by page ID, then by component ID */
     formInputs: Record<string, Record<string, any>>;
+    /** Currently loaded page ID */
     pageId?: string;
+    /** Component variant selections for stateful sets */
     statefulSetVariants: Record<string, string>;
+    /** Input group selections - maps group name to active element name */
     inputGroups: Record<string, string>;
+    /** Asset lookup by ID (images, videos, etc.) */
     assetsById: Record<string, any>;
+    /** Font family names by font ID */
     fontsById: Record<string, string>;
+    /** Full font metadata by font ID */
     fontsByIdFull: Record<string, {
         family: string;
         postScriptName?: string;
     }>;
+    /** Clear all form inputs across all pages */
     resetFormInputs: () => void;
+    /** Set authentication token */
     setAccessToken: (accessToken: EncoreState["accessToken"]) => void;
+    /** Set app definition and extract assets/fonts */
     setApp: (app: any) => void;
+    /** Set current app ID */
     setAppId: (appId: string) => void;
+    /** Set form input value for current page */
     setFormInputValue: (nodeId: string, value: any) => void;
+    /** Set current page ID */
     setPageId: (pageId: string) => void;
+    /** Set active variant for a stateful set component */
     setStatefulSetVariant: (statefulSetId: string, variant: string) => void;
+    /** Set active element for an input group */
     setInputGroupValue: (groupName: string, elementName: string) => void;
+    /** Set base URL for Encore service */
     setBaseURL: (baseURL: string) => void;
 };
 declare const useEncoreState: import("zustand").UseBoundStore<import("zustand").StoreApi<EncoreState>>;
+/**
+ * Global Zustand store for Encore runtime state
+ *
+ * Provides centralized state management for app data, form inputs,
+ * authentication, and UI state across all Encore components.
+ *
+ * @example
+ * // Access state in a component
+ * const app = useEncoreState((state) => state.app);
+ * const setFormValue = useEncoreState((state) => state.setFormInputValue);
+ *
+ * @example
+ * // Access state outside React components
+ * const currentApp = useEncoreState.getState().app;
+ * useEncoreState.getState().setAppId('01ABC123');
+ */
 export default useEncoreState;
 //# sourceMappingURL=useEncoreState.d.ts.map

package/dist/src/stores/useEncoreState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEncoreState.d.ts","sourceRoot":"","sources":["../../../src/stores/useEncoreState.ts"],"names":[],"mappings":"AAKA,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE3E,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,cAAc,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IAClE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACxD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,QAAA,MAAM,cAAc,0EA4FjB,CAAC;AAEJ,eAAe,cAAc,CAAC"}
+{"version":3,"file":"useEncoreState.d.ts","sourceRoot":"","sources":["../../../src/stores/useEncoreState.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,wDAAwD;IACxD,GAAG,EAAE,GAAG,CAAC;IAET,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB,kEAAkE;IAClE,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAEhD,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5C,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE3E,6CAA6C;IAC7C,eAAe,EAAE,MAAM,IAAI,CAAC;IAE5B,+BAA+B;IAC/B,cAAc,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IAElE,kDAAkD;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAE3B,yBAAyB;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,4CAA4C;IAC5C,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAExD,0BAA0B;IAC1B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,sDAAsD;IACtD,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAExE,4CAA4C;IAC5C,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAErE,sCAAsC;IACtC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,QAAA,MAAM,cAAc,0EA4FjB,CAAC;AAEJ;;;;;;;;;;;;;;;GAeG;AACH,eAAe,cAAc,CAAC"}

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "0.1.28";
+export declare const PACKAGE_VERSION = "0.1.34";
 //# sourceMappingURL=version.d.ts.map

package/dist/stores/useEncoreState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEncoreState.js","sources":["../../src/stores/useEncoreState.ts"],"sourcesContent":["\"use client\";\nimport { create } from \"zustand\";\n\nimport { CONST_APPS_SERVICE_URL } from \"../../constants\";\n\ntype EncoreState = {\n  app: any;\n  baseURL: string;\n  accessToken?: {\n    expireAt: number;\n    token: string;\n    refreshToken: string;\n    params: string;\n  };\n  appId?: string;\n  formInputs: Record<string, Record<string, any>>;\n  pageId?: string;\n  statefulSetVariants: Record<string, string>;\n  inputGroups: Record<string, string>; // Maps group name to active element name\n  assetsById: Record<string, any>;\n  fontsById: Record<string, string>;\n  fontsByIdFull: Record<string, { family: string; postScriptName?: string }>;\n\n  resetFormInputs: () => void;\n  setAccessToken: (accessToken: EncoreState[\"accessToken\"]) => void;\n  setApp: (app: any) => void;\n  setAppId: (appId: string) => void;\n  setFormInputValue: (nodeId: string, value: any) => void;\n  setPageId: (pageId: string) => void;\n  setStatefulSetVariant: (statefulSetId: string, variant: string) => void;\n  setInputGroupValue: (groupName: string, elementName: string) => void;\n  setBaseURL: (baseURL: string) => void;\n};\n\nconst useEncoreState = create<EncoreState>((set) => ({\n  app: undefined,\n  baseURL:\n    (typeof import.meta !== \"undefined\" &&\n      (import.meta as any).env &&\n      (import.meta as any).env.VITE_APPS_SERVICE_URL) ||\n    CONST_APPS_SERVICE_URL,\n\n  accessToken: undefined,\n  appId: undefined,\n  formInputs: {},\n  pageId: undefined,\n  statefulSetVariants: {},\n  inputGroups: {},\n  assetsById: {},\n  fontsById: {},\n  fontsByIdFull: {},\n\n  resetFormInputs: () => set((state) => ({ ...state, formInputs: {} })),\n\n  setAccessToken: (accessToken) => set((state) => ({ ...state, accessToken })),\n\n  setApp: (app: any) =>\n    set((state) => ({\n      ...state,\n      app,\n      assetsById:\n        app.app?.assets?.reduce?.(\n          (acc: Record<string, any>, asset: any) => ({\n            ...acc,\n            [asset.id]: asset,\n          }),\n          {}\n        ) ?? {},\n      fontsById:\n        app.app?.fonts?.reduce?.(\n          (acc: Record<string, string>, font: any) => ({\n            ...acc,\n            [font.id]:\n              font.fontName?.postScriptName ||\n              font.fontName?.family ||\n              \"sans-serif\",\n          }),\n          {}\n        ) ?? {},\n      fontsByIdFull:\n        app.app?.fonts?.reduce?.(\n          (\n            acc: Record<string, { family: string; postScriptName?: string }>,\n            font: any\n          ) => ({\n            ...acc,\n            [font.id]: {\n              family: font.fontName?.family || \"sans-serif\",\n              postScriptName: font.fontName?.postScriptName,\n            },\n          }),\n          {}\n        ) ?? {},\n    })),\n\n  setAppId: (appId) => set((state) => ({ ...state, appId })),\n\n  setFormInputValue: (nodeId, value) =>\n    set((state) => {\n      const oldPageInputs = state.formInputs[state.pageId!] || {};\n      const newPageInputs = { ...oldPageInputs, [nodeId]: value };\n      const newInputs = { ...state.formInputs, [state.pageId!]: newPageInputs };\n      return { ...state, formInputs: newInputs };\n    }),\n\n  setPageId: (pageId) => set((state) => ({ ...state, pageId })),\n\n  setStatefulSetVariant: (statefulSetId, variant) =>\n    set((state) => ({\n      ...state,\n      statefulSetVariants: {\n        ...state.statefulSetVariants,\n        [statefulSetId]: variant,\n      },\n    })),\n\n  setInputGroupValue: (groupName, elementName) =>\n    set((state) => ({\n      ...state,\n      inputGroups: {\n        ...state.inputGroups,\n        [groupName]: elementName,\n      },\n    })),\n\n  setBaseURL: (baseURL) => set((state) => ({ ...state, baseURL })),\n}));\n\nexport default useEncoreState;\n"],"names":["useEncoreState","create","set","CONST_APPS_SERVICE_URL","state","accessToken","app","acc","asset","font","appId","nodeId","value","newPageInputs","newInputs","pageId","statefulSetId","variant","groupName","elementName","baseURL"],"mappings":";;AAkCA,MAAMA,IAAiBC,EAAoB,CAACC,OAAS;AAAA,EACnD,KAAK;AAAA,EACL,SAIEC;AAAA,EAEF,aAAa;AAAA,EACb,OAAO;AAAA,EACP,YAAY,CAAA;AAAA,EACZ,QAAQ;AAAA,EACR,qBAAqB,CAAA;AAAA,EACrB,aAAa,CAAA;AAAA,EACb,YAAY,CAAA;AAAA,EACZ,WAAW,CAAA;AAAA,EACX,eAAe,CAAA;AAAA,EAEf,iBAAiB,MAAMD,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,YAAY,CAAA,EAAC,EAAI;AAAA,EAEpE,gBAAgB,CAACC,MAAgBH,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,aAAAC,EAAA,EAAc;AAAA,EAE3E,QAAQ,CAACC,MACPJ,EAAI,CAACE,OAAW;AAAA,IACd,GAAGA;AAAA,IACH,KAAAE;AAAA,IACA,YACEA,EAAI,KAAK,QAAQ;AAAA,MACf,CAACC,GAA0BC,OAAgB;AAAA,QACzC,GAAGD;AAAA,QACH,CAACC,EAAM,EAAE,GAAGA;AAAA,MAAA;AAAA,MAEd,CAAA;AAAA,IAAC,KACE,CAAA;AAAA,IACP,WACEF,EAAI,KAAK,OAAO;AAAA,MACd,CAACC,GAA6BE,OAAe;AAAA,QAC3C,GAAGF;AAAA,QACH,CAACE,EAAK,EAAE,GACNA,EAAK,UAAU,kBACfA,EAAK,UAAU,UACf;AAAA,MAAA;AAAA,MAEJ,CAAA;AAAA,IAAC,KACE,CAAA;AAAA,IACP,eACEH,EAAI,KAAK,OAAO;AAAA,MACd,CACEC,GACAE,OACI;AAAA,QACJ,GAAGF;AAAA,QACH,CAACE,EAAK,EAAE,GAAG;AAAA,UACT,QAAQA,EAAK,UAAU,UAAU;AAAA,UACjC,gBAAgBA,EAAK,UAAU;AAAA,QAAA;AAAA,MACjC;AAAA,MAEF,CAAA;AAAA,IAAC,KACE,CAAA;AAAA,EAAC,EACR;AAAA,EAEJ,UAAU,CAACC,MAAUR,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,OAAAM,EAAA,EAAQ;AAAA,EAEzD,mBAAmB,CAACC,GAAQC,MAC1BV,EAAI,CAACE,MAAU;AAEb,UAAMS,IAAgB,EAAE,GADFT,EAAM,WAAWA,EAAM,MAAO,KAAK,CAAA,GACf,CAACO,CAAM,GAAGC,EAAA,GAC9CE,IAAY,EAAE,GAAGV,EAAM,YAAY,CAACA,EAAM,MAAO,GAAGS,EAAA;AAC1D,WAAO,EAAE,GAAGT,GAAO,YAAYU,EAAA;AAAA,EACjC,CAAC;AAAA,EAEH,WAAW,CAACC,MAAWb,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,QAAAW,EAAA,EAAS;AAAA,EAE5D,uBAAuB,CAACC,GAAeC,MACrCf,EAAI,CAACE,OAAW;AAAA,IACd,GAAGA;AAAA,IACH,qBAAqB;AAAA,MACnB,GAAGA,EAAM;AAAA,MACT,CAACY,CAAa,GAAGC;AAAA,IAAA;AAAA,EACnB,EACA;AAAA,EAEJ,oBAAoB,CAACC,GAAWC,MAC9BjB,EAAI,CAACE,OAAW;AAAA,IACd,GAAGA;AAAA,IACH,aAAa;AAAA,MACX,GAAGA,EAAM;AAAA,MACT,CAACc,CAAS,GAAGC;AAAA,IAAA;AAAA,EACf,EACA;AAAA,EAEJ,YAAY,CAACC,MAAYlB,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,SAAAgB,IAAU;AACjE,EAAE;"}
+{"version":3,"file":"useEncoreState.js","sources":["../../src/stores/useEncoreState.ts"],"sourcesContent":["\"use client\";\nimport { create } from \"zustand\";\n\nimport { CONST_APPS_SERVICE_URL } from \"../../constants\";\n\n/**\n * Global state for the Encore runtime\n *\n * Manages app data, form inputs, authentication, and UI state across\n * all Encore components in the application.\n */\nexport type EncoreState = {\n  /** Current app definition loaded from Encore service */\n  app: any;\n\n  /** Base URL for Encore service API requests */\n  baseURL: string;\n\n  /** Authentication token with expiration and refresh capability */\n  accessToken?: {\n    expireAt: number;\n    token: string;\n    refreshToken: string;\n    params: string;\n  };\n\n  /** Currently loaded app ID */\n  appId?: string;\n\n  /** Form input values organized by page ID, then by component ID */\n  formInputs: Record<string, Record<string, any>>;\n\n  /** Currently loaded page ID */\n  pageId?: string;\n\n  /** Component variant selections for stateful sets */\n  statefulSetVariants: Record<string, string>;\n\n  /** Input group selections - maps group name to active element name */\n  inputGroups: Record<string, string>;\n\n  /** Asset lookup by ID (images, videos, etc.) */\n  assetsById: Record<string, any>;\n\n  /** Font family names by font ID */\n  fontsById: Record<string, string>;\n\n  /** Full font metadata by font ID */\n  fontsByIdFull: Record<string, { family: string; postScriptName?: string }>;\n\n  /** Clear all form inputs across all pages */\n  resetFormInputs: () => void;\n\n  /** Set authentication token */\n  setAccessToken: (accessToken: EncoreState[\"accessToken\"]) => void;\n\n  /** Set app definition and extract assets/fonts */\n  setApp: (app: any) => void;\n\n  /** Set current app ID */\n  setAppId: (appId: string) => void;\n\n  /** Set form input value for current page */\n  setFormInputValue: (nodeId: string, value: any) => void;\n\n  /** Set current page ID */\n  setPageId: (pageId: string) => void;\n\n  /** Set active variant for a stateful set component */\n  setStatefulSetVariant: (statefulSetId: string, variant: string) => void;\n\n  /** Set active element for an input group */\n  setInputGroupValue: (groupName: string, elementName: string) => void;\n\n  /** Set base URL for Encore service */\n  setBaseURL: (baseURL: string) => void;\n};\n\nconst useEncoreState = create<EncoreState>((set) => ({\n  app: undefined,\n  baseURL:\n    (typeof import.meta !== \"undefined\" &&\n      (import.meta as any).env &&\n      (import.meta as any).env.VITE_APPS_SERVICE_URL) ||\n    CONST_APPS_SERVICE_URL,\n\n  accessToken: undefined,\n  appId: undefined,\n  formInputs: {},\n  pageId: undefined,\n  statefulSetVariants: {},\n  inputGroups: {},\n  assetsById: {},\n  fontsById: {},\n  fontsByIdFull: {},\n\n  resetFormInputs: () => set((state) => ({ ...state, formInputs: {} })),\n\n  setAccessToken: (accessToken) => set((state) => ({ ...state, accessToken })),\n\n  setApp: (app: any) =>\n    set((state) => ({\n      ...state,\n      app,\n      assetsById:\n        app.app?.assets?.reduce?.(\n          (acc: Record<string, any>, asset: any) => ({\n            ...acc,\n            [asset.id]: asset,\n          }),\n          {}\n        ) ?? {},\n      fontsById:\n        app.app?.fonts?.reduce?.(\n          (acc: Record<string, string>, font: any) => ({\n            ...acc,\n            [font.id]:\n              font.fontName?.postScriptName ||\n              font.fontName?.family ||\n              \"sans-serif\",\n          }),\n          {}\n        ) ?? {},\n      fontsByIdFull:\n        app.app?.fonts?.reduce?.(\n          (\n            acc: Record<string, { family: string; postScriptName?: string }>,\n            font: any\n          ) => ({\n            ...acc,\n            [font.id]: {\n              family: font.fontName?.family || \"sans-serif\",\n              postScriptName: font.fontName?.postScriptName,\n            },\n          }),\n          {}\n        ) ?? {},\n    })),\n\n  setAppId: (appId) => set((state) => ({ ...state, appId })),\n\n  setFormInputValue: (nodeId, value) =>\n    set((state) => {\n      const oldPageInputs = state.formInputs[state.pageId!] || {};\n      const newPageInputs = { ...oldPageInputs, [nodeId]: value };\n      const newInputs = { ...state.formInputs, [state.pageId!]: newPageInputs };\n      return { ...state, formInputs: newInputs };\n    }),\n\n  setPageId: (pageId) => set((state) => ({ ...state, pageId })),\n\n  setStatefulSetVariant: (statefulSetId, variant) =>\n    set((state) => ({\n      ...state,\n      statefulSetVariants: {\n        ...state.statefulSetVariants,\n        [statefulSetId]: variant,\n      },\n    })),\n\n  setInputGroupValue: (groupName, elementName) =>\n    set((state) => ({\n      ...state,\n      inputGroups: {\n        ...state.inputGroups,\n        [groupName]: elementName,\n      },\n    })),\n\n  setBaseURL: (baseURL) => set((state) => ({ ...state, baseURL })),\n}));\n\n/**\n * Global Zustand store for Encore runtime state\n *\n * Provides centralized state management for app data, form inputs,\n * authentication, and UI state across all Encore components.\n *\n * @example\n * // Access state in a component\n * const app = useEncoreState((state) => state.app);\n * const setFormValue = useEncoreState((state) => state.setFormInputValue);\n *\n * @example\n * // Access state outside React components\n * const currentApp = useEncoreState.getState().app;\n * useEncoreState.getState().setAppId('01ABC123');\n */\nexport default useEncoreState;\n"],"names":["useEncoreState","create","set","CONST_APPS_SERVICE_URL","state","accessToken","app","acc","asset","font","appId","nodeId","value","newPageInputs","newInputs","pageId","statefulSetId","variant","groupName","elementName","baseURL"],"mappings":";;AA8EA,MAAMA,IAAiBC,EAAoB,CAACC,OAAS;AAAA,EACnD,KAAK;AAAA,EACL,SAIEC;AAAA,EAEF,aAAa;AAAA,EACb,OAAO;AAAA,EACP,YAAY,CAAA;AAAA,EACZ,QAAQ;AAAA,EACR,qBAAqB,CAAA;AAAA,EACrB,aAAa,CAAA;AAAA,EACb,YAAY,CAAA;AAAA,EACZ,WAAW,CAAA;AAAA,EACX,eAAe,CAAA;AAAA,EAEf,iBAAiB,MAAMD,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,YAAY,CAAA,EAAC,EAAI;AAAA,EAEpE,gBAAgB,CAACC,MAAgBH,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,aAAAC,EAAA,EAAc;AAAA,EAE3E,QAAQ,CAACC,MACPJ,EAAI,CAACE,OAAW;AAAA,IACd,GAAGA;AAAA,IACH,KAAAE;AAAA,IACA,YACEA,EAAI,KAAK,QAAQ;AAAA,MACf,CAACC,GAA0BC,OAAgB;AAAA,QACzC,GAAGD;AAAA,QACH,CAACC,EAAM,EAAE,GAAGA;AAAA,MAAA;AAAA,MAEd,CAAA;AAAA,IAAC,KACE,CAAA;AAAA,IACP,WACEF,EAAI,KAAK,OAAO;AAAA,MACd,CAACC,GAA6BE,OAAe;AAAA,QAC3C,GAAGF;AAAA,QACH,CAACE,EAAK,EAAE,GACNA,EAAK,UAAU,kBACfA,EAAK,UAAU,UACf;AAAA,MAAA;AAAA,MAEJ,CAAA;AAAA,IAAC,KACE,CAAA;AAAA,IACP,eACEH,EAAI,KAAK,OAAO;AAAA,MACd,CACEC,GACAE,OACI;AAAA,QACJ,GAAGF;AAAA,QACH,CAACE,EAAK,EAAE,GAAG;AAAA,UACT,QAAQA,EAAK,UAAU,UAAU;AAAA,UACjC,gBAAgBA,EAAK,UAAU;AAAA,QAAA;AAAA,MACjC;AAAA,MAEF,CAAA;AAAA,IAAC,KACE,CAAA;AAAA,EAAC,EACR;AAAA,EAEJ,UAAU,CAACC,MAAUR,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,OAAAM,EAAA,EAAQ;AAAA,EAEzD,mBAAmB,CAACC,GAAQC,MAC1BV,EAAI,CAACE,MAAU;AAEb,UAAMS,IAAgB,EAAE,GADFT,EAAM,WAAWA,EAAM,MAAO,KAAK,CAAA,GACf,CAACO,CAAM,GAAGC,EAAA,GAC9CE,IAAY,EAAE,GAAGV,EAAM,YAAY,CAACA,EAAM,MAAO,GAAGS,EAAA;AAC1D,WAAO,EAAE,GAAGT,GAAO,YAAYU,EAAA;AAAA,EACjC,CAAC;AAAA,EAEH,WAAW,CAACC,MAAWb,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,QAAAW,EAAA,EAAS;AAAA,EAE5D,uBAAuB,CAACC,GAAeC,MACrCf,EAAI,CAACE,OAAW;AAAA,IACd,GAAGA;AAAA,IACH,qBAAqB;AAAA,MACnB,GAAGA,EAAM;AAAA,MACT,CAACY,CAAa,GAAGC;AAAA,IAAA;AAAA,EACnB,EACA;AAAA,EAEJ,oBAAoB,CAACC,GAAWC,MAC9BjB,EAAI,CAACE,OAAW;AAAA,IACd,GAAGA;AAAA,IACH,aAAa;AAAA,MACX,GAAGA,EAAM;AAAA,MACT,CAACc,CAAS,GAAGC;AAAA,IAAA;AAAA,EACf,EACA;AAAA,EAEJ,YAAY,CAACC,MAAYlB,EAAI,CAACE,OAAW,EAAE,GAAGA,GAAO,SAAAgB,IAAU;AACjE,EAAE;"}

package/dist/version.js

@@ -1,4 +1,4 @@
-const o = "0.1.28";
+const o = "0.1.34";
 export {
   o as PACKAGE_VERSION
 };

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["export const PACKAGE_VERSION = \"0.1.28\";\n"],"names":["PACKAGE_VERSION"],"mappings":"AAAO,MAAMA,IAAkB;"}
+{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["export const PACKAGE_VERSION = \"0.1.34\";\n"],"names":["PACKAGE_VERSION"],"mappings":"AAAO,MAAMA,IAAkB;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bravostudioai/react",
-  "version": "0.1.31",
+  "version": "0.1.34",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/src/index.d.ts",
@@ -39,6 +39,7 @@
   },
   "dependencies": {
     "axios": "^1.13.0",
+    "commander": "^14.0.2",
     "dotenv": "^16.0.0",
     "pusher-js": "^8.4.0",
     "swr": "^2.3.6",

package/src/cli/commands/download.ts

@@ -88,35 +88,15 @@ async function downloadEncoreFiles({
   console.log("\n✓ All files downloaded successfully!");
 }
 
-function printUsage() {
-  console.log(`
-Usage: download-bravo.ts <appId> <pageId> <targetPath>
-
-Arguments:
-  appId      The Encore app ID
-  pageId     The Encore page ID
-  targetPath Path where files should be saved
-
-Environment variables:
-  APPS_SERVICE_URL  Base URL for the apps service
-
-Example:
-  download-bravo.ts my-app-id my-page-id ./bravo-files
-  APPS_SERVICE_URL=https://api.example.com download-bravo.ts my-app-id my-page-id ./bravo-files
-`);
-}
-
-export async function runDownload(args: string[]) {
-  if (args.length < 3 || args.includes("--help") || args.includes("-h")) {
-    printUsage();
-    process.exit(args.includes("--help") || args.includes("-h") ? 0 : 1);
-  }
-
-  const [appId, pageId, targetPath] = args;
-
+export async function runDownload(
+  appId: string,
+  pageId: string,
+  targetPath: string
+) {
   if (!appId || !pageId || !targetPath) {
-    console.error("Error: Missing required arguments");
-    printUsage();
+    console.error(
+      "Error: Missing required arguments. Usage: download <appId> <pageId> <targetPath>"
+    );
     process.exit(1);
   }
 

package/src/cli/commands/generate.ts

@@ -84,17 +84,19 @@ async function generateWrapper({
   pageId,
   outputPath,
   cachedAppData,
-  isProduction,
+  mode = "dynamic",
   usedNames,
 }: {
   appId: string;
   pageId: string;
   outputPath: string;
   cachedAppData?: any;
-  isProduction?: boolean;
+  mode?: string;
   usedNames?: Set<string>;
 }) {
-  console.log(`Generating wrapper for app: ${appId}, page: ${pageId}`);
+  console.log(
+    `Generating wrapper for app: ${appId}, page: ${pageId}, mode: ${mode}`
+  );
 
   // Determine final output path - we'll update it after we get app/page names
   let finalOutputPath = outputPath;
@@ -283,6 +285,7 @@ async function generateWrapper({
   }
 
   // Generate component code and README
+  const shouldBundleData = mode === "production" || mode === "optimistic";
   const componentCode = generateComponentCode(
     appId,
     pageId,
@@ -293,7 +296,7 @@ async function generateWrapper({
     forms,
     selectInputs,
     actionButtons,
-    !!isProduction,
+    mode,
     {
       width: pageData.style?.width,
       height: pageData.style?.height,
@@ -324,7 +327,7 @@ async function generateWrapper({
   }
 
   // Write files
-  if (isProduction) {
+  if (shouldBundleData) {
     const componentJsPath = join(tempDir, "component.js");
     let componentCodeContent = "";
     try {
@@ -361,46 +364,43 @@ async function generateWrapper({
   console.log(`✓ Generated wrapper component at: ${indexPath}`);
 }
 
-function printUsage() {
-  console.log(`
-Usage: generate-wrapper.ts <appId> [pageId] <outputPath>
-
-Arguments:
-  appId      The Encore app ID
-  pageId     The Encore page ID (optional - if omitted, generates wrappers for ALL pages)
-  outputPath Path where the generated TSX file(s) should be saved
-  --production  Generate for production (bundles data)
-  --preseed     Alias for --production (bundles data)
-
-Environment variables:
-  APPS_SERVICE_URL  Base URL for the apps service
-
-Example:
-  generate-wrapper.ts 01KA964B1T6KCKSKCNMYSTKRKZ 01KA964B2F42MN4WGCYDTG1Y70 ./src/components/MyEncoreApp.tsx
-`);
-}
-
-export async function runGenerate(args: string[]) {
-  const isProduction =
-    args.includes("--production") || args.includes("--preseed");
-  const cleanArgs = args.filter(
-    (arg) => arg !== "--production" && arg !== "--preseed"
-  );
-
-  if (
-    cleanArgs.length < 2 ||
-    cleanArgs.includes("--help") ||
-    cleanArgs.includes("-h")
-  ) {
-    printUsage();
-    process.exit(
-      cleanArgs.includes("--help") || cleanArgs.includes("-h") ? 0 : 1
+export async function runGenerate(
+  appId: string,
+  pageId: string | undefined,
+  outputPath: string | undefined,
+  mode: string
+) {
+  if (!appId || (!pageId && !outputPath)) {
+    console.error(
+      "Error: Missing required arguments. Usage: generate <appId> [pageId] <outputPath>"
     );
+    process.exit(1);
   }
 
-  if (cleanArgs.length === 2) {
-    const [appId, outputPath] = cleanArgs;
+  // If outputPath is missing but we have 2 args logic from caller, handle it.
+  // actually caller logic:
+  // if 2 args (appId, pageId/output), caller puts output in output and pageId=undefined.
+  // so if we are here, we have appId and outputPath. pageId might be undefined.
+
+  // Wait, if I changed the caller to pass (appId, undefined, outputPath), I need to be sure.
+  // arguments: appId, pageId, outputPath.
+  // If user ran: generate app out
+  // caller: appId=app, pageId=out, output=undefined.
+  // caller logic: if (pageId && !output) -> output=pageId, pageId=undefined.
+  // caller calls: runGenerate(app, undefined, out, prod).
+
+  // If user ran: generate app page out
+  // caller: appId=app, pageId=page, output=out.
+  // caller calls: runGenerate(app, page, out, prod).
+
+  // So outputPath MUST be defined here effectively if the CLI usage was correct.
+  if (!outputPath) {
+    console.error("Error: Missing output path.");
+    process.exit(1);
+  }
 
+  // Default mode: Generate all pages
+  if (!pageId) {
     try {
       const { pages, appData } = await getAppPages(appId);
       if (pages.length === 0) {
@@ -417,7 +417,7 @@ export async function runGenerate(args: string[]) {
             pageId: page.id,
             outputPath,
             cachedAppData: appData,
-            isProduction,
+            mode,
             usedNames,
           });
         } catch (error) {
@@ -434,10 +434,9 @@ export async function runGenerate(args: string[]) {
     return;
   }
 
-  const [appId, pageId, outputPath] = cleanArgs;
-
+  // Single page generation
   try {
-    await generateWrapper({ appId, pageId, outputPath, isProduction }); // Single page generation, no collision context needed unless we wanted global uniqueness but usually used for one-off
+    await generateWrapper({ appId, pageId, outputPath, mode });
   } catch (error) {
     console.error("\nError:", error instanceof Error ? error.message : error);
     process.exit(1);

package/src/cli/index.ts

@@ -1,35 +1,52 @@
-
+import { Command } from "commander";
 import { runDownload } from "./commands/download";
 import { runGenerate } from "./commands/generate";
 
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
-    console.log(`
-Usage: encore-lib <command> [options]
-
-Commands:
-  download <appId> <pageId> <targetPath>   Download Encore page data
-  generate <appId> [pageId] <outputPath>   Generate React wrapper components
-`);
-    process.exit(0);
-  }
-
-  const command = args[0];
-  const commandArgs = args.slice(1);
-
-  switch (command) {
-    case "download":
-      await runDownload(commandArgs);
-      break;
-    case "generate":
-      await runGenerate(commandArgs);
-      break;
-    default:
-      console.error(`Unknown command: ${command}`);
-      process.exit(1);
-  }
-}
-
-main();
+const program = new Command();
+
+program
+  .name("encore-lib")
+  .description("Encore CLI tools")
+  // We'll read version from package.json in build or hardcode for now to avoid async import issues in simple CLI
+  .version("0.1.32");
+
+program
+  .command("download")
+  .description("Download Encore page data")
+  .argument("<appId>", "The Encore app ID")
+  .argument("<pageId>", "The Encore page ID")
+  .argument("<targetPath>", "Path where files should be saved")
+  .action(async (appId, pageId, targetPath) => {
+    await runDownload(appId, pageId, targetPath);
+  });
+
+program
+  .command("generate")
+  .description("Generate React wrapper components")
+  .argument("<appId>", "The Encore app ID")
+  .argument("[pageId]", "The Encore page ID (optional)")
+  .argument(
+    "[outputPath]",
+    "Path where the generated TSX file(s) should be saved"
+  )
+  .option(
+    "--mode <mode>",
+    "Deployment mode: dynamic (default), optimistic, or production"
+  )
+  .action(async (appId, pageId, outputPath, options) => {
+    // Handle overload: generate <appId> <outputPath> vs generate <appId> <pageId> <outputPath>
+    let finalPageId = pageId;
+    let finalOutputPath = outputPath;
+
+    // If only 2 arguments provided (appId and pageId/outputPath), the second one is outputPath
+    if (pageId && !outputPath) {
+      finalOutputPath = pageId;
+      finalPageId = undefined;
+    }
+
+    const mode = options.mode || "dynamic";
+
+    await runGenerate(appId, finalPageId, finalOutputPath, mode);
+  });
+
+program.parse();

package/src/codegen/generator.ts

@@ -67,7 +67,7 @@ export function generateComponentCode(
   forms: FormInfo[],
   selectInputs: SelectInputInfo[],
   actionButtons: ActionButtonInfo[],
-  isProduction: boolean = false,
+  mode: string = "dynamic",
   pageMeta?: {
     width?: number;
     height?: number;
@@ -448,6 +448,8 @@ ${inputGroupMapping.join("\n")}
   const propsParameter = hasProps ? `props: ${componentName}Props` : "";
   const propsInterfaceSection = propsInterface ? `${propsInterface}\n\n` : "";
 
+  const shouldBundleData = mode === "production" || mode === "optimistic";
+
   return `/**
  * ${componentName}
  * 
@@ -458,7 +460,7 @@ ${inputGroupMapping.join("\n")}
 import { EncoreApp${
     forms.length > 0 ? ", useEncoreState" : ""
   } } from "@bravostudioai/react";
-${isProduction ? `import productionData from "./data.json";` : ""}
+${shouldBundleData ? `import productionData from "./data.json";` : ""}
 
 ${itemTypes ? `${itemTypes}\n\n` : ""}${
     formDataTypes ? `${formDataTypes}\n\n` : ""
@@ -468,8 +470,9 @@ ${inputGroupHandlers.length > 0 ? inputGroupHandlers.join("\n") : ""}
     <EncoreApp
       appId="${appId}"
       pageId="${pageId}"
+      mode="${mode}"
       ${
-        isProduction
+        shouldBundleData
           ? `appDefinition={productionData.app}
       pageDefinition={productionData.page}
       componentCode={productionData.componentCode}`

package/src/components/DynamicComponent.tsx

@@ -3,7 +3,7 @@ import React, { useMemo, Suspense } from "react";
 
 type Props = {
   name: string;
-  children: unknown;
+  children?: React.ReactNode;
   componentId?: string;
   fallback?: React.ReactNode;
   reloadKey?: string | number;