@wp-typia/project-tools 0.16.8 → 0.16.9

package/README.md

@@ -51,6 +51,15 @@ files and starter `typia.manifest.json` now come from the emitter path, while
 project bootstrap/package-manager files, sync scripts, shared REST helpers, and
 the remaining non-block assets still come from Mustache-backed template copy.
 
+Generated projects now consume JSON artifacts through typed wrapper modules
+instead of local casts:
+
+- `block-metadata.ts` for `block.json`
+- `manifest-document.ts` for editor and migration consumers of
+  `typia.manifest.json`
+- `manifest-defaults-document.ts` for validator/defaults consumers of
+  `typia.manifest.json`
+
 The higher-level generator architecture record, including the current phase map
 and the non-mutating `plan -> validate -> render -> apply` tool-facing usage
 model, lives in
@@ -59,10 +68,11 @@ The public non-mutating controller/tool contract now lives in
 [`docs/block-generator-tool-contract.md`](../../docs/block-generator-tool-contract.md).
 
 Reusable external layer packages on top of the built-in shared scaffold model
-are now available programmatically through `scaffoldProject(...)`,
-`BlockGeneratorService`, and `inspectBlockGeneration(...)` via
-`externalLayerSource` and optional `externalLayerId`. The RFC/CLI UX record
-still lives in
+are now available through the canonical built-in CLI flags
+`wp-typia create --external-layer-source ... [--external-layer-id ...]`,
+`wp-typia add block --external-layer-source ... [--external-layer-id ...]`,
+and programmatically through `scaffoldProject(...)`, `BlockGeneratorService`,
+and `inspectBlockGeneration(...)`. The layer contract record lives in
 [`docs/external-template-layer-composition.md`](../../docs/external-template-layer-composition.md).
 
 If you need metadata sync, editor helpers, validation helpers, or other generated-project runtime utilities, import them directly from `@wp-typia/block-runtime/*`.

package/dist/runtime/block-generator-service.d.ts

@@ -43,9 +43,11 @@ export interface BlockGenerationTarget {
     cwd: string;
     externalLayerId?: string;
     externalLayerSource?: string;
+    externalLayerSourceLabel?: string;
     noInstall: boolean;
     packageManager: PackageManagerId;
     projectDir: string;
+    repositoryReference?: string;
     variant?: string;
 }
 export interface PlanBlockInput {
@@ -55,10 +57,12 @@ export interface PlanBlockInput {
     dataStorageMode?: DataStorageMode;
     externalLayerId?: string;
     externalLayerSource?: string;
+    externalLayerSourceLabel?: string;
     noInstall?: boolean;
     packageManager: PackageManagerId;
     persistencePolicy?: PersistencePolicy;
     projectDir: string;
+    repositoryReference?: string;
     templateId: BuiltInTemplateId;
     variant?: string;
     withMigrationUi?: boolean;
@@ -99,7 +103,7 @@ export interface ApplyBlockInput {
 export declare function createBuiltInBlockSpec({ answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi, withTestPreset, withWpEnv, }: Omit<PlanBlockInput, "allowExistingDir" | "cwd" | "noInstall" | "packageManager" | "projectDir" | "variant">): BlockSpec;
 export declare function buildTemplateVariablesFromBlockSpec(spec: BlockSpec): ScaffoldTemplateVariables;
 export declare class BlockGeneratorService {
-    plan({ allowExistingDir, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, noInstall, packageManager, persistencePolicy, projectDir, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }: PlanBlockInput): Promise<PlanBlockResult>;
+    plan({ allowExistingDir, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }: PlanBlockInput): Promise<PlanBlockResult>;
     validate({ plan }: ValidateBlockInput): Promise<ValidateBlockResult>;
     render({ validated }: RenderBlockInput): Promise<RenderBlockResult>;
     apply({ rendered, installDependencies, }: ApplyBlockInput): Promise<ScaffoldProjectResult>;

package/dist/runtime/block-generator-service.js

@@ -7,13 +7,14 @@ import { applyBuiltInScaffoldProjectFiles, buildGitignore, buildReadme, } from "
 import { buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, } from "./scaffold-identifiers.js";
 import { buildBuiltInBlockArtifacts, } from "./built-in-block-artifacts.js";
 import { buildBuiltInCodeArtifacts, } from "./built-in-block-code-artifacts.js";
+import { stableJsonStringify } from "./object-utils.js";
 import { getStarterManifestFiles } from "./starter-manifests.js";
 import { resolveTemplateSeed, parseTemplateLocator } from "./template-source.js";
 import { assertExternalTemplateLayersDoNotWriteProtectedOutputs, resolveExternalTemplateLayers, } from "./template-layers.js";
 import { getBuiltInTemplateOverlayDir, getBuiltInTemplateSharedLayerDirs, resolveBuiltInTemplateSourceFromLayerDirs, } from "./template-builtins.js";
 const renderedArtifactCache = new WeakMap();
 function createVariablesFingerprint(variables) {
-    return JSON.stringify(variables);
+    return stableJsonStringify(variables);
 }
 function buildProtectedTemplateOutputPaths({ codeArtifacts, spec, variables, artifacts, }) {
     const protectedOutputs = new Set([
@@ -198,7 +199,7 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
     };
 }
 export class BlockGeneratorService {
-    async plan({ allowExistingDir = false, answers, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, noInstall = false, packageManager, persistencePolicy, projectDir, templateId, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+    async plan({ allowExistingDir = false, answers, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall = false, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
         return {
             spec: createBuiltInBlockSpec({
                 answers,
@@ -214,9 +215,11 @@ export class BlockGeneratorService {
                 cwd,
                 externalLayerId,
                 externalLayerSource,
+                externalLayerSourceLabel,
                 noInstall,
                 packageManager,
                 projectDir,
+                repositoryReference,
                 variant,
             },
         };
@@ -298,7 +301,7 @@ export class BlockGeneratorService {
                         ].join("\n"));
                     }
                 };
-                warnings.push(`Applied external layer "${resolvedLayers.selectedLayerId}" from "${validated.target.externalLayerSource}".`);
+                warnings.push(`Applied external layer "${resolvedLayers.selectedLayerId}" from "${validated.target.externalLayerSourceLabel ?? validated.target.externalLayerSource}".`);
             }
             catch (error) {
                 await templateSource.cleanup?.();
@@ -360,6 +363,7 @@ export class BlockGeneratorService {
                 noInstall: rendered.target.noInstall,
                 packageManager: rendered.target.packageManager,
                 projectDir: rendered.target.projectDir,
+                repositoryReference: rendered.target.repositoryReference,
                 gitignoreContent: rendered.gitignoreContent,
                 readmeContent: rendered.readmeContent,
                 templateDir: rendered.templateDir,