@jbpark/live-editor 4.4.0 → 4.5.0

package/dist/utils/index.d.ts

@@ -1,4 +1,15 @@
-import { _ as Module, a as SectionOptions, c as createSectionPreviewCache, n as DocumentOptions, o as SectionPreviewCache, v as Section } from "../document-Ct4jW78J.js";
+import { _ as Module, a as SectionOptions, n as DocumentOptions, o as SectionPreviewCache$1, r as DocumentProblem, v as Section } from "../document-Ct4jW78J.js";
+//#region src/utils/sections.d.ts
+declare const extractSections: (code: string, options?: SectionOptions) => Section[];
+declare const replaceSections: (code: string, sections: string[], options?: DocumentOptions) => string;
+declare const createDocument: ({ containerId }?: DocumentOptions) => string;
+type DocumentCheck = {
+  ok: true;
+} | ({
+  ok: false;
+} & DocumentProblem);
+declare const checkDocument: (code: string, options?: DocumentOptions) => DocumentCheck;
+//#endregion
 //#region node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/clsx.d.mts
 type ClassValue = ClassArray | ClassDictionary | string | number | bigint | null | boolean | undefined;
 type ClassDictionary = Record<string, any>;
@@ -10,26 +21,32 @@ declare function cn(...inputs: ClassValue[]): string;
 //#region src/utils/compile.d.ts
 declare const compile: (code: string, modules: Record<string, unknown>) => Module;
 declare const clearCompilationCache: () => void;
-declare const transformCode: (code: string, isTypeScript?: boolean) => string;
-//#endregion
-//#region src/utils/detect-typescript.d.ts
-declare const detectTypeScript: (code: string) => boolean;
 //#endregion
 //#region src/utils/editor-caches.d.ts
 declare const clearEditorCaches: () => void;
-declare const registerEditorSession: () => (() => void);
 //#endregion
 //#region src/utils/scripts.d.ts
-declare const getCachedScriptBlob: (src: string) => Promise<string>;
 declare const preloadScripts: (scripts: string[]) => void;
-declare const clearScriptCache: () => void;
 //#endregion
-//#region src/utils/sections.d.ts
-declare const extractSections: (code: string, options?: SectionOptions) => Section[];
-declare const replaceSections: (code: string, sections: string[], options?: DocumentOptions) => string;
+//#region src/utils/index.d.ts
+/** @deprecated Internal. Use `compile`. Removed in the next major. */
+declare const transformCode: (code: string, isTypeScript?: boolean) => string;
+/** @deprecated Internal. Removed in the next major. */
+declare const detectTypeScript: (code: string) => boolean;
+/** @deprecated Internal. `Live` registers its own session. Removed in the next major. */
+declare const registerEditorSession: () => (() => void);
+/** @deprecated Internal. Use `preloadScripts`. Removed in the next major. */
+declare const getCachedScriptBlob: (src: string) => Promise<string>;
+/** @deprecated Internal. Use `clearEditorCaches`. Removed in the next major. */
+declare const clearScriptCache: () => void;
+/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */
 declare const generateSection: (code: string, fullCode: string, options?: DocumentOptions) => string;
+/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */
 declare const generateSections: (codes: string[], fullCode: string, options?: DocumentOptions) => string[];
-declare const createDocument: ({ containerId }?: DocumentOptions) => string;
+/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */
+declare const createSectionPreviewCache: () => SectionPreviewCache$1;
+/** @deprecated Internal. Removed in the next major. */
+type SectionPreviewCache = SectionPreviewCache$1;
 //#endregion
-export { type DocumentOptions, type SectionOptions, type SectionPreviewCache, clearCompilationCache, clearEditorCaches, clearScriptCache, cn, compile, createDocument, createSectionPreviewCache, detectTypeScript, extractSections, generateSection, generateSections, getCachedScriptBlob, preloadScripts, registerEditorSession, replaceSections, transformCode };
+export { type DocumentCheck, type DocumentOptions, type DocumentProblem, type SectionOptions, SectionPreviewCache, checkDocument, clearCompilationCache, clearEditorCaches, clearScriptCache, cn, compile, createDocument, createSectionPreviewCache, detectTypeScript, extractSections, generateSection, generateSections, getCachedScriptBlob, preloadScripts, registerEditorSession, replaceSections, transformCode };
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -1,7 +1,27 @@
-import { n as createSectionPreviewCache } from "../document-BDn_f08_.js";
-import { r as registerEditorSession, t as clearEditorCaches } from "../editor-caches-ClMvdcQF.js";
+import { n as createSectionPreviewCache$1 } from "../document-DGHTfrda.js";
+import { r as registerEditorSession$1, t as clearEditorCaches } from "../editor-caches-ClMvdcQF.js";
 import { t as cn } from "../cn-CAnad2vL.js";
