@wp-typia/project-tools 0.16.11 → 0.16.12

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 (101) hide show
  1. package/README.md +9 -3
  2. package/dist/runtime/built-in-block-artifact-documents.d.ts +3 -0
  3. package/dist/runtime/built-in-block-artifact-documents.js +2 -0
  4. package/dist/runtime/built-in-block-artifact-types.d.ts +51 -0
  5. package/dist/runtime/built-in-block-artifact-types.js +304 -0
  6. package/dist/runtime/built-in-block-artifacts.js +4 -803
  7. package/dist/runtime/built-in-block-attribute-emitters.d.ts +71 -0
  8. package/dist/runtime/built-in-block-attribute-emitters.js +176 -0
  9. package/dist/runtime/built-in-block-attribute-specs.d.ts +38 -0
  10. package/dist/runtime/built-in-block-attribute-specs.js +358 -0
  11. package/dist/runtime/built-in-block-code-templates/basic.d.ts +4 -0
  12. package/dist/runtime/built-in-block-code-templates/basic.js +249 -0
  13. package/dist/runtime/built-in-block-code-templates/compound-child.d.ts +4 -0
  14. package/dist/runtime/built-in-block-code-templates/compound-child.js +138 -0
  15. package/dist/runtime/built-in-block-code-templates/compound-parent.d.ts +6 -0
  16. package/dist/runtime/built-in-block-code-templates/compound-parent.js +227 -0
  17. package/dist/runtime/built-in-block-code-templates/compound-persistence.d.ts +4 -0
  18. package/dist/runtime/built-in-block-code-templates/compound-persistence.js +478 -0
  19. package/dist/runtime/built-in-block-code-templates/compound.d.ts +3 -0
  20. package/dist/runtime/built-in-block-code-templates/compound.js +3 -0
  21. package/dist/runtime/built-in-block-code-templates/interactivity.d.ts +5 -0
  22. package/dist/runtime/built-in-block-code-templates/interactivity.js +547 -0
  23. package/dist/runtime/built-in-block-code-templates/persistence.d.ts +5 -0
  24. package/dist/runtime/built-in-block-code-templates/persistence.js +550 -0
  25. package/dist/runtime/built-in-block-code-templates/shared.d.ts +16 -0
  26. package/dist/runtime/built-in-block-code-templates/shared.js +53 -0
  27. package/dist/runtime/built-in-block-code-templates.d.ts +5 -32
  28. package/dist/runtime/built-in-block-code-templates.js +5 -2230
  29. package/dist/runtime/cli-add-block-config.d.ts +6 -0
  30. package/dist/runtime/cli-add-block-config.js +143 -0
  31. package/dist/runtime/cli-add-block-legacy-validator.d.ts +4 -0
  32. package/dist/runtime/cli-add-block-legacy-validator.js +168 -0
  33. package/dist/runtime/cli-add-block.js +3 -301
  34. package/dist/runtime/cli-add-workspace-assets.d.ts +38 -0
  35. package/dist/runtime/cli-add-workspace-assets.js +399 -0
  36. package/dist/runtime/cli-add-workspace.d.ts +2 -38
  37. package/dist/runtime/cli-add-workspace.js +5 -396
  38. package/dist/runtime/cli-doctor-environment.d.ts +12 -0
  39. package/dist/runtime/cli-doctor-environment.js +123 -0
  40. package/dist/runtime/cli-doctor-workspace.d.ts +14 -0
  41. package/dist/runtime/cli-doctor-workspace.js +296 -0
  42. package/dist/runtime/cli-doctor.d.ts +4 -2
  43. package/dist/runtime/cli-doctor.js +10 -405
  44. package/dist/runtime/migration-command-surface.d.ts +67 -0
  45. package/dist/runtime/migration-command-surface.js +189 -0
  46. package/dist/runtime/migration-diff-rename.d.ts +13 -0
  47. package/dist/runtime/migration-diff-rename.js +192 -0
  48. package/dist/runtime/migration-diff-transform.d.ts +14 -0
  49. package/dist/runtime/migration-diff-transform.js +105 -0
  50. package/dist/runtime/migration-diff.js +12 -297
  51. package/dist/runtime/migration-generated-artifacts.d.ts +3 -0
  52. package/dist/runtime/migration-generated-artifacts.js +41 -0
  53. package/dist/runtime/migration-maintenance.d.ts +51 -0
  54. package/dist/runtime/migration-maintenance.js +380 -0
  55. package/dist/runtime/migration-planning.d.ts +23 -0
  56. package/dist/runtime/migration-planning.js +131 -0
  57. package/dist/runtime/migration-project-config-source.d.ts +6 -0
  58. package/dist/runtime/migration-project-config-source.js +424 -0
  59. package/dist/runtime/migration-project-layout-discovery.d.ts +61 -0
  60. package/dist/runtime/migration-project-layout-discovery.js +337 -0
  61. package/dist/runtime/migration-project-layout-paths.d.ts +135 -0
  62. package/dist/runtime/migration-project-layout-paths.js +288 -0
  63. package/dist/runtime/migration-project-layout.d.ts +3 -0
  64. package/dist/runtime/migration-project-layout.js +2 -0
  65. package/dist/runtime/migration-project-workspace.d.ts +47 -0
  66. package/dist/runtime/migration-project-workspace.js +212 -0
  67. package/dist/runtime/migration-project.d.ts +4 -94
  68. package/dist/runtime/migration-project.js +3 -1101
  69. package/dist/runtime/migration-render-diff-rule.d.ts +5 -0
  70. package/dist/runtime/migration-render-diff-rule.js +120 -0
  71. package/dist/runtime/migration-render-execution.d.ts +3 -0
  72. package/dist/runtime/migration-render-execution.js +428 -0
  73. package/dist/runtime/migration-render-generated.d.ts +27 -0
  74. package/dist/runtime/migration-render-generated.js +230 -0
  75. package/dist/runtime/migration-render-support.d.ts +3 -0
  76. package/dist/runtime/migration-render-support.js +16 -0
  77. package/dist/runtime/migration-render.d.ts +3 -33
  78. package/dist/runtime/migration-render.js +3 -789
  79. package/dist/runtime/migrations.d.ts +24 -118
  80. package/dist/runtime/migrations.js +12 -700
  81. package/dist/runtime/scaffold-bootstrap.d.ts +45 -0
  82. package/dist/runtime/scaffold-bootstrap.js +185 -0
  83. package/dist/runtime/scaffold-package-manager-files.d.ts +35 -0
  84. package/dist/runtime/scaffold-package-manager-files.js +79 -0
  85. package/dist/runtime/scaffold.d.ts +1 -12
  86. package/dist/runtime/scaffold.js +10 -393
  87. package/dist/runtime/template-source-contracts.d.ts +81 -0
  88. package/dist/runtime/template-source-contracts.js +1 -0
  89. package/dist/runtime/template-source-external.d.ts +21 -0
  90. package/dist/runtime/template-source-external.js +184 -0
  91. package/dist/runtime/template-source-locators.d.ts +4 -0
  92. package/dist/runtime/template-source-locators.js +72 -0
  93. package/dist/runtime/template-source-normalization.d.ts +7 -0
  94. package/dist/runtime/template-source-normalization.js +53 -0
  95. package/dist/runtime/template-source-remote.d.ts +23 -0
  96. package/dist/runtime/template-source-remote.js +336 -0
  97. package/dist/runtime/template-source-seeds.d.ts +12 -0
  98. package/dist/runtime/template-source-seeds.js +243 -0
  99. package/dist/runtime/template-source.d.ts +4 -86
  100. package/dist/runtime/template-source.js +9 -828
  101. 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[];
