@pixerate/editor 0.23.0 → 0.25.0

package/dist/chunk-D6FH2YAX.cjs

@@ -0,0 +1,131 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/persistence/migrate.ts
+function hasLoadProblems(report) {
+  return report.problems.length > 0 || report.readOnly !== null;
+}
+function createLoadReport(partial = {}) {
+  return {
+    migratedFrom: null,
+    version: null,
+    problems: [],
+    readOnly: null,
+    unknownKeys: [],
+    ...partial
+  };
+}
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var deepClone = (value) => typeof structuredClone === "function" ? structuredClone(value) : JSON.parse(JSON.stringify(value));
+function toObject(json) {
+  let value = json;
+  if (typeof json === "string") {
+    try {
+      value = JSON.parse(json);
+    } catch (e) {
+      return void 0;
+    }
+  }
+  return isObject(value) ? deepClone(value) : void 0;
+}
+function migrateDocument(json, options) {
+  const versionKey = _nullishCoalesce(options.versionKey, () => ( "version"));
+  const target = options.currentVersion;
+  const original = toObject(json);
+  if (!original) {
+    return {
+      doc: { [versionKey]: target },
+      report: createLoadReport({
+        readOnly: { kind: "invalid", message: "document is not a JSON object" }
+      })
+    };
+  }
+  const raw = original[versionKey];
+  const found = typeof raw === "number" && Number.isInteger(raw) && raw >= 0 ? raw : null;
+  const from = _nullishCoalesce(_nullishCoalesce(found, () => ( options.missingVersion)), () => ( target));
+  const report = createLoadReport({ version: found });
+  if (from > target) {
+    report.readOnly = {
+      kind: "newerVersion",
+      version: from,
+      supported: target,
+      message: `document has version ${from}, newer than the supported ${target}`
+    };
+    return { doc: original, report };
+  }
+  if (from === target) {
+    original[versionKey] = target;
+    return { doc: original, report };
+  }
+  let doc = deepClone(original);
+  for (let step = from; step < target; step++) {
+    const fn = _optionalChain([options, 'access', _ => _.steps, 'optionalAccess', _2 => _2[step]]);
+    if (!fn) {
+      report.readOnly = {
+        kind: "migrationFailed",
+        from: step,
+        message: `no migration step from version ${step}`
+      };
+      return { doc: original, report };
+    }
+    try {
+      doc = _nullishCoalesce(fn(doc), () => ( doc));
+    } catch (error) {
+      report.readOnly = {
+        kind: "migrationFailed",
+        from: step,
+        message: `migration from version ${step} failed: ${error instanceof Error ? error.message : String(error)}`
+      };
+      return { doc: original, report };
+    }
+    doc[versionKey] = step + 1;
+  }
+  report.migratedFrom = from;
+  return { doc, report };
+}
+function loadSections(doc, sections, options = {}) {
+  const source = isObject(doc) ? doc : {};
+  const ignore = new Set(_nullishCoalesce(options.ignore, () => ( ["version"])));
+  const value = {};
+  const problems = [];
+  for (const key of Object.keys(sections)) {
+    const spec = sections[key];
+    const fallback = () => typeof spec.defaults === "function" ? spec.defaults() : spec.defaults;
+    if (!Object.prototype.hasOwnProperty.call(source, key)) {
+      value[key] = fallback();
+      continue;
+    }
+    try {
+      const parsed = spec.parse(source[key]);
+      if (parsed === void 0) throw new Error("invalid value");
+      value[key] = parsed;
+    } catch (error) {
+      problems.push({
+        section: key,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      value[key] = fallback();
+    }
+  }
+  const unknown = {};
+  for (const key of Object.keys(source)) {
+    if (!(key in sections) && !ignore.has(key)) unknown[key] = source[key];
+  }
+  return { value, problems, unknown };
+}
+function loadDocument(json, sections, options) {
+  const { doc, report } = migrateDocument(json, options);
+  const ignore = _nullishCoalesce(options.ignore, () => ( [_nullishCoalesce(options.versionKey, () => ( "version"))]));
+  const result = loadSections(_optionalChain([report, 'access', _3 => _3.readOnly, 'optionalAccess', _4 => _4.kind]) === "invalid" ? {} : doc, sections, {
+    ignore
+  });
+  report.problems = result.problems;
+  report.unknownKeys = Object.keys(result.unknown);
+  return { ...result, report };
+}
+
+
+
+
+
+
+
+exports.hasLoadProblems = hasLoadProblems; exports.createLoadReport = createLoadReport; exports.migrateDocument = migrateDocument; exports.loadSections = loadSections; exports.loadDocument = loadDocument;
+//# sourceMappingURL=chunk-D6FH2YAX.cjs.map

package/dist/chunk-D6FH2YAX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/chunk-D6FH2YAX.cjs","../src/persistence/migrate.ts"],"names":[],"mappings":"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","file":"/home/runner/work/editor/editor/packages/core/dist/chunk-D6FH2YAX.cjs","sourcesContent":[null,"// Portions ported from craft-libs-main/crates/settings/src/migrate.rs, src/document.rs and\n// src/error.rs (MIT OR Apache-2.0, © ArtCraft Team and contributors). See THIRD_PARTY_NOTICES.md.\n\n/** A section whose stored value did not fit; its defaults were used instead. */\nexport interface SectionProblem {\n  /** Top-level key of the section. */\n  section: string;\n  message: string;\n}\n\n/** Why a loaded document must not be written back. */\nexport type ReadOnlyReason =\n  | { kind: \"newerVersion\"; version: number; supported: number; message: string }\n  | { kind: \"migrationFailed\"; from: number; message: string }\n  | { kind: \"invalid\"; message: string };\n\n/** What happened while loading a document. Nothing in here is fatal. */\nexport interface LoadReport {\n  /** Set when the document was upgraded step by step from this older version. */\n  migratedFrom: number | null;\n  /** The version found in the input (`null` when it had none). */\n  version: number | null;\n  /** Sections replaced by their defaults (see `loadSections`). */\n  problems: SectionProblem[];\n  /**\n   * Set when the document must not be saved over: written by a newer build,\n   * a migration step failed, or the input was not an object. Show the values,\n   * but never overwrite the stored document.\n   */\n  readOnly: ReadOnlyReason | null;\n  /** Top-level keys this build does not know; kept in `unknown` so a save can write them back. */\n  unknownKeys: string[];\n}\n\n/** True when something should be shown to the user. */\nexport function hasLoadProblems(report: LoadReport): boolean {\n  return report.problems.length > 0 || report.readOnly !== null;\n}\n\nexport function createLoadReport(partial: Partial<LoadReport> = {}): LoadReport {\n  return {\n    migratedFrom: null,\n    version: null,\n    problems: [],\n    readOnly: null,\n    unknownKeys: [],\n    ...partial,\n  };\n}\n\nexport type JsonObject = Record<string, unknown>;\n\n/** One migration step: turns a document at version `from` into version `from + 1`. */\nexport type MigrationStep = (doc: JsonObject) => JsonObject | void;\n\nexport interface MigrateOptions {\n  /** The version this build writes. */\n  currentVersion: number;\n  /** Steps keyed by the version they start from. */\n  steps?: Record<number, MigrationStep>;\n  /** Key holding the version (default `\"version\"`). */\n  versionKey?: string;\n  /**\n   * Version assumed when the key is missing (default: `currentVersion`, i.e. a\n   * hand-written document is taken as current and the key is added).\n   */\n  missingVersion?: number;\n}\n\nexport interface MigrateResult {\n  /** The migrated document (a deep copy; the input is never modified). */\n  doc: JsonObject;\n  report: LoadReport;\n}\n\nconst isObject = (value: unknown): value is JsonObject =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst deepClone = <T>(value: T): T =>\n  typeof structuredClone === \"function\"\n    ? structuredClone(value)\n    : (JSON.parse(JSON.stringify(value)) as T);\n\n/** Parses a JSON string, or deep-copies an object. `undefined` when it is not an object. */\nfunction toObject(json: unknown): JsonObject | undefined {\n  let value = json;\n  if (typeof json === \"string\") {\n    try {\n      value = JSON.parse(json);\n    } catch {\n      return undefined;\n    }\n  }\n  return isObject(value) ? deepClone(value) : undefined;\n}\n\n/**\n * Brings a stored document up to `currentVersion` by running one step per\n * version (`steps[v]` turns version `v` into `v + 1`).\n *\n * - Missing version: taken as `missingVersion` (default current); the key is added.\n * - Newer than `currentVersion`: left alone and reported `readOnly` (never overwrite\n *   a file written by a newer build).\n * - A missing or throwing step: the document is returned as it was before\n *   migrating and reported `readOnly`.\n * - Keys the steps do not touch are preserved.\n */\nexport function migrateDocument(json: unknown, options: MigrateOptions): MigrateResult {\n  const versionKey = options.versionKey ?? \"version\";\n  const target = options.currentVersion;\n  const original = toObject(json);\n  if (!original) {\n    return {\n      doc: { [versionKey]: target },\n      report: createLoadReport({\n        readOnly: { kind: \"invalid\", message: \"document is not a JSON object\" },\n      }),\n    };\n  }\n  const raw = original[versionKey];\n  const found = typeof raw === \"number\" && Number.isInteger(raw) && raw >= 0 ? raw : null;\n  const from = found ?? options.missingVersion ?? target;\n  const report = createLoadReport({ version: found });\n\n  if (from > target) {\n    report.readOnly = {\n      kind: \"newerVersion\",\n      version: from,\n      supported: target,\n      message: `document has version ${from}, newer than the supported ${target}`,\n    };\n    return { doc: original, report };\n  }\n  if (from === target) {\n    original[versionKey] = target;\n    return { doc: original, report };\n  }\n\n  let doc = deepClone(original);\n  for (let step = from; step < target; step++) {\n    const fn = options.steps?.[step];\n    if (!fn) {\n      report.readOnly = {\n        kind: \"migrationFailed\",\n        from: step,\n        message: `no migration step from version ${step}`,\n      };\n      return { doc: original, report };\n    }\n    try {\n      doc = fn(doc) ?? doc;\n    } catch (error) {\n      report.readOnly = {\n        kind: \"migrationFailed\",\n        from: step,\n        message: `migration from version ${step} failed: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n      };\n      // Never hand back half-migrated values.\n      return { doc: original, report };\n    }\n    doc[versionKey] = step + 1;\n  }\n  report.migratedFrom = from;\n  return { doc, report };\n}\n\n/** How one top-level section is read. */\nexport interface SectionSpec<V> {\n  /** Validates / converts the stored value; throw (or return `undefined`) to reject it. */\n  parse: (value: unknown) => V | undefined;\n  /** Used when the section is missing or rejected. */\n  defaults: V | (() => V);\n}\n\nexport type SectionSpecs<T> = { [K in keyof T]: SectionSpec<T[K]> };\n\nexport interface LoadSectionsOptions {\n  /** Keys that are neither sections nor unknown (default `[\"version\"]`). */\n  ignore?: string[];\n}\n\nexport interface LoadSectionsResult<T> {\n  value: T;\n  /** Sections that were present but rejected (missing ones are not problems). */\n  problems: SectionProblem[];\n  /** Top-level keys not described by `sections`; write them back to keep them. */\n  unknown: JsonObject;\n}\n\n/**\n * Reads `doc` one top-level section at a time: a section that does not parse\n * is reported and replaced by its defaults, every other section is kept. This\n * keeps one bad value (e.g. a renamed enum) from resetting the whole document.\n */\nexport function loadSections<T>(\n  doc: unknown,\n  sections: SectionSpecs<T>,\n  options: LoadSectionsOptions = {},\n): LoadSectionsResult<T> {\n  const source = isObject(doc) ? doc : {};\n  const ignore = new Set(options.ignore ?? [\"version\"]);\n  const value = {} as T;\n  const problems: SectionProblem[] = [];\n  for (const key of Object.keys(sections) as (keyof T & string)[]) {\n    const spec = sections[key];\n    const fallback = () =>\n      typeof spec.defaults === \"function\"\n        ? (spec.defaults as () => T[typeof key])()\n        : spec.defaults;\n    if (!Object.prototype.hasOwnProperty.call(source, key)) {\n      value[key] = fallback();\n      continue;\n    }\n    try {\n      const parsed = spec.parse(source[key]);\n      if (parsed === undefined) throw new Error(\"invalid value\");\n      value[key] = parsed;\n    } catch (error) {\n      problems.push({\n        section: key,\n        message: error instanceof Error ? error.message : String(error),\n      });\n      value[key] = fallback();\n    }\n  }\n  const unknown: JsonObject = {};\n  for (const key of Object.keys(source)) {\n    if (!(key in sections) && !ignore.has(key)) unknown[key] = source[key];\n  }\n  return { value, problems, unknown };\n}\n\nexport interface LoadDocumentOptions extends MigrateOptions, LoadSectionsOptions {}\n\nexport interface LoadDocumentResult<T> extends LoadSectionsResult<T> {\n  report: LoadReport;\n}\n\n/**\n * `migrateDocument` followed by `loadSections`, with one `LoadReport`\n * (`problems` and `unknownKeys` filled in).\n */\nexport function loadDocument<T>(\n  json: unknown,\n  sections: SectionSpecs<T>,\n  options: LoadDocumentOptions,\n): LoadDocumentResult<T> {\n  const { doc, report } = migrateDocument(json, options);\n  const ignore = options.ignore ?? [options.versionKey ?? \"version\"];\n  const result = loadSections(report.readOnly?.kind === \"invalid\" ? {} : doc, sections, {\n    ignore,\n  });\n  report.problems = result.problems;\n  report.unknownKeys = Object.keys(result.unknown);\n  return { ...result, report };\n}\n"]}