@devcabs/folio-engine 0.1.0 → 0.1.2

package/dist/types/edge.d.ts

@@ -118,15 +118,15 @@ export declare const NodeCanvasDocumentSchema: z.ZodObject<{
     sections: z.ZodArray<z.ZodAny, "many">;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    updatedAt: string;
     nodeId: string;
     version: number;
     sections: any[];
-}, {
     updatedAt: string;
+}, {
     nodeId: string;
     version: number;
     sections: any[];
+    updatedAt: string;
 }>;
 export declare const CachedIndicatorDatasetSchema: z.ZodObject<{
     chartId: z.ZodString;
@@ -186,42 +186,42 @@ export declare const PublicNodePayloadSchema: z.ZodObject<{
         sections: z.ZodArray<z.ZodAny, "many">;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        updatedAt: string;
         nodeId: string;
         version: number;
         sections: any[];
-    }, {
         updatedAt: string;
+    }, {
         nodeId: string;
         version: number;
         sections: any[];
+        updatedAt: string;
     }>;
     chartDatasets: z.ZodRecord<z.ZodString, z.ZodAny>;
     sourceMetadata: z.ZodRecord<z.ZodString, z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
+    nodeId: string;
+    version: number;
+    updatedAt: string;
+    snapshotId: string;
     canvas: {
-        updatedAt: string;
         nodeId: string;
         version: number;
         sections: any[];
+        updatedAt: string;
     };
-    updatedAt: string;
-    nodeId: string;
-    version: number;
-    snapshotId: string;
     chartDatasets: Record<string, any>;
     sourceMetadata: Record<string, any>;
 }, {
+    nodeId: string;
+    version: number;
+    updatedAt: string;
+    snapshotId: string;
     canvas: {
-        updatedAt: string;
         nodeId: string;
         version: number;
         sections: any[];
+        updatedAt: string;
     };
-    updatedAt: string;
-    nodeId: string;
-    version: number;
-    snapshotId: string;
     chartDatasets: Record<string, any>;
     sourceMetadata: Record<string, any>;
 }>;

package/dist/utils/accentTextParser.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+export interface AccentValidationResult {
+    valid: boolean;
+    warnings: string[];
+}
+/**
+ * Validates accent text syntax (e.g. *word* or **word**).
+ * Detects unclosed delimiters, empty tags, or malformed syntax.
+ */
+export declare function validateAccentedText(text: string): AccentValidationResult;
+export interface ParseAccentedTextOptions {
+    accentClassName?: string;
+    onWarn?: (warning: string) => void;
+}
+/**
+ * Parses a string containing *accent* or **accent** tags into React elements.
+ * Unaccented segments remain plain text.
+ * Accented segments are wrapped in a span with `accentClassName`.
+ *
+ * If delimiters are unclosed or malformed:
+ * - Emits a warning via `options.onWarn` or console.warn in dev mode
+ * - Gracefully falls back to rendering as plain text so the UI never crashes
+ */
+export declare function parseAccentedText(input: string | React.ReactNode, options?: ParseAccentedTextOptions): React.ReactNode;

package/dist/verifyEngineSetup-CfZViX9T.js

@@ -0,0 +1,172 @@
+import { o as h, s as o, n as y, b as p, c as w, d as T, P as $ } from "./edge-DziUDALF.js";
+import { jsx as E, Fragment as A } from "react/jsx-runtime";
+const C = h({
+  appName: o().min(1, "appName is required"),
+  tagline: o().optional(),
+  logoText: o().optional(),
+  markSides: y().int().min(3).max(32).optional(),
+  markWaviness: y().min(0).max(1).optional(),
+  heroKicker: o().optional(),
+  heroTitle: o().optional(),
+  heroSubtitle: o().optional(),
+  orgName: o().optional()
+}), N = h({
+  appId: o().min(1, "appId is required"),
+  appNamespace: o().min(1, "appNamespace is required"),
+  basePath: o().optional(),
+  nodes: w(T()).default([]),
+  branding: C,
+  securitySalt: o().optional(),
+  expectedPinHash: o().optional(),
+  features: h({
+    enableChartDrawer: p().optional(),
+    enableEditorMode: p().optional(),
+    enableHistoryLedger: p().optional()
+  }).optional()
+});
+function m(e) {
+  return {
+    appId: "default-app",
+    appNamespace: "folio",
+    branding: {
+      appName: "Folio Engine",
+      tagline: "Parametric Stepped Sequence & Document AST Platform",
+      logoText: "FOLIO",
+      markSides: 8,
+      markWaviness: 0.15
+    },
+    nodes: [],
+    securitySalt: void 0,
+    expectedPinHash: void 0,
+    features: {
+      enableChartDrawer: !0,
+      enableEditorMode: !0,
+      enableHistoryLedger: !0
+    },
+    ...e
+  };
+}
+let u = m();
+function S() {
+  return u;
+}
+function I(e) {
+  return u = m({ ...u, ...e }), u;
+}
+function F() {
+  u = m();
+}
+function P() {
+  return u.appNamespace || "folio";
+}
+function W(e, t) {
+  return (t || P()) + "_" + e;
+}
+function b(e) {
+  const t = [];
+  return !e || typeof e != "string" ? { valid: !0, warnings: t } : ((e.match(/\*/g) || []).length % 2 !== 0 && t.push(
+    `Unclosed asterisk delimiter detected in "${e}". Expected matching opening and closing '*'.`
+  ), (/\*{4}/.test(e) || /\*{2}\s+\*{2}/.test(e) || /\*\s+\*/.test(e)) && t.push(
+    `Empty accent delimiter detected in "${e}". Accent delimiters must wrap non-empty text.`
+  ), {
+    valid: t.length === 0,
+    warnings: t
+  });
+}
+function j(e, t) {
+  if (typeof e != "string" || !e.includes("*"))
+    return e;
+  const { valid: a, warnings: r } = b(e);
+  !a && r.length > 0 && r.forEach((n) => {
+    var d;
+    t != null && t.onWarn ? t.onWarn(n) : typeof console < "u" && typeof console.warn == "function" && ((typeof import.meta < "u" && !1) ?? (typeof process < "u" && ((d = process.env) == null ? void 0 : d.NODE_ENV) !== "production")) && console.warn(`⚠️ [Folio Engine] ${n}`);
+  });
+  const l = /(\*{1,2})([^\s*](?:[^*]*?[^\s*])?)\1/g, s = [];
+  let i = 0, c;
+  for (; (c = l.exec(e)) !== null; ) {
+    const [n, , d] = c, f = c.index;
+    f > i && s.push(e.substring(i, f)), s.push(
+      /* @__PURE__ */ E(
+        "span",
+        {
+          className: t == null ? void 0 : t.accentClassName,
+          children: d
+        },
+        `accent-${f}`
+      )
+    ), i = f + n.length;
+  }
+  return i < e.length && s.push(e.substring(i)), s.length === 0 ? e : s.length === 1 ? s[0] : /* @__PURE__ */ E(A, { children: s });
+}
+function q(e) {
+  const t = [], a = [], r = $.safeParse(e);
+  if (!r.success)
+    return r.error.issues.forEach((n) => {
+      t.push(`[Schema] ${n.path.join(".")}: ${n.message}`);
+    }), { ok: !1, errors: t, warnings: a };
+  const l = r.data, s = l.chartDatasets || {}, i = /* @__PURE__ */ new Set();
+  function c(n, d) {
+    n.id ? i.has(n.id) ? t.push(`[AST] Duplicate element id detected: "${n.id}".`) : i.add(n.id) : t.push(`[AST] Element in "${d}" is missing an 'id'.`), n.type === "chart" && (n.chartId ? s[n.chartId] || a.push(
+      `[Chart] Chart "${n.chartId}" is referenced in canvas section "${d}" but not found in chartDatasets.`
+    ) : t.push(`[Chart] Chart element "${n.id}" is missing 'chartId'.`));
+  }
+  return l.canvas && Array.isArray(l.canvas.sections) && l.canvas.sections.forEach((n, d) => {
+    n.id ? i.has(n.id) ? t.push(`[AST] Duplicate section id detected: "${n.id}".`) : i.add(n.id) : t.push(`[AST] Section at index ${d} is missing an 'id'.`), (!n.title || n.title.trim().length === 0) && a.push(`[AST] Section "${n.id || d}" has an empty title.`), Array.isArray(n.elements) && n.elements.forEach((f) => {
+      if (f.type === "subsection") {
+        const g = f;
+        g.id ? i.has(g.id) ? t.push(`[AST] Duplicate subsection id detected: "${g.id}".`) : i.add(g.id) : t.push(`[AST] Subsection in "${n.title || n.id}" is missing an 'id'.`), Array.isArray(g.elements) && g.elements.forEach((v) => c(v, `${n.title} > ${g.title}`));
+      } else
+        c(f, n.title);
+    });
+  }), {
+    ok: t.length === 0,
+    errors: t,
+    warnings: a
+  };
+}
+function k(e) {
+  var s;
+  const t = [], a = [], r = e ? { ...S(), ...e } : S(), l = N.safeParse(r);
+  if (l.success || l.error.issues.forEach((i) => {
+    t.push(`[Config] ${i.path.join(".")}: ${i.message}`);
+  }), (s = r.branding) != null && s.heroTitle) {
+    const i = b(r.branding.heroTitle);
+    !i.valid && i.warnings.length > 0 && i.warnings.forEach((c) => {
+      a.push(`[Branding] heroTitle accent syntax warning: ${c}`);
+    });
+  }
+  if (typeof window < "u" && typeof document < "u") {
+    const i = window.getComputedStyle(document.documentElement), c = i.getPropertyValue("--canvas-bg").trim(), n = i.getPropertyValue("--font-mono").trim();
+    !c && !n && a.push(
+      "[Styles] Folio Engine stylesheet not detected! Ensure you import '@devcabs/folio-engine/style.css' in your main entry point."
+    );
+  }
+  return {
+    ok: t.length === 0,
+    errors: t,
+    warnings: a
+  };
+}
+function H() {
+  const e = k();
+  return typeof console < "u" && (e.ok || console.error(`❌ [Folio Engine] Wiring verification failed:
+` + e.errors.join(`
+`)), e.warnings.length > 0 && console.warn(`⚠️ [Folio Engine] Wiring warnings:
+` + e.warnings.join(`
+`)), e.ok && e.warnings.length === 0 && console.log("✅ [Folio Engine] Configuration and stylesheet wiring verified successfully.")), e.ok;
+}
+export {
+  C as E,
+  N as a,
+  k as b,
+  S as c,
+  W as d,
+  m as e,
+  F as f,
+  P as g,
+  b as h,
+  j as p,
+  H as r,
+  I as s,
+  q as v
+};

package/dist/verifyEngineSetup-DeUzt_yx.cjs

@@ -0,0 +1,5 @@
+"use strict";const i=require("./edge-1WCVZ0J7.cjs"),h=require("react/jsx-runtime");var m=typeof document<"u"?document.currentScript:null;const E=i.objectType({appName:i.stringType().min(1,"appName is required"),tagline:i.stringType().optional(),logoText:i.stringType().optional(),markSides:i.numberType().int().min(3).max(32).optional(),markWaviness:i.numberType().min(0).max(1).optional(),heroKicker:i.stringType().optional(),heroTitle:i.stringType().optional(),heroSubtitle:i.stringType().optional(),orgName:i.stringType().optional()}),S=i.objectType({appId:i.stringType().min(1,"appId is required"),appNamespace:i.stringType().min(1,"appNamespace is required"),basePath:i.stringType().optional(),nodes:i.arrayType(i.anyType()).default([]),branding:E,securitySalt:i.stringType().optional(),expectedPinHash:i.stringType().optional(),features:i.objectType({enableChartDrawer:i.booleanType().optional(),enableEditorMode:i.booleanType().optional(),enableHistoryLedger:i.booleanType().optional()}).optional()});function p(e){return{appId:"default-app",appNamespace:"folio",branding:{appName:"Folio Engine",tagline:"Parametric Stepped Sequence & Document AST Platform",logoText:"FOLIO",markSides:8,markWaviness:.15},nodes:[],securitySalt:void 0,expectedPinHash:void 0,features:{enableChartDrawer:!0,enableEditorMode:!0,enableHistoryLedger:!0},...e}}let u=p();function y(){return u}function w(e){return u=p({...u,...e}),u}function A(){u=p()}function b(){return u.appNamespace||"folio"}function $(e,t){return(t||b())+"_"+e}function T(e){const t=[];return!e||typeof e!="string"?{valid:!0,warnings:t}:((e.match(/\*/g)||[]).length%2!==0&&t.push(`Unclosed asterisk delimiter detected in "${e}". Expected matching opening and closing '*'.`),(/\*{4}/.test(e)||/\*{2}\s+\*{2}/.test(e)||/\*\s+\*/.test(e))&&t.push(`Empty accent delimiter detected in "${e}". Accent delimiters must wrap non-empty text.`),{valid:t.length===0,warnings:t})}function N(e,t){if(typeof e!="string"||!e.includes("*"))return e;const{valid:r,warnings:s}=T(e);!r&&s.length>0&&s.forEach(n=>{var d;t!=null&&t.onWarn?t.onWarn(n):typeof console<"u"&&typeof console.warn=="function"&&((typeof{url:typeof document>"u"?require("url").pathToFileURL(__filename).href:m&&m.tagName.toUpperCase()==="SCRIPT"&&m.src||new URL("verifyEngineSetup-DeUzt_yx.cjs",document.baseURI).href}<"u"&&!1)??(typeof process<"u"&&((d=process.env)==null?void 0:d.NODE_ENV)!=="production"))&&console.warn(`⚠️ [Folio Engine] ${n}`)});const l=/(\*{1,2})([^\s*](?:[^*]*?[^\s*])?)\1/g,o=[];let a=0,c;for(;(c=l.exec(e))!==null;){const[n,,d]=c,g=c.index;g>a&&o.push(e.substring(a,g)),o.push(h.jsx("span",{className:t==null?void 0:t.accentClassName,children:d},`accent-${g}`)),a=g+n.length}return a<e.length&&o.push(e.substring(a)),o.length===0?e:o.length===1?o[0]:h.jsx(h.Fragment,{children:o})}function P(e){const t=[],r=[],s=i.PublicNodePayloadSchema.safeParse(e);if(!s.success)return s.error.issues.forEach(n=>{t.push(`[Schema] ${n.path.join(".")}: ${n.message}`)}),{ok:!1,errors:t,warnings:r};const l=s.data,o=l.chartDatasets||{},a=new Set;function c(n,d){n.id?a.has(n.id)?t.push(`[AST] Duplicate element id detected: "${n.id}".`):a.add(n.id):t.push(`[AST] Element in "${d}" is missing an 'id'.`),n.type==="chart"&&(n.chartId?o[n.chartId]||r.push(`[Chart] Chart "${n.chartId}" is referenced in canvas section "${d}" but not found in chartDatasets.`):t.push(`[Chart] Chart element "${n.id}" is missing 'chartId'.`))}return l.canvas&&Array.isArray(l.canvas.sections)&&l.canvas.sections.forEach((n,d)=>{n.id?a.has(n.id)?t.push(`[AST] Duplicate section id detected: "${n.id}".`):a.add(n.id):t.push(`[AST] Section at index ${d} is missing an 'id'.`),(!n.title||n.title.trim().length===0)&&r.push(`[AST] Section "${n.id||d}" has an empty title.`),Array.isArray(n.elements)&&n.elements.forEach(g=>{if(g.type==="subsection"){const f=g;f.id?a.has(f.id)?t.push(`[AST] Duplicate subsection id detected: "${f.id}".`):a.add(f.id):t.push(`[AST] Subsection in "${n.title||n.id}" is missing an 'id'.`),Array.isArray(f.elements)&&f.elements.forEach(C=>c(C,`${n.title} > ${f.title}`))}else c(g,n.title)})}),{ok:t.length===0,errors:t,warnings:r}}function v(e){var o;const t=[],r=[],s=e?{...y(),...e}:y(),l=S.safeParse(s);if(l.success||l.error.issues.forEach(a=>{t.push(`[Config] ${a.path.join(".")}: ${a.message}`)}),(o=s.branding)!=null&&o.heroTitle){const a=T(s.branding.heroTitle);!a.valid&&a.warnings.length>0&&a.warnings.forEach(c=>{r.push(`[Branding] heroTitle accent syntax warning: ${c}`)})}if(typeof window<"u"&&typeof document<"u"){const a=window.getComputedStyle(document.documentElement),c=a.getPropertyValue("--canvas-bg").trim(),n=a.getPropertyValue("--font-mono").trim();!c&&!n&&r.push("[Styles] Folio Engine stylesheet not detected! Ensure you import '@devcabs/folio-engine/style.css' in your main entry point.")}return{ok:t.length===0,errors:t,warnings:r}}function k(){const e=v();return typeof console<"u"&&(e.ok||console.error(`❌ [Folio Engine] Wiring verification failed:
+`+e.errors.join(`
+`)),e.warnings.length>0&&console.warn(`⚠️ [Folio Engine] Wiring warnings:
+`+e.warnings.join(`
+`)),e.ok&&e.warnings.length===0&&console.log("✅ [Folio Engine] Configuration and stylesheet wiring verified successfully.")),e.ok}exports.EngineBrandingConfigSchema=E;exports.EngineConfigSchema=S;exports.createDefaultEngineConfig=p;exports.getEngineConfig=y;exports.getStorageKey=$;exports.getStorageNamespace=b;exports.parseAccentedText=N;exports.resetEngineConfig=A;exports.runEngineSelfAudit=k;exports.setEngineConfig=w;exports.validateAccentedText=T;exports.validateNodePayload=P;exports.verifyEngineWiring=v;

package/package.json

@@ -1,15 +1,25 @@
 {
   "name": "@devcabs/folio-engine",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
-  "main": "./dist/folio.umd.cjs",
+  "main": "./dist/folio.cjs",
   "module": "./dist/folio.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/folio.js",
-      "require": "./dist/folio.umd.cjs"
+      "require": "./dist/folio.cjs"
+    },
+    "./edge": {
+      "types": "./dist/edge.d.ts",
+      "import": "./dist/edge.js",
+      "require": "./dist/edge.cjs"
+    },
+    "./diagnostics": {
+      "types": "./dist/diagnostics.d.ts",
+      "import": "./dist/diagnostics.js",
+      "require": "./dist/diagnostics.cjs"
     },
     "./style.css": "./dist/style.css"
   },
@@ -47,10 +57,12 @@
     "build": "npm run test:tokens && tsc --noEmit && vite build",
     "build:lib": "npm run test:tokens && vite build -c vite.config.lib.ts && tsc -p tsconfig.lib.json",
     "preview": "vite preview --port 5174",
+    "test": "vitest run",
     "test:purity": "vitest run tests/purity",
     "test:tokens": "tsx scripts/verify-token-aliases.ts",
     "lint": "eslint .",
-    "prepack": "npm run build:lib"
+    "prepack": "npm run build:lib",
+    "deploy": "tsx scripts/deploy.ts"
   },
   "files": [
     "dist"