-import { a as getCachedScriptBlob, i as clearScriptCache, n as compile, o as preloadScripts, r as transformCode, t as clearCompilationCache } from "../compile-DDfk5P25.js";
-import { t as detectTypeScript } from "../detect-typescript-CCj9ALXc.js";
-import { a as replaceSections, i as generateSections, n as extractSections, r as generateSection, t as createDocument } from "../sections-CBVMO8Jl.js";
-export { clearCompilationCache, clearEditorCaches, clearScriptCache, cn, compile, createDocument, createSectionPreviewCache, detectTypeScript, extractSections, generateSection, generateSections, getCachedScriptBlob, preloadScripts, registerEditorSession, replaceSections, transformCode };
+import { a as getCachedScriptBlob$1, i as clearScriptCache$1, n as compile, o as preloadScripts, r as transformCode$1, t as clearCompilationCache } from "../compile-DDfk5P25.js";
+import { t as detectTypeScript$1 } from "../detect-typescript-CCj9ALXc.js";
+import { a as generateSections$1, i as generateSection$1, n as createDocument, o as replaceSections, r as extractSections, t as checkDocument } from "../sections-BRH3KHYc.js";
+//#region src/utils/index.ts
+/** @deprecated Internal. Use `compile`. Removed in the next major. */
+const transformCode = transformCode$1;
+/** @deprecated Internal. Removed in the next major. */
+const detectTypeScript = detectTypeScript$1;
+/** @deprecated Internal. `Live` registers its own session. Removed in the next major. */
+const registerEditorSession = registerEditorSession$1;
+/** @deprecated Internal. Use `preloadScripts`. Removed in the next major. */
+const getCachedScriptBlob = getCachedScriptBlob$1;
+/** @deprecated Internal. Use `clearEditorCaches`. Removed in the next major. */
+const clearScriptCache = clearScriptCache$1;
+/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */
+const generateSection = generateSection$1;
+/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */
+const generateSections = generateSections$1;
+/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */
+const createSectionPreviewCache = createSectionPreviewCache$1;
+//#endregion
+export { checkDocument, clearCompilationCache, clearEditorCaches, clearScriptCache, cn, compile, createDocument, createSectionPreviewCache, detectTypeScript, extractSections, generateSection, generateSections, getCachedScriptBlob, preloadScripts, registerEditorSession, replaceSections, transformCode };
+
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_transformCode","_detectTypeScript","_registerEditorSession","_getCachedScriptBlob","_clearScriptCache","_generateSection","_generateSections","_createSectionPreviewCache"],"sources":["../../src/utils/index.ts"],"sourcesContent":["// The public `./utils` entry. Each concern lives in its own module so that\n// library code imports only what it uses: `Live.Preview` needs `compile`,\n// not the AST layer behind the section helpers, and the provider needs\n// neither (#407). Import from those modules inside the library, not here.\nimport { transformCode as _transformCode } from './compile';\nimport { detectTypeScript as _detectTypeScript } from './detect-typescript';\nimport { registerEditorSession as _registerEditorSession } from './editor-caches';\nimport { getCachedScriptBlob as _getCachedScriptBlob } from './scripts';\nimport { clearScriptCache as _clearScriptCache } from './scripts';\nimport { generateSection as _generateSection } from './sections';\nimport { generateSections as _generateSections } from './sections';\nimport { createSectionPreviewCache as _createSectionPreviewCache } from './sections';\nimport type { SectionPreviewCache as _SectionPreviewCache } from './sections';\n\nexport { cn } from './cn';\nexport { clearCompilationCache, compile } from './compile';\nexport { clearEditorCaches } from './editor-caches';\nexport { preloadScripts } from './scripts';\nexport {\n  checkDocument,\n  createDocument,\n  extractSections,\n  replaceSections,\n} from './sections';\nexport type {\n  DocumentCheck,\n  DocumentOptions,\n  DocumentProblem,\n  SectionOptions,\n} from './sections';\n\n// Internal helpers this entry used to export. Each still works, and leaves\n// the entry in the next major (#522). Re-exports only: a declaration here,\n// such as `export const x = _x`, moves the entry's types into the shared\n// declaration chunk that also pulls in React.\n/** @deprecated Internal. Use `compile`. Removed in the next major. */\nexport const transformCode = _transformCode;\n/** @deprecated Internal. Removed in the next major. */\nexport const detectTypeScript = _detectTypeScript;\n/** @deprecated Internal. `Live` registers its own session. Removed in the next major. */\nexport const registerEditorSession = _registerEditorSession;\n/** @deprecated Internal. Use `preloadScripts`. Removed in the next major. */\nexport const getCachedScriptBlob = _getCachedScriptBlob;\n/** @deprecated Internal. Use `clearEditorCaches`. Removed in the next major. */\nexport const clearScriptCache = _clearScriptCache;\n/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */\nexport const generateSection = _generateSection;\n/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */\nexport const generateSections = _generateSections;\n/** @deprecated Internal. `Live.Dnd` renders section previews itself. Removed in the next major. */\nexport const createSectionPreviewCache = _createSectionPreviewCache;\n/** @deprecated Internal. Removed in the next major. */\nexport type SectionPreviewCache = _SectionPreviewCache;\n"],"mappings":";;;;;;;;AAoCA,MAAa,gBAAgBA;;AAE7B,MAAa,mBAAmBC;;AAEhC,MAAa,wBAAwBC;;AAErC,MAAa,sBAAsBC;;AAEnC,MAAa,mBAAmBC;;AAEhC,MAAa,kBAAkBC;;AAE/B,MAAa,mBAAmBC;;AAEhC,MAAa,4BAA4BC"}

package/dist/validate-DB59Z_Nx.d.ts

@@ -0,0 +1,100 @@
+//#region src/utils/ast/types.d.ts
+interface Attribute {
+  name: string;
+  value: string | null;
+  isStringLiteral?: boolean;
+}
+interface DataAttrNode {
+  id?: string;
+  tagName: string;
+  attributes: Attribute[];
+  dataAttributes: Attribute[];
+  textContent: string;
+  rawChildren?: string;
+  source?: string;
+  loc?: {
+    start: {
+      line: number;
+      column: number;
+    };
+    end: {
+      line: number;
+      column: number;
+    };
+  };
+  children?: DataAttrNode[];
+  isFragment?: boolean;
+  bindings?: BindingItem[];
+}
+interface BindingOption {
+  label: string;
+  value: string;
+}
+declare const BINDING_TYPES: readonly ["array", "object", "string", "number", "boolean", "color", "jsx", "richtext", "date", "url"];
+type BindingType = (typeof BINDING_TYPES)[number];
+interface BindingWidget {
+  type: string;
+  step?: number;
+  unit?: string;
+  [key: string]: unknown;
+}
+interface BindingFieldSpec {
+  type?: BindingType;
+  widget?: BindingWidget;
+  options?: BindingOption[];
+  render?: BindingRenderMap;
+  min?: number;
+  max?: number;
+  pattern?: string;
+  required?: boolean;
+  meta?: Record<string, unknown>;
+}
+interface BindingRenderLeaf extends BindingFieldSpec {
+  label?: string;
+  property?: string;
+}
+interface BindingRenderMap {
+  [key: string]: BindingRenderLeaf | BindingRenderMap;
+}
+interface BindingItem extends BindingFieldSpec {
+  label: string;
+  property: string;
+}
+type BindingComponentName = `${string}.${string}` | Capitalize<string>;
+interface BindingSchema extends Omit<BindingItem, 'meta'> {
+  [key: string]: unknown;
+}
+type BindingRegistry = Partial<Record<BindingComponentName, BindingSchema[]>>;
+type BindingKeyMap = Record<string, BindingSchema[]>;
+interface BindingOptions {
+  bindings?: BindingRegistry;
+  bindingKeys?: BindingKeyMap;
+}
+type NodeValueType = 'boolean' | 'number' | 'string' | 'null' | 'array' | 'object' | 'unknown';
+type EditableNodeValueType = 'boolean' | 'number' | 'string' | 'null';
+interface ExtractedNodeValue {
+  type: NodeValueType;
+  value: string | number | boolean | null;
+}
+//#endregion
+//#region src/utils/ast/validate.d.ts
+interface ValidationResult {
+  valid: boolean;
+  message?: string;
+}
+interface ValidationMessages {
+  required: string;
+  min: (min: number) => string;
+  max: (max: number) => string;
+  pattern: string;
+  url: string;
+  date: string;
+}
+declare const defaultValidationMessages: ValidationMessages;
+interface ValidationOptions {
+  messages?: Partial<ValidationMessages>;
+}
+declare const validateBindingValue: (binding: BindingItem, value: unknown, options?: ValidationOptions) => ValidationResult;
+//#endregion
+export { BindingWidget as _, validateBindingValue as a, ExtractedNodeValue as b, BindingItem as c, BindingOptions as d, BindingRegistry as f, BindingType as g, BindingSchema as h, defaultValidationMessages as i, BindingKeyMap as l, BindingRenderMap as m, ValidationOptions as n, BindingComponentName as o, BindingRenderLeaf as p, ValidationResult as r, BindingFieldSpec as s, ValidationMessages as t, BindingOption as u, DataAttrNode as v, NodeValueType as x, EditableNodeValueType as y };
+//# sourceMappingURL=validate-DB59Z_Nx.d.ts.map

package/dist/validate-iLo8IONY.js

@@ -0,0 +1,64 @@
+//#region src/utils/ast/validate.ts
+const defaultValidationMessages = {
+	required: "This field is required.",
+	min: (min) => `Must be at least ${min}.`,
+	max: (max) => `Must be at most ${max}.`,
+	pattern: "Value does not match the required format.",
+	url: "Must be a valid URL.",
+	date: "Must be a valid date."
+};
+const VALID = { valid: true };
+const validateBindingValue = (binding, value, options = {}) => {
+	const messages = {
+		...defaultValidationMessages,
+		...options.messages
+	};
+	if (value === "" || value === null || value === void 0) {
+		if (binding.required) return {
+			valid: false,
+			message: messages.required
+		};
+		return VALID;
+	}
+	if (typeof value === "number") {
+		if (binding.min !== void 0 && value < binding.min) return {
+			valid: false,
+			message: messages.min(binding.min)
+		};
+		if (binding.max !== void 0 && value > binding.max) return {
+			valid: false,
+			message: messages.max(binding.max)
+		};
+	}
+	if (typeof value === "string" && binding.pattern) {
+		let regex;
+		try {
+			regex = new RegExp(binding.pattern);
+		} catch {
+			return VALID;
+		}
+		if (!regex.test(value)) return {
+			valid: false,
+			message: messages.pattern
+		};
+	}
+	if (typeof value === "string" && binding.type === "url") try {
+		new URL(value);
+	} catch {
+		return {
+			valid: false,
+			message: messages.url
+		};
+	}
+	if (typeof value === "string" && binding.type === "date") {
+		if (Number.isNaN(Date.parse(value))) return {
+			valid: false,
+			message: messages.date
+		};
+	}
+	return VALID;
+};
+//#endregion
+export { validateBindingValue as n, defaultValidationMessages as t };
+
+//# sourceMappingURL=validate-iLo8IONY.js.map

package/dist/validate-iLo8IONY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-iLo8IONY.js","names":[],"sources":["../src/utils/ast/validate.ts"],"sourcesContent":["import type { BindingItem } from './types';\n\nexport interface ValidationResult {\n  valid: boolean;\n  message?: string;\n}\n\n// The messages a failed check returns. Pass your own through `options` to\n// translate them; the built-in panel passes the provider's `validation`\n// messages (#524).\nexport interface ValidationMessages {\n  required: string;\n  min: (min: number) => string;\n  max: (max: number) => string;\n  pattern: string;\n  url: string;\n  date: string;\n}\n\nexport const defaultValidationMessages: ValidationMessages = {\n  required: 'This field is required.',\n  min: min => `Must be at least ${min}.`,\n  max: max => `Must be at most ${max}.`,\n  pattern: 'Value does not match the required format.',\n  url: 'Must be a valid URL.',\n  date: 'Must be a valid date.',\n};\n\nexport interface ValidationOptions {\n  messages?: Partial<ValidationMessages>;\n}\n\nconst VALID: ValidationResult = { valid: true };\n\nexport const validateBindingValue = (\n  binding: BindingItem,\n  value: unknown,\n  options: ValidationOptions = {},\n): ValidationResult => {\n  const messages = { ...defaultValidationMessages, ...options.messages };\n  const isEmpty = value === '' || value === null || value === undefined;\n\n  if (isEmpty) {\n    if (binding.required) {\n      return { valid: false, message: messages.required };\n    }\n    return VALID;\n  }\n\n  // `min`/`max` compare against a real number. Since #238, a `type:\n  // 'number'` binding delivers an actual number across the panel boundary,\n  // so callers pass one here directly — no string coercion to re-derive the\n  // type. A non-number value simply isn't range-checked.\n  if (typeof value === 'number') {\n    if (binding.min !== undefined && value < binding.min) {\n      return { valid: false, message: messages.min(binding.min) };\n    }\n    if (binding.max !== undefined && value > binding.max) {\n      return { valid: false, message: messages.max(binding.max) };\n    }\n  }\n\n  if (typeof value === 'string' && binding.pattern) {\n    let regex: RegExp;\n\n    try {\n      regex = new RegExp(binding.pattern);\n    } catch {\n      // Malformed pattern authored on the binding itself — don't block the\n      // user's input for an authoring mistake that isn't theirs to fix.\n      return VALID;\n    }\n\n    if (!regex.test(value)) {\n      return {\n        valid: false,\n        message: messages.pattern,\n      };\n    }\n  }\n\n  if (typeof value === 'string' && binding.type === 'url') {\n    try {\n      new URL(value);\n    } catch {\n      return { valid: false, message: messages.url };\n    }\n  }\n\n  if (typeof value === 'string' && binding.type === 'date') {\n    if (Number.isNaN(Date.parse(value))) {\n      return { valid: false, message: messages.date };\n    }\n  }\n\n  return VALID;\n};\n"],"mappings":";AAmBA,MAAa,4BAAgD;CAC3D,UAAU;CACV,MAAK,QAAO,oBAAoB,IAAI;CACpC,MAAK,QAAO,mBAAmB,IAAI;CACnC,SAAS;CACT,KAAK;CACL,MAAM;AACR;AAMA,MAAM,QAA0B,EAAE,OAAO,KAAK;AAE9C,MAAa,wBACX,SACA,OACA,UAA6B,CAAC,MACT;CACrB,MAAM,WAAW;EAAE,GAAG;EAA2B,GAAG,QAAQ;CAAS;CAGrE,IAFgB,UAAU,MAAM,UAAU,QAAQ,UAAU,KAAA,GAE/C;EACX,IAAI,QAAQ,UACV,OAAO;GAAE,OAAO;GAAO,SAAS,SAAS;EAAS;EAEpD,OAAO;CACT;CAMA,IAAI,OAAO,UAAU,UAAU;EAC7B,IAAI,QAAQ,QAAQ,KAAA,KAAa,QAAQ,QAAQ,KAC/C,OAAO;GAAE,OAAO;GAAO,SAAS,SAAS,IAAI,QAAQ,GAAG;EAAE;EAE5D,IAAI,QAAQ,QAAQ,KAAA,KAAa,QAAQ,QAAQ,KAC/C,OAAO;GAAE,OAAO;GAAO,SAAS,SAAS,IAAI,QAAQ,GAAG;EAAE;CAE9D;CAEA,IAAI,OAAO,UAAU,YAAY,QAAQ,SAAS;EAChD,IAAI;EAEJ,IAAI;GACF,QAAQ,IAAI,OAAO,QAAQ,OAAO;EACpC,QAAQ;GAGN,OAAO;EACT;EAEA,IAAI,CAAC,MAAM,KAAK,KAAK,GACnB,OAAO;GACL,OAAO;GACP,SAAS,SAAS;EACpB;CAEJ;CAEA,IAAI,OAAO,UAAU,YAAY,QAAQ,SAAS,OAChD,IAAI;EACF,IAAI,IAAI,KAAK;CACf,QAAQ;EACN,OAAO;GAAE,OAAO;GAAO,SAAS,SAAS;EAAI;CAC/C;CAGF,IAAI,OAAO,UAAU,YAAY,QAAQ,SAAS,QAC5C;MAAA,OAAO,MAAM,KAAK,MAAM,KAAK,CAAC,GAChC,OAAO;GAAE,OAAO;GAAO,SAAS,SAAS;EAAK;CAAA;CAIlD,OAAO;AACT"}

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "4.4.0",
+  "version": "4.5.0",
   "type": "module",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -38,8 +38,7 @@
     "url": "https://github.com/pjb0811/live-editor/issues"
   },
   "engines": {
-    "node": ">=20",
-    "pnpm": ">=10"
+    "node": ">=20"
   },
   "packageManager": "pnpm@12.8.1",
   "exports": {
@@ -90,6 +89,7 @@
     "build:demo": "vite build --outDir dist-demo",
     "build:demos": "vite build --config demos/vite.config.ts",
     "check-types": "tsc -b",
+    "check-api-surface": "node .github/scripts/check-api-surface.mjs",
     "check-package-types": "pnpm build && node .github/scripts/check-package-types.mjs",
     "lint": "eslint .",
     "depcheck": "depcheck --ignores=\"~,@changesets/cli,@jbpark/live-editor,@trivago/prettier-plugin-sort-imports,prettier-plugin-classnames,prettier-plugin-merge,prettier-plugin-tailwindcss,baseline-browser-mapping,vite-plugin-dts,depcheck\" --ignore-dirs=\"dist,dist-demo,website,.history\"",