@@ -111,6 +51,21 @@ export declare function runMigrationCommand(command: ParsedMigrationArgs, cwd: s
111
51
  } | {
112
52
  fuzzedVersions: string[];
113
53
  seed: number | undefined;
54
+ } | MigrationPlanSummary | Promise<MigrationPlanSummary | {
55
+ cancelled: true;
56
+ }> | {
57
+ block: import("./migration-types.js").ResolvedMigrationBlockTarget;
58
+ diff: import("./migration-types.js").MigrationDiff;
59
+ }[] | {
60
+ blockName: string;
61
+ diff: ReturnType<typeof createMigrationDiff>;
62
+ rulePath: string;
63
+ } | {
64
+ scaffolded: {
65
+ blockName: string;
66
+ diff: ReturnType<typeof createMigrationDiff>;
67
+ rulePath: string;
68
+ }[];
114
69
  };
115
70
  /**
116
71
  * Preview one migration edge without scaffolding rules, fixtures, or generated files.
@@ -139,7 +94,7 @@ export declare function wizardProjectMigrations(projectDir: string, { isInteract
139
94
  * @returns The loaded migration project state after the config, snapshots, and generated files are written.
140
95
  * @throws Error When the project layout is unsupported or the migration version label is invalid.
141
96
  */
142
- export declare function initProjectMigrations(projectDir: string, currentMigrationVersion: string, { renderLine }?: CommandRenderOptions): MigrationProjectState;
97
+ export declare function initProjectMigrations(projectDir: string, currentMigrationVersion: string, { renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState;
143
98
  /**
144
99
  * Captures the current project state as a named migration snapshot and refreshes generated artifacts.
145
100
  *
@@ -152,7 +107,7 @@ export declare function initProjectMigrations(projectDir: string, currentMigrati
152
107
  export declare function snapshotProjectVersion(projectDir: string, migrationVersion: string, { renderLine, skipConfigUpdate, skipSyncTypes, }?: CommandRenderOptions & {
153
108
  skipConfigUpdate?: boolean;
154
109
  skipSyncTypes?: boolean;
155
- }): MigrationProjectState;
110
+ }): import("./migration-types.js").MigrationProjectState;
156
111
  /**
157
112
  * Computes and renders migration diffs for a selected legacy-to-target edge.
158
113
  *
@@ -184,56 +139,7 @@ export declare function scaffoldProjectMigrations(projectDir: string, { fromMigr
184
139
  rulePath: string;
185
140
  }[];
186
141
  };
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
- };
142
+ export { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations, };
237
143
  /**
238
144
  * Initialize migration scaffolding for one or more block targets.
239
145
  *
@@ -246,4 +152,4 @@ export declare function fuzzProjectMigrations(projectDir: string, { all, fromMig
246
152
  * @param options Console rendering options for initialization output.
247
153
  * @returns The loaded migration project state after initialization completes.
248
154
  */
249
- export declare function seedProjectMigrations(projectDir: string, currentMigrationVersion: string, blocks: MigrationBlockConfig[], { renderLine }?: CommandRenderOptions): MigrationProjectState;
155
+ export declare function seedProjectMigrations(projectDir: string, currentMigrationVersion: string, blocks: MigrationBlockConfig[], { renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState;