@wp-typia/project-tools 0.16.11 → 0.16.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/README.md +9 -3
  2. package/dist/runtime/block-generator-service-core.d.ts +8 -0
  3. package/dist/runtime/block-generator-service-core.js +274 -0
  4. package/dist/runtime/block-generator-service-spec.d.ts +104 -0
  5. package/dist/runtime/block-generator-service-spec.js +139 -0
  6. package/dist/runtime/block-generator-service.d.ts +2 -110
  7. package/dist/runtime/block-generator-service.js +2 -389
  8. package/dist/runtime/built-in-block-artifact-documents.d.ts +3 -0
  9. package/dist/runtime/built-in-block-artifact-documents.js +2 -0
  10. package/dist/runtime/built-in-block-artifact-types.d.ts +51 -0
  11. package/dist/runtime/built-in-block-artifact-types.js +304 -0
  12. package/dist/runtime/built-in-block-artifacts.js +4 -803
  13. package/dist/runtime/built-in-block-attribute-emitters.d.ts +71 -0
  14. package/dist/runtime/built-in-block-attribute-emitters.js +176 -0
  15. package/dist/runtime/built-in-block-attribute-specs.d.ts +38 -0
  16. package/dist/runtime/built-in-block-attribute-specs.js +358 -0
  17. package/dist/runtime/built-in-block-code-templates/basic.d.ts +4 -0
  18. package/dist/runtime/built-in-block-code-templates/basic.js +249 -0
  19. package/dist/runtime/built-in-block-code-templates/compound-child.d.ts +4 -0
  20. package/dist/runtime/built-in-block-code-templates/compound-child.js +138 -0
  21. package/dist/runtime/built-in-block-code-templates/compound-parent.d.ts +6 -0
  22. package/dist/runtime/built-in-block-code-templates/compound-parent.js +227 -0
  23. package/dist/runtime/built-in-block-code-templates/compound-persistence.d.ts +4 -0
  24. package/dist/runtime/built-in-block-code-templates/compound-persistence.js +478 -0
  25. package/dist/runtime/built-in-block-code-templates/compound.d.ts +3 -0
  26. package/dist/runtime/built-in-block-code-templates/compound.js +3 -0
  27. package/dist/runtime/built-in-block-code-templates/interactivity.d.ts +5 -0
  28. package/dist/runtime/built-in-block-code-templates/interactivity.js +547 -0
  29. package/dist/runtime/built-in-block-code-templates/persistence.d.ts +5 -0
  30. package/dist/runtime/built-in-block-code-templates/persistence.js +550 -0
  31. package/dist/runtime/built-in-block-code-templates/shared.d.ts +16 -0
  32. package/dist/runtime/built-in-block-code-templates/shared.js +53 -0
  33. package/dist/runtime/built-in-block-code-templates.d.ts +5 -32
  34. package/dist/runtime/built-in-block-code-templates.js +5 -2230
  35. package/dist/runtime/cli-add-block-config.d.ts +6 -0
  36. package/dist/runtime/cli-add-block-config.js +143 -0
  37. package/dist/runtime/cli-add-block-legacy-validator.d.ts +4 -0
  38. package/dist/runtime/cli-add-block-legacy-validator.js +168 -0
  39. package/dist/runtime/cli-add-block.js +3 -301
  40. package/dist/runtime/cli-add-workspace-assets.d.ts +38 -0
  41. package/dist/runtime/cli-add-workspace-assets.js +399 -0
  42. package/dist/runtime/cli-add-workspace.d.ts +2 -38
  43. package/dist/runtime/cli-add-workspace.js +5 -396
  44. package/dist/runtime/cli-diagnostics.js +76 -4
  45. package/dist/runtime/cli-doctor-environment.d.ts +12 -0
  46. package/dist/runtime/cli-doctor-environment.js +123 -0
  47. package/dist/runtime/cli-doctor-workspace.d.ts +18 -0
  48. package/dist/runtime/cli-doctor-workspace.js +308 -0
  49. package/dist/runtime/cli-doctor.d.ts +4 -2
  50. package/dist/runtime/cli-doctor.js +10 -405
  51. package/dist/runtime/cli-help.js +1 -1
  52. package/dist/runtime/cli-scaffold.d.ts +8 -1
  53. package/dist/runtime/cli-scaffold.js +47 -4
  54. package/dist/runtime/migration-command-surface.d.ts +67 -0
  55. package/dist/runtime/migration-command-surface.js +189 -0
  56. package/dist/runtime/migration-diff-rename.d.ts +13 -0
  57. package/dist/runtime/migration-diff-rename.js +192 -0
  58. package/dist/runtime/migration-diff-transform.d.ts +14 -0
  59. package/dist/runtime/migration-diff-transform.js +105 -0
  60. package/dist/runtime/migration-diff.js +12 -297
  61. package/dist/runtime/migration-generated-artifacts.d.ts +3 -0
  62. package/dist/runtime/migration-generated-artifacts.js +41 -0
  63. package/dist/runtime/migration-maintenance-fixtures.d.ts +23 -0
  64. package/dist/runtime/migration-maintenance-fixtures.js +126 -0
  65. package/dist/runtime/migration-maintenance-verify.d.ts +26 -0
  66. package/dist/runtime/migration-maintenance-verify.js +262 -0
  67. package/dist/runtime/migration-maintenance.d.ts +2 -0
  68. package/dist/runtime/migration-maintenance.js +2 -0
  69. package/dist/runtime/migration-planning.d.ts +23 -0
  70. package/dist/runtime/migration-planning.js +131 -0
  71. package/dist/runtime/migration-project-config-source.d.ts +6 -0
  72. package/dist/runtime/migration-project-config-source.js +424 -0
  73. package/dist/runtime/migration-project-layout-discovery.d.ts +61 -0
  74. package/dist/runtime/migration-project-layout-discovery.js +337 -0
  75. package/dist/runtime/migration-project-layout-paths.d.ts +135 -0
  76. package/dist/runtime/migration-project-layout-paths.js +288 -0
  77. package/dist/runtime/migration-project-layout.d.ts +3 -0
  78. package/dist/runtime/migration-project-layout.js +2 -0
  79. package/dist/runtime/migration-project-workspace.d.ts +47 -0
  80. package/dist/runtime/migration-project-workspace.js +212 -0
  81. package/dist/runtime/migration-project.d.ts +4 -94
  82. package/dist/runtime/migration-project.js +3 -1101
  83. package/dist/runtime/migration-render-diff-rule.d.ts +5 -0
  84. package/dist/runtime/migration-render-diff-rule.js +120 -0
  85. package/dist/runtime/migration-render-execution.d.ts +3 -0
  86. package/dist/runtime/migration-render-execution.js +428 -0
  87. package/dist/runtime/migration-render-generated.d.ts +27 -0
  88. package/dist/runtime/migration-render-generated.js +230 -0
  89. package/dist/runtime/migration-render-support.d.ts +3 -0
  90. package/dist/runtime/migration-render-support.js +16 -0
  91. package/dist/runtime/migration-render.d.ts +3 -33
  92. package/dist/runtime/migration-render.js +3 -789
  93. package/dist/runtime/migrations.d.ts +24 -121
  94. package/dist/runtime/migrations.js +12 -700
  95. package/dist/runtime/scaffold-apply-utils.d.ts +9 -0
  96. package/dist/runtime/scaffold-apply-utils.js +27 -4
  97. package/dist/runtime/scaffold-bootstrap.d.ts +45 -0
  98. package/dist/runtime/scaffold-bootstrap.js +185 -0
  99. package/dist/runtime/scaffold-onboarding.d.ts +12 -0
  100. package/dist/runtime/scaffold-onboarding.js +42 -5
  101. package/dist/runtime/scaffold-package-manager-files.d.ts +35 -0
  102. package/dist/runtime/scaffold-package-manager-files.js +79 -0
  103. package/dist/runtime/scaffold.d.ts +1 -12
  104. package/dist/runtime/scaffold.js +11 -394
  105. package/dist/runtime/template-source-contracts.d.ts +81 -0
  106. package/dist/runtime/template-source-contracts.js +1 -0
  107. package/dist/runtime/template-source-external.d.ts +21 -0
  108. package/dist/runtime/template-source-external.js +184 -0
  109. package/dist/runtime/template-source-locators.d.ts +4 -0
  110. package/dist/runtime/template-source-locators.js +72 -0
  111. package/dist/runtime/template-source-normalization.d.ts +7 -0
  112. package/dist/runtime/template-source-normalization.js +53 -0
  113. package/dist/runtime/template-source-remote.d.ts +23 -0
  114. package/dist/runtime/template-source-remote.js +336 -0
  115. package/dist/runtime/template-source-seeds.d.ts +12 -0
  116. package/dist/runtime/template-source-seeds.js +243 -0
  117. package/dist/runtime/template-source.d.ts +4 -86
  118. package/dist/runtime/template-source.js +9 -828
  119. package/package.json +4 -4
@@ -1,38 +1,9 @@
1
+ import { CommandRenderOptions, DiffLikeOptions, formatMigrationHelpText, parseMigrationArgs, WizardOptions } from "./migration-command-surface.js";
1
2
  import { createMigrationDiff } from "./migration-diff.js";
2
3
  import { formatDiffReport } from "./migration-render.js";
3
4
  import { createMigrationRiskSummary } from "./migration-risk.js";
4
- import type { MigrationBlockConfig, MigrationProjectState, ParsedMigrationArgs, RenderLine } from "./migration-types.js";
5
- import type { ReadlinePrompt } from "./cli-prompt.js";
6
- type CommandRenderOptions = {
7
- prompt?: ReadlinePrompt;
8
- renderLine?: RenderLine;
9
- };
10
- type DiffLikeOptions = {
11
- fromMigrationVersion?: string;
12
- renderLine?: RenderLine;
13
- toMigrationVersion?: string;
14
- };
15
- type VerifyOptions = {
16
- all?: boolean;
17
- fromMigrationVersion?: string;
18
- renderLine?: RenderLine;
19
- };
20
- type FixturesOptions = {
21
- all?: boolean;
22
- confirmOverwrite?: ((message: string) => boolean) | undefined;
23
- force?: boolean;
24
- fromMigrationVersion?: string;
25
- isInteractive?: boolean;
26
- renderLine?: RenderLine;
27
- toMigrationVersion?: string;
28
- };
29
- type FuzzOptions = {
30
- all?: boolean;
31
- fromMigrationVersion?: string;
32
- iterations?: number;
33
- renderLine?: RenderLine;
34
- seed?: number;
35
- };
5
+ import { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations } from "./migration-maintenance.js";
6
+ import type { MigrationBlockConfig, ParsedMigrationArgs } from "./migration-types.js";
36
7
  type MigrationPlanBlockSummary = {
37
8
  blockName: string;
38
9
  diff: ReturnType<typeof createMigrationDiff>;
@@ -48,23 +19,7 @@ type MigrationPlanSummary = {
48
19
  summaries: MigrationPlanBlockSummary[];
49
20
  targetMigrationVersion: string;
50
21
  };
51
- type WizardOptions = CommandRenderOptions & {
52
- isInteractive?: boolean;
53
- };
54
- /**
55
- * Returns the formatted help text for migration CLI commands and flags.
56
- *
57
- * @returns Multi-line usage text for the `wp-typia migrate` command surface.
58
- */
59
- export declare function formatMigrationHelpText(): string;
60
- /**
61
- * Parses migration CLI arguments into a structured command payload.
62
- *
63
- * @param argv Command-line arguments that follow the `migrate` subcommand.
64
- * @returns Parsed migration command and normalized flags for runtime dispatch.
65
- * @throws Error When no arguments are provided, an unknown flag is encountered, or legacy semver flags are used.
66
- */
67
- export declare function parseMigrationArgs(argv: string[]): ParsedMigrationArgs;
22
+ export { formatMigrationHelpText, parseMigrationArgs };
68
23
  export { formatDiffReport };
69
24
  /**
70
25
  * Dispatch a parsed migration command to the matching runtime workflow.
@@ -78,22 +33,7 @@ export { formatDiffReport };
78
33
  * @param options Optional prompt/render hooks for testable and interactive execution.
79
34
  * @returns The command result, or a promise when the selected command is interactive.
80
35
  */
81
- export declare function runMigrationCommand(command: ParsedMigrationArgs, cwd: string, { prompt, renderLine }?: CommandRenderOptions): MigrationProjectState | import("./migration-types.js").MigrationDiff | MigrationPlanSummary | Promise<MigrationPlanSummary | {
82
- cancelled: true;
83
- }> | {
84
- block: import("./migration-types.js").ResolvedMigrationBlockTarget;
85
- diff: import("./migration-types.js").MigrationDiff;
86
- }[] | {
87
- blockName: string;
88
- diff: ReturnType<typeof createMigrationDiff>;
89
- rulePath: string;
90
- } | {
91
- scaffolded: {
92
- blockName: string;
93
- diff: ReturnType<typeof createMigrationDiff>;
94
- rulePath: string;
95
- }[];
96
- } | {
36
+ export declare function runMigrationCommand(command: ParsedMigrationArgs, cwd: string, { prompt, renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState | import("./migration-types.js").MigrationDiff | {
97
37
  verifiedVersions: string[];
98
38
  } | {
99
39
  checkedVersions: string[];
@@ -105,12 +45,24 @@ export declare function runMigrationCommand(command: ParsedMigrationArgs, cwd: s
105
45
  } | {
106
46
  generatedVersions: string[];
107
47
  skippedVersions: string[];
108
- } | {
109
- fuzzedVersions: never[];
110
- seed?: undefined;
111
48
  } | {
112
49
  fuzzedVersions: string[];
113
50
  seed: number | undefined;
51
+ } | MigrationPlanSummary | Promise<MigrationPlanSummary | {
52
+ cancelled: true;
53
+ }> | {
54
+ block: import("./migration-types.js").ResolvedMigrationBlockTarget;
55
+ diff: import("./migration-types.js").MigrationDiff;
56
+ }[] | {
57
+ blockName: string;
58
+ diff: ReturnType<typeof createMigrationDiff>;
59
+ rulePath: string;
60
+ } | {
61
+ scaffolded: {
62
+ blockName: string;
63
+ diff: ReturnType<typeof createMigrationDiff>;
64
+ rulePath: string;
65
+ }[];
114
66
  };
115
67
  /**
116
68
  * Preview one migration edge without scaffolding rules, fixtures, or generated files.
@@ -139,7 +91,7 @@ export declare function wizardProjectMigrations(projectDir: string, { isInteract
139
91
  * @returns The loaded migration project state after the config, snapshots, and generated files are written.
140
92
  * @throws Error When the project layout is unsupported or the migration version label is invalid.
141
93
  */
142
- export declare function initProjectMigrations(projectDir: string, currentMigrationVersion: string, { renderLine }?: CommandRenderOptions): MigrationProjectState;
94
+ export declare function initProjectMigrations(projectDir: string, currentMigrationVersion: string, { renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState;
143
95
  /**
144
96
  * Captures the current project state as a named migration snapshot and refreshes generated artifacts.
145
97
  *
@@ -152,7 +104,7 @@ export declare function initProjectMigrations(projectDir: string, currentMigrati
152
104
  export declare function snapshotProjectVersion(projectDir: string, migrationVersion: string, { renderLine, skipConfigUpdate, skipSyncTypes, }?: CommandRenderOptions & {
153
105
  skipConfigUpdate?: boolean;
154
106
  skipSyncTypes?: boolean;
155
- }): MigrationProjectState;
107
+ }): import("./migration-types.js").MigrationProjectState;
156
108
  /**
157
109
  * Computes and renders migration diffs for a selected legacy-to-target edge.
158
110
  *
@@ -184,56 +136,7 @@ export declare function scaffoldProjectMigrations(projectDir: string, { fromMigr
184
136
  rulePath: string;
185
137
  }[];
186
138
  };
187
- /**
188
- * Run deterministic migration verification against generated fixtures.
189
- *
190
- * @param projectDir Absolute or relative project directory containing the migration workspace.
191
- * @param options Verification scope and console rendering options.
192
- * @returns Verified legacy versions.
193
- */
194
- export declare function verifyProjectMigrations(projectDir: string, { all, fromMigrationVersion, renderLine }?: VerifyOptions): {
195
- verifiedVersions: string[];
196
- };
197
- /**
198
- * Validate the migration workspace without mutating files.
199
- *
200
- * @param projectDir Absolute or relative project directory containing the migration workspace.
201
- * @param options Doctor scope and console rendering options.
202
- * @returns Structured doctor check results for the selected legacy versions.
203
- */
204
- export declare function doctorProjectMigrations(projectDir: string, { all, fromMigrationVersion, renderLine }?: VerifyOptions): {
205
- checkedVersions: string[];
206
- checks: {
207
- detail: string;
208
- label: string;
209
- status: "fail" | "pass";
210
- }[];
211
- };
212
- /**
213
- * Generate or refresh migration fixtures for one or more legacy edges.
214
- *
215
- * @param projectDir Absolute or relative project directory containing the migration workspace.
216
- * @param options Fixture generation scope and refresh options.
217
- * @returns Generated and skipped legacy versions.
218
- */
219
- export declare function fixturesProjectMigrations(projectDir: string, { all, confirmOverwrite, force, fromMigrationVersion, isInteractive, renderLine, toMigrationVersion, }?: FixturesOptions): {
220
- generatedVersions: string[];
221
- skippedVersions: string[];
222
- };
223
- /**
224
- * Run seeded migration fuzz verification against generated fuzz artifacts.
225
- *
226
- * @param projectDir Absolute or relative project directory containing the migration workspace.
227
- * @param options Fuzz scope, iteration count, seed, and console rendering options.
228
- * @returns Fuzzed legacy versions and the effective seed.
229
- */
230
- export declare function fuzzProjectMigrations(projectDir: string, { all, fromMigrationVersion, iterations, renderLine, seed, }?: FuzzOptions): {
231
- fuzzedVersions: never[];
232
- seed?: undefined;
233
- } | {
234
- fuzzedVersions: string[];
235
- seed: number | undefined;
236
- };
139
+ export { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations, };
237
140
  /**
238
141
  * Initialize migration scaffolding for one or more block targets.
239
142
  *
@@ -246,4 +149,4 @@ export declare function fuzzProjectMigrations(projectDir: string, { all, fromMig
246
149
  * @param options Console rendering options for initialization output.
247
150
  * @returns The loaded migration project state after initialization completes.
248
151
  */
249
- export declare function seedProjectMigrations(projectDir: string, currentMigrationVersion: string, blocks: MigrationBlockConfig[], { renderLine }?: CommandRenderOptions): MigrationProjectState;
152
+ export declare function seedProjectMigrations(projectDir: string, currentMigrationVersion: string, blocks: MigrationBlockConfig[], { renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState;