@powerhousedao/codegen 6.2.2-dev.42 → 6.2.2-dev.44

package/dist/{index-DyhHw5PG.d.mts → index-DSucUSbm.d.mts}

@@ -96,6 +96,45 @@ declare function tsMorphGenerateDocumentEditor({
  */
 declare function tsMorphGenerateDocumentModel(documentModelState: DocumentModelGlobalState, project: Project): Promise<void>;
 //#endregion
+//#region src/file-builders/document-model/upgrade-migration.d.ts
+type ScopeFill = Record<string, unknown>;
+/**
+ * How the generated upgrade transition migrates state from the previous
+ * version. "fill" carries per-scope objects of added fields with their
+ * initial values; "manual" means the schema difference cannot be migrated
+ * mechanically and the generated reducer must throw until hand-written.
+ */
+type MigrationPlan = {
+  kind: "fill";
+  fills: {
+    global?: ScopeFill;
+    local?: ScopeFill;
+  };
+} | {
+  kind: "manual";
+  reason: string;
+};
+/**
+ * Derives the migration between two consecutive spec versions. Mechanical
+ * changes — field additions on the scope's state type (initialized from the
+ * new version's initial value, falling back to the schema's zero value) and
+ * field removals — produce a "fill" plan. Anything else (changed field
+ * types, edits to nested types that pre-existing documents reference,
+ * additions codegen cannot synthesize a value for) produces a "manual" plan.
+ */
+declare function buildMigrationPlan(args: {
+  previousSpec: DocumentSpecification | undefined;
+  specification: DocumentSpecification;
+  stateName: string;
+  localStateName: string;
+}): MigrationPlan;
+/**
+ * Serializes a fill value to TypeScript source. Fill values come from JSON
+ * (initial values) or the zero-value synthesizer, so JSON serialization is
+ * sufficient.
+ */
+declare function fillToTsLiteral(fill: ScopeFill): string;
+//#endregion
 //#region src/file-builders/document-model/utils.d.ts
 declare function operationHasInput(operation: OperationSpecification): boolean;
 declare function operationHasEmptyInput(operation: OperationSpecification): boolean | undefined;
@@ -344,5 +383,5 @@ type CommandHelpInfo$1 = {
   helpTopics: HelpTopic[];
 };
 //#endregion
-export { makeEditorsFile as A, buildBoilerplatePackageJson as B, tsMorphGenerateSubgraph as C, pruneManifestSection as D, getOrCreateManifestFile as E, tsMorphGenerateDocumentEditor as F, writeGeneratedDocumentModelsFiles as G, writeAiConfigFiles as H, getCommandHelpInfo as I, writeGeneratedProjectRootFiles as J, writeGeneratedEditorsFiles as K, getCommandsHelpInfo as L, operationHasEmptyInput as M, operationHasInput as N, makeModulesIndexFile as O, tsMorphGenerateDocumentModel as P, tsMorphGenerateApp as Q, makeCliDocsFromHelp as R, makeSubgraphsIndexFile as S, createOrUpdateManifest as T, writeAllGeneratedProjectFiles as U, applyProjectCustomizations as V, writeCIFiles as W, writeModuleFiles as X, writeGeneratedSubgraphsFiles as Y, writeProjectRootFiles as Z, getLatestDocumentModelSpecVersionNumber as _, DocumentModelDocumentTypeMetadata$1 as a, getActionType as b, DocumentModelVariableNames as c, HelpTopic as d, getDocumentModelDirName as f, getLatestDocumentModelSpec as g, getEditorVariableNames as h, CommonMakeEditorComponentArgs as i, makeEditorsIndexFile as j, makeEditorModuleFile as k, EditorVariableNames$1 as l, getDocumentModelVariableNames as m, CommandHelpInfo$1 as n, DocumentModelFileMakerArgs as o, getDocumentModelSpecByVersionNumber as p, writeGeneratedProcessorsFiles as q, CommonGenerateEditorArgs$1 as r, DocumentModelModuleFileMakerArgs$1 as s, CommandEntry$1 as t, GenerateDocumentModelArgs as u, getActionInputName as v, tsMorphGenerateProcessor as w, getActionTypeName as x, getActionInputTypeNames as y, writeCliDocsMarkdownFile as z };
-//# sourceMappingURL=index-DyhHw5PG.d.mts.map
+export { writeGeneratedSubgraphsFiles as $, makeEditorsFile as A, getCommandHelpInfo as B, tsMorphGenerateSubgraph as C, pruneManifestSection as D, getOrCreateManifestFile as E, ScopeFill as F, applyProjectCustomizations as G, makeCliDocsFromHelp as H, buildMigrationPlan as I, writeCIFiles as J, writeAiConfigFiles as K, fillToTsLiteral as L, operationHasEmptyInput as M, operationHasInput as N, makeModulesIndexFile as O, MigrationPlan as P, writeGeneratedProjectRootFiles as Q, tsMorphGenerateDocumentModel as R, makeSubgraphsIndexFile as S, createOrUpdateManifest as T, writeCliDocsMarkdownFile as U, getCommandsHelpInfo as V, buildBoilerplatePackageJson as W, writeGeneratedEditorsFiles as X, writeGeneratedDocumentModelsFiles as Y, writeGeneratedProcessorsFiles as Z, getLatestDocumentModelSpecVersionNumber as _, DocumentModelDocumentTypeMetadata$1 as a, getActionType as b, DocumentModelVariableNames as c, HelpTopic as d, writeModuleFiles as et, getDocumentModelDirName as f, getLatestDocumentModelSpec as g, getEditorVariableNames as h, CommonMakeEditorComponentArgs as i, makeEditorsIndexFile as j, makeEditorModuleFile as k, EditorVariableNames$1 as l, getDocumentModelVariableNames as m, CommandHelpInfo$1 as n, tsMorphGenerateApp as nt, DocumentModelFileMakerArgs as o, getDocumentModelSpecByVersionNumber as p, writeAllGeneratedProjectFiles as q, CommonGenerateEditorArgs$1 as r, DocumentModelModuleFileMakerArgs$1 as s, CommandEntry$1 as t, writeProjectRootFiles as tt, GenerateDocumentModelArgs as u, getActionInputName as v, tsMorphGenerateProcessor as w, getActionTypeName as x, getActionInputTypeNames as y, tsMorphGenerateDocumentEditor as z };
+//# sourceMappingURL=index-DSucUSbm.d.mts.map

package/dist/index-DSucUSbm.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DSucUSbm.d.mts","names":[],"sources":["../src/file-builders/app.ts","../src/file-builders/boilerplate/generated-project-files.ts","../src/file-builders/boilerplate/package.json.ts","../src/file-builders/clis/generate-cli-docs.ts","../src/file-builders/document-editor.ts","../src/file-builders/document-model/document-model.ts","../src/file-builders/document-model/upgrade-migration.ts","../src/file-builders/document-model/utils.ts","../src/file-builders/editor-common.ts","../src/file-builders/index-files.ts","../src/file-builders/manifest.ts","../src/file-builders/processors/processor.ts","../src/file-builders/subgraphs.ts","../src/name-builders/get-action-names.ts","../src/name-builders/get-variable-names.ts","../src/file-builders/types.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as DocumentModelDocumentTypeMetadata, c as DocumentModelVariableNames, d as HelpTopic, i as CommonMakeEditorComponentArgs, l as EditorVariableNames, n as CommandHelpInfo, o as DocumentModelFileMakerArgs, r as CommonGenerateEditorArgs, s as DocumentModelModuleFileMakerArgs, t as CommandEntry, u as GenerateDocumentModelArgs } from "./index-DyhHw5PG.mjs";
+import { a as DocumentModelDocumentTypeMetadata, c as DocumentModelVariableNames, d as HelpTopic, i as CommonMakeEditorComponentArgs, l as EditorVariableNames, n as CommandHelpInfo, o as DocumentModelFileMakerArgs, r as CommonGenerateEditorArgs, s as DocumentModelModuleFileMakerArgs, t as CommandEntry, u as GenerateDocumentModelArgs } from "./index-DSucUSbm.mjs";
 import { a as parseConfig, i as parseArgs, n as validateDocumentModelState, r as configSpec, t as DocumentModelStateValidationResult } from "./validation-Z3z0BJlu.mjs";
 import { FEATURE_DEPENDENCIES } from "@powerhousedao/shared/clis";
 import { PackageJson } from "read-pkg";