@bravostudioai/react 0.1.31 → 0.1.34

package/dist/lib/fetcher.js

@@ -1,7 +1,8 @@
 import d from "axios";
 import { isLocalMode as u } from "./localMode.js";
 import h from "../stores/useEncoreState.js";
-const g = () => h.getState().baseURL, f = {}, v = (o) => {
+import { logger as g } from "./logger.js";
+const m = () => h.getState().baseURL, f = {}, S = (o) => {
   if (/\buseLocal=1\b/.test(o) || u()) {
     const c = o.split("?")[0], i = c.match(/^\/devices\/apps\/([^/]+)$/);
     if (i) {
@@ -42,22 +43,14 @@ const g = () => h.getState().baseURL, f = {}, v = (o) => {
   }
   if (f?.[o])
     return JSON.parse(f?.[o]);
-  const p = g();
-  return console.log(
-    "[Fetcher] Requesting:",
-    o,
-    "BaseURL:",
-    p,
-    "Headers:",
-    { "x-app-clientrendered": "disabled" }
-  ), d({
+  const p = m();
+  return g.debug("Fetching from Encore service", { url: o, baseURL: p }), d({
     baseURL: p,
     url: o
-    // headers: { "x-app-clientrendered": "true" },
   }).then((c) => c.data);
 };
 export {
-  g as appsServiceUrl,
-  v as default
+  m as appsServiceUrl,
+  S as default
 };
 //# sourceMappingURL=fetcher.js.map

package/dist/lib/fetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.js","sources":["../../src/lib/fetcher.ts"],"sourcesContent":["import axios from \"axios\";\nimport { isLocalMode } from \"./localMode\";\nimport useEncoreState from \"../stores/useEncoreState\";\n\n// Get baseURL from store at runtime instead of build time\nconst getAppsServiceUrl = () => {\n  return useEncoreState.getState().baseURL;\n};\n\nconst bundledResponses: Record<string, string> = {};\n\nconst fetcher = (url: string) => {\n  // Local mode: map Encore service URLs to files in /flex-layout\n  const forceLocal = /\\buseLocal=1\\b/.test(url);\n  if (forceLocal || isLocalMode()) {\n    const pathOnly = url.split(\"?\")[0];\n    const absBase = null;\n    // /devices/apps/:appId\n    const appMatch = pathOnly.match(/^\\/devices\\/apps\\/([^/]+)$/);\n    if (appMatch) {\n      const appId = appMatch[1];\n      const tryUrls = [\n        `/flex-layout/${appId}/${appId}.json`,\n        absBase ? `/@fs/${absBase}/${appId}/${appId}.json` : undefined,\n      ].filter(Boolean) as string[];\n      return (async () => {\n        for (const u of tryUrls) {\n          try {\n            const r = await fetch(u);\n            if (r.ok) return r.json();\n          } catch {\n            // try next\n          }\n        }\n        throw new Error(\n          `Local app.json not found for ${appId} (tried ${tryUrls.join(\", \")})`\n        );\n      })();\n    }\n    // /devices/apps/:appId/node/:pageId\n    const pageMatch = pathOnly.match(\n      /^\\/devices\\/apps\\/([^/]+)\\/node\\/([^/?#]+)$/\n    );\n    if (pageMatch) {\n      const appId = pageMatch[1];\n      const pageId = pageMatch[2];\n      // Try a dedicated page JSON first (if present)\n      const tryUrls = [\n        `/flex-layout/${appId}/${pageId}.json`,\n        absBase ? `/@fs/${absBase}/${appId}/${pageId}.json` : undefined,\n      ].filter(Boolean) as string[];\n      return fetch(tryUrls[0])\n        .then(async (r) => {\n          if (r.ok) return r.json();\n          // try secondary url if defined\n          if (tryUrls[1]) {\n            const r2 = await fetch(tryUrls[1]).catch(() => null);\n            if (r2 && r2.ok) return r2.json();\n          }\n          // Fallback: derive minimal shape from app.json\n          const appJson =\n            (await fetch(`/flex-layout/${appId}/${appId}.json`)\n              .then((a) => (a.ok ? a.json() : null))\n              .catch(() => null)) ||\n            (absBase\n              ? await fetch(`/@fs/${absBase}/${appId}/${appId}.json`)\n                  .then((a) => (a.ok ? a.json() : null))\n                  .catch(() => null)\n              : null);\n          // Keep shape compatible with current consumers\n          const pages = appJson?.app?.data?.pages || appJson?.data?.pages || [];\n          const page = pages.find((p: any) => p?.id === pageId) || {};\n          return { clientData: page };\n        })\n        .catch(async () => {\n          // Final fallback: minimal object\n          return { clientData: null };\n        });\n    }\n  }\n\n  if (bundledResponses?.[url]) {\n    return JSON.parse(bundledResponses?.[url]);\n  }\n\n  // Get baseURL at runtime from store\n  const appsServiceUrl = getAppsServiceUrl();\n\n  console.log(\n    \"[Fetcher] Requesting:\",\n    url,\n    \"BaseURL:\",\n    appsServiceUrl,\n    \"Headers:\",\n    { \"x-app-clientrendered\": \"disabled\" }\n  );\n\n  return axios({\n    baseURL: appsServiceUrl,\n    url,\n    // headers: { \"x-app-clientrendered\": \"true\" },\n  }).then((res) => res.data);\n};\n\nexport default fetcher;\nexport { getAppsServiceUrl as appsServiceUrl };\n"],"names":["getAppsServiceUrl","useEncoreState","bundledResponses","fetcher","url","isLocalMode","pathOnly","appMatch","appId","tryUrls","u","r","pageMatch","pageId","r2","appJson","a","p","appsServiceUrl","axios","res"],"mappings":";;;AAKA,MAAMA,IAAoB,MACjBC,EAAe,WAAW,SAG7BC,IAA2C,CAAA,GAE3CC,IAAU,CAACC,MAAgB;AAG/B,MADmB,iBAAiB,KAAKA,CAAG,KAC1BC,KAAe;AAC/B,UAAMC,IAAWF,EAAI,MAAM,GAAG,EAAE,CAAC,GAG3BG,IAAWD,EAAS,MAAM,4BAA4B;AAC5D,QAAIC,GAAU;AACZ,YAAMC,IAAQD,EAAS,CAAC,GAClBE,IAAU;AAAA,QACd,gBAAgBD,CAAK,IAAIA,CAAK;AAAA,QACuB;AAAA,MAAA,EACrD,OAAO,OAAO;AAChB,cAAQ,YAAY;AAClB,mBAAWE,KAAKD;AACd,cAAI;AACF,kBAAME,IAAI,MAAM,MAAMD,CAAC;AACvB,gBAAIC,EAAE,GAAI,QAAOA,EAAE,KAAA;AAAA,UACrB,QAAQ;AAAA,UAER;AAEF,cAAM,IAAI;AAAA,UACR,gCAAgCH,CAAK,WAAWC,EAAQ,KAAK,IAAI,CAAC;AAAA,QAAA;AAAA,MAEtE,GAAA;AAAA,IACF;AAEA,UAAMG,IAAYN,EAAS;AAAA,MACzB;AAAA,IAAA;AAEF,QAAIM,GAAW;AACb,YAAMJ,IAAQI,EAAU,CAAC,GACnBC,IAASD,EAAU,CAAC,GAEpBH,IAAU;AAAA,QACd,gBAAgBD,CAAK,IAAIK,CAAM;AAAA,QACuB;AAAA,MAAA,EACtD,OAAO,OAAO;AAChB,aAAO,MAAMJ,EAAQ,CAAC,CAAC,EACpB,KAAK,OAAOE,MAAM;AACjB,YAAIA,EAAE,GAAI,QAAOA,EAAE,KAAA;AAEnB,YAAIF,EAAQ,CAAC,GAAG;AACd,gBAAMK,IAAK,MAAM,MAAML,EAAQ,CAAC,CAAC,EAAE,MAAM,MAAM,IAAI;AACnD,cAAIK,KAAMA,EAAG,GAAI,QAAOA,EAAG,KAAA;AAAA,QAC7B;AAEA,cAAMC,IACH,MAAM,MAAM,gBAAgBP,CAAK,IAAIA,CAAK,OAAO,EAC/C,KAAK,CAACQ,MAAOA,EAAE,KAAKA,EAAE,KAAA,IAAS,IAAK,EACpC,MAAM,MAAM,IAAI,KAKf;AAIN,eAAO,EAAE,aAFKD,GAAS,KAAK,MAAM,SAASA,GAAS,MAAM,SAAS,CAAA,GAChD,KAAK,CAACE,MAAWA,GAAG,OAAOJ,CAAM,KAAK,CAAA,EACpC;AAAA,MACvB,CAAC,EACA,MAAM,aAEE,EAAE,YAAY,KAAA,EACtB;AAAA,IACL;AAAA,EACF;AAEA,MAAIX,IAAmBE,CAAG;AACxB,WAAO,KAAK,MAAMF,IAAmBE,CAAG,CAAC;AAI3C,QAAMc,IAAiBlB,EAAA;AAEvB,iBAAQ;AAAA,IACN;AAAA,IACAI;AAAA,IACA;AAAA,IACAc;AAAA,IACA;AAAA,IACA,EAAE,wBAAwB,WAAA;AAAA,EAAW,GAGhCC,EAAM;AAAA,IACX,SAASD;AAAA,IACT,KAAAd;AAAA;AAAA,EAAA,CAED,EAAE,KAAK,CAACgB,MAAQA,EAAI,IAAI;AAC3B;"}
+{"version":3,"file":"fetcher.js","sources":["../../src/lib/fetcher.ts"],"sourcesContent":["import axios from \"axios\";\nimport { isLocalMode } from \"./localMode\";\nimport useEncoreState from \"../stores/useEncoreState\";\nimport logger from \"./logger\";\n\n// Get baseURL from store at runtime instead of build time\nconst getAppsServiceUrl = () => {\n  return useEncoreState.getState().baseURL;\n};\n\nconst bundledResponses: Record<string, string> = {};\n\nconst fetcher = (url: string) => {\n  // Local mode: map Encore service URLs to files in /flex-layout\n  const forceLocal = /\\buseLocal=1\\b/.test(url);\n  if (forceLocal || isLocalMode()) {\n    const pathOnly = url.split(\"?\")[0];\n    const absBase = null;\n    // /devices/apps/:appId\n    const appMatch = pathOnly.match(/^\\/devices\\/apps\\/([^/]+)$/);\n    if (appMatch) {\n      const appId = appMatch[1];\n      const tryUrls = [\n        `/flex-layout/${appId}/${appId}.json`,\n        absBase ? `/@fs/${absBase}/${appId}/${appId}.json` : undefined,\n      ].filter(Boolean) as string[];\n      return (async () => {\n        for (const u of tryUrls) {\n          try {\n            const r = await fetch(u);\n            if (r.ok) return r.json();\n          } catch {\n            // try next\n          }\n        }\n        throw new Error(\n          `Local app.json not found for ${appId} (tried ${tryUrls.join(\", \")})`\n        );\n      })();\n    }\n    // /devices/apps/:appId/node/:pageId\n    const pageMatch = pathOnly.match(\n      /^\\/devices\\/apps\\/([^/]+)\\/node\\/([^/?#]+)$/\n    );\n    if (pageMatch) {\n      const appId = pageMatch[1];\n      const pageId = pageMatch[2];\n      // Try a dedicated page JSON first (if present)\n      const tryUrls = [\n        `/flex-layout/${appId}/${pageId}.json`,\n        absBase ? `/@fs/${absBase}/${appId}/${pageId}.json` : undefined,\n      ].filter(Boolean) as string[];\n      return fetch(tryUrls[0])\n        .then(async (r) => {\n          if (r.ok) return r.json();\n          // try secondary url if defined\n          if (tryUrls[1]) {\n            const r2 = await fetch(tryUrls[1]).catch(() => null);\n            if (r2 && r2.ok) return r2.json();\n          }\n          // Fallback: derive minimal shape from app.json\n          const appJson =\n            (await fetch(`/flex-layout/${appId}/${appId}.json`)\n              .then((a) => (a.ok ? a.json() : null))\n              .catch(() => null)) ||\n            (absBase\n              ? await fetch(`/@fs/${absBase}/${appId}/${appId}.json`)\n                  .then((a) => (a.ok ? a.json() : null))\n                  .catch(() => null)\n              : null);\n          // Keep shape compatible with current consumers\n          const pages = appJson?.app?.data?.pages || appJson?.data?.pages || [];\n          const page = pages.find((p: any) => p?.id === pageId) || {};\n          return { clientData: page };\n        })\n        .catch(async () => {\n          // Final fallback: minimal object\n          return { clientData: null };\n        });\n    }\n  }\n\n  if (bundledResponses?.[url]) {\n    return JSON.parse(bundledResponses?.[url]);\n  }\n\n  // Get baseURL at runtime from store\n  const appsServiceUrl = getAppsServiceUrl();\n\n  logger.debug('Fetching from Encore service', { url, baseURL: appsServiceUrl });\n\n  return axios({\n    baseURL: appsServiceUrl,\n    url,\n  }).then((res) => res.data);\n};\n\nexport default fetcher;\nexport { getAppsServiceUrl as appsServiceUrl };\n"],"names":["getAppsServiceUrl","useEncoreState","bundledResponses","fetcher","url","isLocalMode","pathOnly","appMatch","appId","tryUrls","u","r","pageMatch","pageId","r2","appJson","a","p","appsServiceUrl","logger","axios","res"],"mappings":";;;;AAMA,MAAMA,IAAoB,MACjBC,EAAe,WAAW,SAG7BC,IAA2C,CAAA,GAE3CC,IAAU,CAACC,MAAgB;AAG/B,MADmB,iBAAiB,KAAKA,CAAG,KAC1BC,KAAe;AAC/B,UAAMC,IAAWF,EAAI,MAAM,GAAG,EAAE,CAAC,GAG3BG,IAAWD,EAAS,MAAM,4BAA4B;AAC5D,QAAIC,GAAU;AACZ,YAAMC,IAAQD,EAAS,CAAC,GAClBE,IAAU;AAAA,QACd,gBAAgBD,CAAK,IAAIA,CAAK;AAAA,QACuB;AAAA,MAAA,EACrD,OAAO,OAAO;AAChB,cAAQ,YAAY;AAClB,mBAAWE,KAAKD;AACd,cAAI;AACF,kBAAME,IAAI,MAAM,MAAMD,CAAC;AACvB,gBAAIC,EAAE,GAAI,QAAOA,EAAE,KAAA;AAAA,UACrB,QAAQ;AAAA,UAER;AAEF,cAAM,IAAI;AAAA,UACR,gCAAgCH,CAAK,WAAWC,EAAQ,KAAK,IAAI,CAAC;AAAA,QAAA;AAAA,MAEtE,GAAA;AAAA,IACF;AAEA,UAAMG,IAAYN,EAAS;AAAA,MACzB;AAAA,IAAA;AAEF,QAAIM,GAAW;AACb,YAAMJ,IAAQI,EAAU,CAAC,GACnBC,IAASD,EAAU,CAAC,GAEpBH,IAAU;AAAA,QACd,gBAAgBD,CAAK,IAAIK,CAAM;AAAA,QACuB;AAAA,MAAA,EACtD,OAAO,OAAO;AAChB,aAAO,MAAMJ,EAAQ,CAAC,CAAC,EACpB,KAAK,OAAOE,MAAM;AACjB,YAAIA,EAAE,GAAI,QAAOA,EAAE,KAAA;AAEnB,YAAIF,EAAQ,CAAC,GAAG;AACd,gBAAMK,IAAK,MAAM,MAAML,EAAQ,CAAC,CAAC,EAAE,MAAM,MAAM,IAAI;AACnD,cAAIK,KAAMA,EAAG,GAAI,QAAOA,EAAG,KAAA;AAAA,QAC7B;AAEA,cAAMC,IACH,MAAM,MAAM,gBAAgBP,CAAK,IAAIA,CAAK,OAAO,EAC/C,KAAK,CAACQ,MAAOA,EAAE,KAAKA,EAAE,KAAA,IAAS,IAAK,EACpC,MAAM,MAAM,IAAI,KAKf;AAIN,eAAO,EAAE,aAFKD,GAAS,KAAK,MAAM,SAASA,GAAS,MAAM,SAAS,CAAA,GAChD,KAAK,CAACE,MAAWA,GAAG,OAAOJ,CAAM,KAAK,CAAA,EACpC;AAAA,MACvB,CAAC,EACA,MAAM,aAEE,EAAE,YAAY,KAAA,EACtB;AAAA,IACL;AAAA,EACF;AAEA,MAAIX,IAAmBE,CAAG;AACxB,WAAO,KAAK,MAAMF,IAAmBE,CAAG,CAAC;AAI3C,QAAMc,IAAiBlB,EAAA;AAEvB,SAAAmB,EAAO,MAAM,gCAAgC,EAAE,KAAAf,GAAK,SAASc,GAAgB,GAEtEE,EAAM;AAAA,IACX,SAASF;AAAA,IACT,KAAAd;AAAA,EAAA,CACD,EAAE,KAAK,CAACiB,MAAQA,EAAI,IAAI;AAC3B;"}

package/dist/lib/logger.js

@@ -0,0 +1,35 @@
+const o = typeof import.meta < "u" ? !1 : process.env.NODE_ENV === "development", n = {
+  /**
+   * Debug-level logging (only in development)
+   * Use for detailed diagnostic information
+   */
+  debug: (...e) => {
+    o && console.debug("[encore-lib]", ...e);
+  },
+  /**
+   * Info-level logging (only in development)
+   * Use for general informational messages
+   */
+  info: (...e) => {
+    o && console.info("[encore-lib]", ...e);
+  },
+  /**
+   * Warning-level logging (always shown)
+   * Use for recoverable issues that need attention
+   */
+  warn: (...e) => {
+    console.warn("[encore-lib]", ...e);
+  },
+  /**
+   * Error-level logging (always shown)
+   * Use for errors and exceptions
+   */
+  error: (...e) => {
+    console.error("[encore-lib]", ...e);
+  }
+};
+export {
+  n as default,
+  n as logger
+};
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../src/lib/logger.ts"],"sourcesContent":["/**\n * Centralized logging utility for encore-lib\n *\n * Provides conditional logging based on environment.\n * Debug logs only appear in development mode.\n */\n\nconst isDev = typeof import.meta !== 'undefined'\n  ? import.meta.env?.DEV || import.meta.env?.MODE === 'development'\n  : process.env.NODE_ENV === 'development';\n\n/**\n * Logger instance with environment-aware methods\n */\nexport const logger = {\n  /**\n   * Debug-level logging (only in development)\n   * Use for detailed diagnostic information\n   */\n  debug: (...args: any[]) => {\n    if (isDev) {\n      console.debug('[encore-lib]', ...args);\n    }\n  },\n\n  /**\n   * Info-level logging (only in development)\n   * Use for general informational messages\n   */\n  info: (...args: any[]) => {\n    if (isDev) {\n      console.info('[encore-lib]', ...args);\n    }\n  },\n\n  /**\n   * Warning-level logging (always shown)\n   * Use for recoverable issues that need attention\n   */\n  warn: (...args: any[]) => {\n    console.warn('[encore-lib]', ...args);\n  },\n\n  /**\n   * Error-level logging (always shown)\n   * Use for errors and exceptions\n   */\n  error: (...args: any[]) => {\n    console.error('[encore-lib]', ...args);\n  },\n};\n\nexport default logger;\n"],"names":["isDev","logger","args"],"mappings":"AAOA,MAAMA,IAAQ,OAAO,cAAgB,MACT,KACxB,QAAQ,IAAI,aAAa,eAKhBC,IAAS;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,OAAO,IAAIC,MAAgB;AACzB,IAAIF,KACF,QAAQ,MAAM,gBAAgB,GAAGE,CAAI;AAAA,EAEzC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAIA,MAAgB;AACxB,IAAIF,KACF,QAAQ,KAAK,gBAAgB,GAAGE,CAAI;AAAA,EAExC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAIA,MAAgB;AACxB,YAAQ,KAAK,gBAAgB,GAAGA,CAAI;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,IAAIA,MAAgB;AACzB,YAAQ,MAAM,gBAAgB,GAAGA,CAAI;AAAA,EACvC;AACF;"}

package/dist/lib/moduleRegistry.js

@@ -1,20 +1,21 @@
+import { logger as t } from "./logger.js";
 const o = {};
-function r(e, t) {
-  o[e] = t;
+function n(e, r) {
+  o[e] = r;
 }
-function n(e) {
+function c(e) {
   return o[e]().exports;
 }
-function u(e) {
+function i(e) {
   return e in o;
 }
 function l(e) {
-  e in o && (delete o[e], console.log(`[Module Cache] Cleared module: ${e}`));
+  e in o && (delete o[e], t.debug("Module cache cleared", { name: e }));
 }
 export {
   l as clearModuleCache,
-  n as getModuleExports,
-  u as haveModule,
-  r as registerModule
+  c as getModuleExports,
+  i as haveModule,
+  n as registerModule
 };
 //# sourceMappingURL=moduleRegistry.js.map

package/dist/lib/moduleRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"moduleRegistry.js","sources":["../../src/lib/moduleRegistry.ts"],"sourcesContent":["const registry: Record<string, any> = {};\n\nexport function registerModule(name: string, module: any) {\n  registry[name] = module;\n}\n\nexport function getModuleExports(name: string) {\n  return registry[name]().exports;\n}\n\nexport function haveModule(name: string): boolean {\n  return name in registry;\n}\n\n/**\n * Clear a module from the cache to force reload on next fetch\n * @param name Module name (e.g., `${appId}/draft/components/${pageId}`)\n */\nexport function clearModuleCache(name: string): void {\n  if (name in registry) {\n    delete registry[name];\n    console.log(`[Module Cache] Cleared module: ${name}`);\n  }\n}\n"],"names":["registry","registerModule","name","module","getModuleExports","haveModule","clearModuleCache"],"mappings":"AAAA,MAAMA,IAAgC,CAAA;AAE/B,SAASC,EAAeC,GAAcC,GAAa;AACxD,EAAAH,EAASE,CAAI,IAAIC;AACnB;AAEO,SAASC,EAAiBF,GAAc;AAC7C,SAAOF,EAASE,CAAI,EAAA,EAAI;AAC1B;AAEO,SAASG,EAAWH,GAAuB;AAChD,SAAOA,KAAQF;AACjB;AAMO,SAASM,EAAiBJ,GAAoB;AACnD,EAAIA,KAAQF,MACV,OAAOA,EAASE,CAAI,GACpB,QAAQ,IAAI,kCAAkCA,CAAI,EAAE;AAExD;"}
+{"version":3,"file":"moduleRegistry.js","sources":["../../src/lib/moduleRegistry.ts"],"sourcesContent":["import logger from \"./logger\";\n\nconst registry: Record<string, any> = {};\n\nexport function registerModule(name: string, module: any) {\n  registry[name] = module;\n}\n\nexport function getModuleExports(name: string) {\n  return registry[name]().exports;\n}\n\nexport function haveModule(name: string): boolean {\n  return name in registry;\n}\n\n/**\n * Clear a module from the cache to force reload on next fetch\n * @param name Module name (e.g., `${appId}/draft/components/${pageId}`)\n */\nexport function clearModuleCache(name: string): void {\n  if (name in registry) {\n    delete registry[name];\n    logger.debug('Module cache cleared', { name });\n  }\n}\n"],"names":["registry","registerModule","name","module","getModuleExports","haveModule","clearModuleCache","logger"],"mappings":";AAEA,MAAMA,IAAgC,CAAA;AAE/B,SAASC,EAAeC,GAAcC,GAAa;AACxD,EAAAH,EAASE,CAAI,IAAIC;AACnB;AAEO,SAASC,EAAiBF,GAAc;AAC7C,SAAOF,EAASE,CAAI,EAAA,EAAI;AAC1B;AAEO,SAASG,EAAWH,GAAuB;AAChD,SAAOA,KAAQF;AACjB;AAMO,SAASM,EAAiBJ,GAAoB;AACnD,EAAIA,KAAQF,MACV,OAAOA,EAASE,CAAI,GACpBK,EAAO,MAAM,wBAAwB,EAAE,MAAAL,EAAA,CAAM;AAEjD;"}

package/dist/src/cli/commands/download.d.ts

@@ -1,2 +1,2 @@
-export declare function runDownload(args: string[]): Promise<void>;
+export declare function runDownload(appId: string, pageId: string, targetPath: string): Promise<void>;
 //# sourceMappingURL=download.d.ts.map

package/dist/src/cli/commands/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/download.ts"],"names":[],"mappings":"AA4GA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,iBAoB/C"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/download.ts"],"names":[],"mappings":"AA0FA,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,iBAenB"}

package/dist/src/cli/commands/generate.d.ts

@@ -1,2 +1,2 @@
-export declare function runGenerate(args: string[]): Promise<void>;
+export declare function runGenerate(appId: string, pageId: string | undefined, outputPath: string | undefined, mode: string): Promise<void>;
 //# sourceMappingURL=generate.d.ts.map

package/dist/src/cli/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AA4XA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,iBA2D/C"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AA8WA,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,IAAI,EAAE,MAAM,iBAyEb"}

package/dist/src/codegen/generator.d.ts

@@ -1,14 +1,88 @@
 import { ComponentInfo, SliderInfo, InputGroupInfo, FormInfo, SelectInputInfo, ActionButtonInfo } from "./types";
+/**
+ * Metadata extracted from generated component
+ */
 export interface ComponentMetadata {
+    /** List of prop names */
     props: string[];
+    /** List of event handler names */
     events: string[];
+    /** Example JSX usage string */
     jsx: string;
 }
-export declare function generateComponentCode(appId: string, pageId: string, componentName: string, sliders: SliderInfo[], standaloneComponents: ComponentInfo[], inputGroups: InputGroupInfo[], forms: FormInfo[], selectInputs: SelectInputInfo[], actionButtons: ActionButtonInfo[], isProduction?: boolean, pageMeta?: {
+/**
+ * Generates React component wrapper code for an Encore page
+ *
+ * Creates a TypeScript React component that wraps EncoreApp with typed props
+ * for all data-bound components, sliders, forms, and interactive elements.
+ *
+ * @param appId - Encore app ID
+ * @param pageId - Encore page ID
+ * @param componentName - Name for the generated component
+ * @param sliders - Slider/list metadata from parser
+ * @param standaloneComponents - Standalone component metadata
+ * @param inputGroups - Input group metadata
+ * @param forms - Form metadata
+ * @param selectInputs - Select input metadata
+ * @param actionButtons - Action button metadata
+ * @param isProduction - Whether to include bundled data for production
+ * @param pageMeta - Optional page dimensions and aspect ratio
+ * @returns TypeScript component source code
+ *
+ * @example
+ * const code = generateComponentCode(
+ *   "01ABC123",
+ *   "01DEF456",
+ *   "MyPage",
+ *   sliders,
+ *   components,
+ *   inputGroups,
+ *   forms,
+ *   selectInputs,
+ *   actionButtons
+ * );
+ * fs.writeFileSync("MyPage.tsx", code);
+ */
+export declare function generateComponentCode(appId: string, pageId: string, componentName: string, sliders: SliderInfo[], standaloneComponents: ComponentInfo[], inputGroups: InputGroupInfo[], forms: FormInfo[], selectInputs: SelectInputInfo[], actionButtons: ActionButtonInfo[], mode?: string, pageMeta?: {
     width?: number;
     height?: number;
     aspectRatio?: number;
 }): string;
+/**
+ * Generates README documentation for a generated component
+ *
+ * Creates comprehensive Markdown documentation explaining all props,
+ * events, and usage examples for the generated wrapper component.
+ *
+ * @param appId - Encore app ID
+ * @param pageId - Encore page ID
+ * @param appName - Human-readable app name
+ * @param pageName - Human-readable page name
+ * @param componentName - Generated component name
+ * @param sliders - Slider/list metadata
+ * @param standaloneComponents - Component metadata
+ * @param inputGroups - Input group metadata
+ * @param forms - Form metadata
+ * @param selectInputs - Select input metadata
+ * @param actionButtons - Action button metadata
+ * @returns Markdown documentation string
+ */
 export declare function generateReadme(appId: string, pageId: string, appName: string, pageName: string, componentName: string, sliders: SliderInfo[], standaloneComponents: ComponentInfo[], inputGroups: InputGroupInfo[], forms: FormInfo[], selectInputs: SelectInputInfo[], actionButtons: ActionButtonInfo[]): string;
+/**
+ * Extracts component metadata for programmatic use
+ *
+ * Generates a simplified metadata object listing all props and events
+ * without the full code generation.
+ *
+ * @param _appName - App name (currently unused)
+ * @param pageName - Page name for component naming
+ * @param sliders - Slider metadata
+ * @param standaloneComponents - Component metadata
+ * @param inputGroups - Input group metadata
+ * @param forms - Form metadata
+ * @param selectInputs - Select input metadata
+ * @param actionButtons - Action button metadata
+ * @returns Component metadata object
+ */
 export declare function generateComponentMetadata(_appName: string, pageName: string, sliders: SliderInfo[], standaloneComponents: ComponentInfo[], inputGroups: InputGroupInfo[], forms: FormInfo[], selectInputs: SelectInputInfo[], actionButtons: ActionButtonInfo[]): ComponentMetadata;
 //# sourceMappingURL=generator.d.ts.map

package/dist/src/codegen/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAOjB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,oBAAoB,EAAE,aAAa,EAAE,EACrC,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,EAC/B,aAAa,EAAE,gBAAgB,EAAE,EACjC,YAAY,GAAE,OAAe,EAC7B,QAAQ,CAAC,EAAE;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,MAAM,CAiaR;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,oBAAoB,EAAE,aAAa,EAAE,EACrC,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,EAC/B,aAAa,EAAE,gBAAgB,EAAE,GAChC,MAAM,CAwVR;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EAAE,EACrB,oBAAoB,EAAE,aAAa,EAAE,EACrC,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,EAC/B,aAAa,EAAE,gBAAgB,EAAE,GAChC,iBAAiB,CAiEnB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAOjB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,oBAAoB,EAAE,aAAa,EAAE,EACrC,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,EAC/B,aAAa,EAAE,gBAAgB,EAAE,EACjC,IAAI,GAAE,MAAkB,EACxB,QAAQ,CAAC,EAAE;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,MAAM,CAoaR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,oBAAoB,EAAE,aAAa,EAAE,EACrC,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,EAC/B,aAAa,EAAE,gBAAgB,EAAE,GAChC,MAAM,CAwVR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EAAE,EACrB,oBAAoB,EAAE,aAAa,EAAE,EACrC,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,EAC/B,aAAa,EAAE,gBAAgB,EAAE,GAChC,iBAAiB,CAiEnB"}

package/dist/src/codegen/parser.d.ts

@@ -1,4 +1,16 @@
 import { ComponentInfo, SliderInfo, InputGroupInfo, FormInfo, SelectInputInfo, ActionButtonInfo } from "./types";
+/**
+ * Sanitizes a component name into a valid camelCase prop name
+ *
+ * Removes special characters, handles spaces, and converts to camelCase.
+ *
+ * @param name - Raw component name from Figma/design tool
+ * @returns Valid JavaScript property name
+ *
+ * @example
+ * sanitizePropName("My Component!") // "myComponent"
+ * sanitizePropName("user-name") // "userName"
+ */
 export declare function sanitizePropName(name: string): string;
 export declare function generateQualifiedPropName(componentName: string, parentPath: string[]): string;
 /**
@@ -16,8 +28,35 @@ export declare function arraysEqual(a: string[], b: string[]): boolean;
 export declare function getComponentPropType(componentType: string, _componentName: string): string;
 export declare function getComponentPropName(componentType: string): string;
 export declare function findSlidersAndDataBindings(pageData: any): SliderInfo[];
+/**
+ * Finds standalone data-bound components (not in sliders)
+ *
+ * Locates components tagged with encore:data (but not encore:data:array)
+ * for standalone data binding at the page level.
+ *
+ * @param pageData - Page definition from Encore service
+ * @returns Array of component metadata
+ */
 export declare function findStandaloneComponents(pageData: any): ComponentInfo[];
+/**
+ * Finds input groups (radio button-like components) in the page
+ *
+ * Locates stateful sets tagged with encore:input-group for coordinated
+ * selection behavior.
+ *
+ * @param pageData - Page definition from Encore service
+ * @returns Array of input group metadata
+ */
 export declare function findInputGroups(pageData: any): InputGroupInfo[];
+/**
+ * Finds forms and their input fields in the page
+ *
+ * Locates containers tagged with encore:form and extracts all input
+ * components within them for form submission handling.
+ *
+ * @param pageData - Page definition from Encore service
+ * @returns Array of form metadata with input fields
+ */
 export declare function findForms(pageData: any): FormInfo[];
 /**
  * Finds standalone select input components (input-select) that are NOT inside forms.

package/dist/src/codegen/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/codegen/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BrD;AAED,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CA8BR;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAAE,EAAE,GACrB,MAAM,EAAE,CA6DV;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAG7D;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,CAgBR;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,GAAG,GAAG,UAAU,EAAE,CAubtE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,GAAG,aAAa,EAAE,CA4SvE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,cAAc,EAAE,CA0D/D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,EAAE,CAkJnD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,GAAG,EACb,KAAK,EAAE,QAAQ,EAAE,GAChB,eAAe,EAAE,CAqEnB;AAkDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,EAAE,CAgFnE;AAoDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAoNzD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/codegen/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BrD;AAED,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CA8BR;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAAE,EAAE,GACrB,MAAM,EAAE,CA6DV;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAG7D;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,CAgBR;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,GAAG,GAAG,UAAU,EAAE,CAoOtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,GAAG,aAAa,EAAE,CAuGvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,cAAc,EAAE,CA0D/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,EAAE,CAkJnD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,GAAG,EACb,KAAK,EAAE,QAAQ,EAAE,GAChB,eAAe,EAAE,CAqEnB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,EAAE,CAgFnE;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAIzD"}

package/dist/src/codegen/propQualification.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Reusable prop name qualification utilities
+ *
+ * When multiple components/inputs have the same base prop name,
+ * this module provides utilities to make each name unique by using
+ * minimal distinguishing parent paths.
+ */
+/**
+ * Base interface for items that can have their prop names qualified
+ */
+export interface QualifiableItem {
+    id: string;
+    name: string;
+    propName: string;
+    _parentPath?: string[];
+}
+/**
+ * Qualifies duplicate prop names using minimal distinguishing paths.
+ *
+ * When multiple components have the same prop name, this function
+ * finds the shortest parent path segment that makes each name unique.
+ *
+ * Algorithm:
+ * 1. Group items by base prop name
+ * 2. For each group with duplicates:
+ *    a. Find minimal distinguishing paths
+ *    b. Iteratively expand paths if duplicates remain
+ *    c. Apply numeric suffixes if paths are identical
+ *
+ * @param items - Components/inputs to qualify (will be modified in place)
+ * @returns The same items array with qualified propName values
+ *
+ * @example
+ * const items = [
+ *   { id: '1', name: 'Title', propName: 'title', _parentPath: ['Header'] },
+ *   { id: '2', name: 'Title', propName: 'title', _parentPath: ['Footer'] }
+ * ];
+ * qualifyPropNames(items);
+ * // Result: items[0].propName = 'headerTitle', items[1].propName = 'footerTitle'
+ */
+export declare function qualifyPropNames<T extends QualifiableItem>(items: T[]): T[];
+//# sourceMappingURL=propQualification.d.ts.map

package/dist/src/codegen/propQualification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propQualification.d.ts","sourceRoot":"","sources":["../../../src/codegen/propQualification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAqOD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,eAAe,EACxD,KAAK,EAAE,CAAC,EAAE,GACT,CAAC,EAAE,CAUL"}

package/dist/src/components/DynamicComponent.d.ts

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

package/dist/src/components/DynamicComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicComponent.d.ts","sourceRoot":"","sources":["../../../src/components/DynamicComponent.tsx"],"names":[],"mappings":"AACA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;;AA8BF,wBAA4C"}
+{"version":3,"file":"DynamicComponent.d.ts","sourceRoot":"","sources":["../../../src/components/DynamicComponent.tsx"],"names":[],"mappings":"AACA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;;AA8BF,wBAA4C"}

package/dist/src/components/EncoreApp.d.ts

@@ -1,31 +1,86 @@
 import React from "react";
-import { type EncoreActionPayload } from "../contexts/EncoreActionContext";
-type Props = {
+import type { EncoreActionPayload } from "../contexts/EncoreActionContext";
+/**
+ * Props for the EncoreApp component
+ */
+export type EncoreAppProps = {
+    /** Unique identifier for the Encore app */
     appId: string;
+    /** Unique identifier for the page to render. If not provided, shows page selector UI */
     pageId?: string;
+    /** Optional component identifier for context tracking */
     componentId?: string;
+    /** Fallback UI to show during component loading */
     fallback?: React.ReactNode;
+    /** Callback fired when the container size changes */
     onSizeChange?: (size: {
         width: number;
         height: number;
     }) => void;
+    /** Callback fired when the content size changes (including overflow) */
     onContentSizeChange?: (size: {
         width: number;
         height: number;
     }) => void;
+    /** Callback fired when user interactions trigger actions (button clicks, form submissions, etc.) */
     onAction?: (payload: EncoreActionPayload) => void | Promise<void>;
+    /** Data bindings for components with encore:data tags. Maps component IDs to display values */
     data?: Record<string, string | number | any[]>;
+    /** Force component loading from "remote" CDN or "local" filesystem */
     source?: "remote" | "local";
+    /** Control repeating containers (sliders, lists) programmatically by container ID */
     repeatingContainerControls?: Record<string, {
         currentIndex?: number;
         onIndexChange?: (index: number) => void;
     }>;
+    /** Control input groups (radio button-like behavior). Maps group name to active element */
     inputGroups?: Record<string, string>;
+    /** Base URL for the Encore service API */
     baseURL?: string;
+    /** Provide app definition directly instead of fetching (for offline/bundled deployments) */
     appDefinition?: any;
+    /** Provide page definition directly instead of fetching (for offline/bundled deployments) */
     pageDefinition?: any;
+    /** Provide component code directly instead of fetching (for offline/bundled deployments) */
     componentCode?: string;
+    /** Deployment mode: dynamic (default), optimistic, or production */
+    mode?: "dynamic" | "optimistic" | "production";
 };
-declare const EncoreApp: ({ appId, pageId, componentId, fallback, onSizeChange, onContentSizeChange, onAction, data, source, repeatingContainerControls, inputGroups, baseURL, appDefinition, pageDefinition, componentCode, }: Props) => import("react/jsx-runtime").JSX.Element;
+type Props = EncoreAppProps;
+/**
+ * Main Encore runtime component
+ *
+ * Loads and renders Encore Studio apps dynamically from the Encore service.
+ * Handles data fetching, font loading, real-time updates, and component rendering.
+ *
+ * @example
+ * // Basic usage
+ * <EncoreApp appId="01ABC123" pageId="01DEF456" />
+ *
+ * @example
+ * // With data binding
+ * <EncoreApp
+ *   appId="01ABC123"
+ *   pageId="01DEF456"
+ *   data={{
+ *     "title-component": { text: "Hello World" }
+ *   }}
+ * />
+ *
+ * @example
+ * // Controlling a slider
+ * const [slideIndex, setSlideIndex] = useState(0);
+ * <EncoreApp
+ *   appId="01ABC123"
+ *   pageId="01DEF456"
+ *   repeatingContainerControls={{
+ *     "slider-123": {
+ *       currentIndex: slideIndex,
+ *       onIndexChange: setSlideIndex
+ *     }
+ *   }}
+ * />
+ */
+declare const EncoreApp: ({ appId, pageId, componentId, fallback, onSizeChange, onContentSizeChange, onAction, data, source, repeatingContainerControls, inputGroups, baseURL, appDefinition, pageDefinition, componentCode, mode, }: Props) => import("react/jsx-runtime").JSX.Element;
 export default EncoreApp;
 //# sourceMappingURL=EncoreApp.d.ts.map

package/dist/src/components/EncoreApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EncoreApp.d.ts","sourceRoot":"","sources":["../../../src/components/EncoreApp.tsx"],"names":[],"mappings":"AAIA,OAAO,KAON,MAAM,OAAO,CAAC;AAIf,OAA4B,EAC1B,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AA2BzC,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;IAE/C,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAE5B,0BAA0B,CAAC,EAAE,MAAM,CACjC,MAAM,EACN;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CACnE,CAAC;IAEF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAeF,QAAA,MAAM,SAAS,GAAI,sMAgBhB,KAAK,4CA8vBP,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"EncoreApp.d.ts","sourceRoot":"","sources":["../../../src/components/EncoreApp.tsx"],"names":[],"mappings":"AAIA,OAAO,KAON,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AA4B3E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qDAAqD;IACrD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,oGAAoG;IACpG,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;IAC/C,sEAAsE;IACtE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,qFAAqF;IACrF,0BAA0B,CAAC,EAAE,MAAM,CACjC,MAAM,EACN;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CACnE,CAAC;IACF,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,6FAA6F;IAC7F,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;CAChD,CAAC;AAEF,KAAK,KAAK,GAAG,cAAc,CAAC;AAe5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,SAAS,GAAI,4MAiBhB,KAAK,4CAsWP,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/src/components/EncoreContextProviders.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Context provider composition component
+ *
+ * Wraps children with all necessary Encore contexts in the correct order.
+ * This reduces nesting in the main EncoreApp component.
+ */
+import React from "react";
+import { type EncoreActionPayload } from "../contexts/EncoreActionContext";
+interface EncoreContextProvidersProps {
+    componentId?: string;
+    onAction?: (payload: EncoreActionPayload) => void | Promise<void>;
+    repeatingContainerContextValue: any;
+    bindingContextValue: any;
+    children: React.ReactNode;
+}
+/**
+ * Composes all Encore context providers
+ *
+ * Provides a cleaner way to wrap content with multiple contexts
+ * instead of deeply nested Provider components.
+ *
+ * @example
+ * <EncoreContextProviders
+ *   componentId={componentId}
+ *   onAction={onAction}
+ *   repeatingContainerContextValue={containerContextValue}
+ *   bindingContextValue={bindingContext}
+ * >
+ *   <DynamicComponent />
+ * </EncoreContextProviders>
+ */
+export declare function EncoreContextProviders({ componentId, onAction, repeatingContainerContextValue, bindingContextValue, children, }: EncoreContextProvidersProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=EncoreContextProviders.d.ts.map

package/dist/src/components/EncoreContextProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncoreContextProviders.d.ts","sourceRoot":"","sources":["../../../src/components/EncoreContextProviders.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAA4B,EAC1B,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAIzC,UAAU,2BAA2B;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,8BAA8B,EAAE,GAAG,CAAC;IACpC,mBAAmB,EAAE,GAAG,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,WAAW,EACX,QAAQ,EACR,8BAA8B,EAC9B,mBAAmB,EACnB,QAAQ,GACT,EAAE,2BAA2B,2CAc7B"}

package/dist/src/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/components.tsx"],"names":[],"mappings":"AACA,OAAO,KAMN,MAAM,OAAO,CAAC;AA8jGf,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAoDxD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/components.tsx"],"names":[],"mappings":"AACA,OAAO,KAMN,MAAM,OAAO,CAAC;AAmkGf,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAoDxD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/src/hooks/useFontLoader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Custom hook for loading fonts from app definition
+ *
+ * Handles FontFace API loading of custom fonts declared in the app JSON.
+ * Skips fonts marked as broken and provides debug logging in development.
+ */
+/**
+ * Loads fonts declared in app definition using the FontFace API
+ *
+ * @param appData - App definition containing fonts array
+ *
+ * @example
+ * const { data: appData } = useSWR(appUrl, fetcher);
+ * useFontLoader(appData);
+ */
+export declare function useFontLoader(appData: unknown): void;
+//# sourceMappingURL=useFontLoader.d.ts.map

package/dist/src/hooks/useFontLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFontLoader.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFontLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,QAqD7C"}

package/dist/src/hooks/usePusherUpdates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePusherUpdates.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePusherUpdates.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,WAAW,CAAC;AAU/B,KAAK,uBAAuB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,MAAM,EACN,OAAc,EACd,QAAQ,GACT,EAAE,uBAAuB;;;EAsHzB"}
+{"version":3,"file":"usePusherUpdates.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePusherUpdates.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,WAAW,CAAC;AAW/B,KAAK,uBAAuB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,MAAM,EACN,OAAc,EACd,QAAQ,GACT,EAAE,uBAAuB;;;EA4GzB"}

package/dist/src/hooks/useRepeatingContainers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Custom hook for managing repeating container controls
+ *
+ * Handles slider/list index management and synchronization between
+ * parent-provided controls and internal component state.
+ */
+import type { RepeatingContainerControl } from "../contexts/EncoreRepeatingContainerContext";
+interface ContainerControlProps {
+    currentIndex?: number;
+    onIndexChange?: (index: number) => void;
+}
+/**
+ * Manages repeating container (slider/list) controls
+ *
+ * @param externalControls - Optional controls passed from parent component
+ * @returns Context value for EncoreRepeatingContainerContext
+ *
+ * @example
+ * const containerContextValue = useRepeatingContainers(repeatingContainerControls);
+ * <EncoreRepeatingContainerContext.Provider value={containerContextValue}>
+ */
+export declare function useRepeatingContainers(externalControls?: Record<string, ContainerControlProps>): {
+    registerContainer: (id: string, control: RepeatingContainerControl) => void;
+    unregisterContainer: (id: string) => void;
+    getControl: (id: string) => RepeatingContainerControl | undefined;
+    setControlProps: (id: string, props: ContainerControlProps | ((prev: ContainerControlProps) => ContainerControlProps)) => void;
+    getControlProps: (id: string) => ContainerControlProps | undefined;
+    _propsVersion: number;
+};
+export {};
+//# sourceMappingURL=useRepeatingContainers.d.ts.map

package/dist/src/hooks/useRepeatingContainers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRepeatingContainers.d.ts","sourceRoot":"","sources":["../../../src/hooks/useRepeatingContainers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAE7F,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC;4BA+CjD,MAAM,WAAW,yBAAyB;8BAUJ,MAAM;qBAS5C,MAAM;0BAQL,MAAM,SAEN,qBAAqB,GACrB,CAAC,CAAC,IAAI,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;0BAczD,MAAM;;EA4Bd"}

package/dist/src/index.d.ts

@@ -6,5 +6,7 @@ import EncoreBindingContext from "./contexts/EncoreBindingContext";
 import useEncoreState from "./stores/useEncoreState";
 import { PACKAGE_VERSION } from "./version";
 export { EncoreApp, EncoreErrorBoundary, EncoreLoadingFallback, EncoreAppContext, EncoreBindingContext, useEncoreState, PACKAGE_VERSION, };
+export type { EncoreAppProps } from "./components/EncoreApp";
+export type { EncoreActionPayload } from "./contexts/EncoreActionContext";
 export * from "./codegen";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,wBAAwB,CAAC;AAC/C,OAAO,mBAAmB,MAAM,kCAAkC,CAAC;AACnE,OAAO,qBAAqB,MAAM,oCAAoC,CAAC;AACvE,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAC3D,OAAO,oBAAoB,MAAM,iCAAiC,CAAC;AACnE,OAAO,cAAc,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,CAAC;AAEF,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,wBAAwB,CAAC;AAC/C,OAAO,mBAAmB,MAAM,kCAAkC,CAAC;AACnE,OAAO,qBAAqB,MAAM,oCAAoC,CAAC;AACvE,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAC3D,OAAO,oBAAoB,MAAM,iCAAiC,CAAC;AACnE,OAAO,cAAc,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,CAAC;AAGF,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,cAAc,WAAW,CAAC"}