@wp-typia/project-tools 0.24.11 → 0.24.13

package/dist/runtime/templates/scaffold-compiler-artifacts.js

@@ -0,0 +1,81 @@
+import path from "node:path";
+import { buildPersistenceRestArtifactPlan, } from "../add/persistence-rest-artifacts.js";
+import { buildBuiltInBlockArtifacts } from "./built-in-block-artifacts.js";
+import { emitsBuiltInPersistenceArtifacts } from "./scaffold-template-variable-groups.js";
+import { isBuiltInTemplateId, } from "./template-registry.js";
+function normalizeArtifactPath(value) {
+    return value.replace(/\\/gu, "/");
+}
+/**
+ * Build the canonical sync options for each typed block in a built-in scaffold.
+ */
+export function buildBuiltInBlockMetadataSyncOptions(projectDir, templateId, artifacts) {
+    const emitsSchemaDocuments = templateId === "persistence" || templateId === "compound";
+    return artifacts.map((artifact) => {
+        const sourceTypeName = artifact.manifestDocument.sourceType;
+        if (!sourceTypeName) {
+            throw new Error(`Built-in block artifact at ${artifact.relativeDir} is missing its source type name.`);
+        }
+        return {
+            blockJsonFile: path.join(artifact.relativeDir, "block.json"),
+            ...(emitsSchemaDocuments
+                ? {
+                    jsonSchemaFile: path.join(artifact.relativeDir, "typia.schema.json"),
+                    openApiFile: path.join(artifact.relativeDir, "typia.openapi.json"),
+                }
+                : {}),
+            manifestFile: path.join(artifact.relativeDir, "typia.manifest.json"),
+            phpValidatorFile: path.join(artifact.relativeDir, "typia-validator.php"),
+            projectRoot: projectDir,
+            sourceTypeName,
+            typesFile: path.join(artifact.relativeDir, "types.ts"),
+        };
+    });
+}
+/**
+ * Resolve the canonical REST sync input for a persistence-enabled scaffold.
+ */
+export function buildBuiltInPersistenceRestSyncOptions(projectDir, templateId, variables) {
+    if (!emitsBuiltInPersistenceArtifacts(templateId, variables)) {
+        return null;
+    }
+    const outputDir = templateId === "persistence"
+        ? "src"
+        : path.join("src", "blocks", variables.slugKebabCase);
+    return {
+        apiTypesFile: path.join(outputDir, "api-types.ts"),
+        outputDir,
+        projectDir,
+        variables,
+    };
+}
+/**
+ * Collect every compiler-derived path without executing the compiler.
+ */
+export function collectBuiltInCompilerArtifactPaths(templateId, variables) {
+    if (!isBuiltInTemplateId(templateId)) {
+        return [];
+    }
+    const artifacts = buildBuiltInBlockArtifacts({ templateId, variables });
+    const blockOptions = buildBuiltInBlockMetadataSyncOptions(".", templateId, artifacts);
+    const files = new Set(blockOptions.flatMap((options) => [
+        options.blockJsonFile,
+        options.manifestFile,
+        options.phpValidatorFile,
+        options.jsonSchemaFile,
+        options.openApiFile,
+    ]
+        .filter((value) => value !== undefined)
+        .map(normalizeArtifactPath)));
+    const persistenceOptions = buildBuiltInPersistenceRestSyncOptions(".", templateId, variables);
+    if (persistenceOptions) {
+        const plan = buildPersistenceRestArtifactPlan(persistenceOptions);
+        for (const schema of plan.schemas) {
+            files.add(normalizeArtifactPath(schema.jsonSchemaFile));
+            files.add(normalizeArtifactPath(schema.openApiFile));
+        }
+        files.add(normalizeArtifactPath(plan.openApiFile));
+        files.add(normalizeArtifactPath(plan.clientFile));
+    }
+    return [...files];
+}

package/dist/runtime/templates/scaffold-onboarding.d.ts

@@ -14,6 +14,11 @@ export declare function getOptionalSyncScriptNames(templateId: string, options?:
  * Formats optional onboarding sync commands for the selected package manager.
  */
 export declare function getOptionalOnboardingSteps(packageManager: PackageManagerId, templateId: string, options?: SyncOnboardingOptions): string[];
+/**
+ * Builds the warning shown when compiler-derived artifacts must be refreshed
+ * after dependencies become available.
+ */
+export declare function getDeferredCompilerArtifactsWarning(packageManager: PackageManagerId, templateId: string, options?: SyncOnboardingOptions): string;
 /**
  * Returns the quick-start note explaining the scaffold's primary local loop.
  */

package/dist/runtime/templates/scaffold-onboarding.js

@@ -40,6 +40,17 @@ export function getOptionalSyncScriptNames(templateId, options = {}) {
 export function getOptionalOnboardingSteps(packageManager, templateId, options = {}) {
     return getOptionalSyncScriptNames(templateId, options).map((scriptName) => formatRunScript(packageManager, scriptName));
 }
+/**
+ * Builds the warning shown when compiler-derived artifacts must be refreshed
+ * after dependencies become available.
+ */
+export function getDeferredCompilerArtifactsWarning(packageManager, templateId, options = {}) {
+    const syncSteps = getOptionalOnboardingSteps(packageManager, templateId, options);
+    const followUp = syncSteps.length > 0
+        ? `, then run ${syncSteps.map((step) => `\`${step}\``).join(", then ")} before build or typecheck`
+        : " before build or typecheck";
+    return `Compiler-derived artifacts were deferred because compiler dependencies are unavailable. Install dependencies${followUp}.`;
+}
 /**
  * Returns the quick-start note explaining the scaffold's primary local loop.
  */
@@ -58,9 +69,9 @@ export function getQuickStartWorkflowNote(packageManager, templateId = "basic",
         return `${devCommand} is the primary local entry point for this template. Use ${startCommand} for the one-shot startup flow, and ${doctorCommand} when you want a quick verification pass before build or commit.`;
     }
     if (templateHasPersistenceSync(templateId, options)) {
-        return `${devCommand} keeps the editor, type-derived artifacts, and REST-derived artifacts moving together during local development. Use ${startCommand} for a one-shot sync plus editor startup, and ${doctorCommand} when you want an explicit verification pass before build or commit.`;
+        return `${devCommand} runs a full generated-artifact sync before starting the watchers, then keeps the editor, type-derived artifacts, and REST-derived artifacts moving together during local development. Use ${startCommand} for a one-shot sync plus editor startup, and ${doctorCommand} when you want an explicit verification pass before build or commit.`;
     }
-    return `${devCommand} keeps the editor and type-derived artifacts moving together during local development. Use ${startCommand} for a one-shot sync plus editor startup, and ${doctorCommand} when you want an explicit verification pass before build or commit.`;
+    return `${devCommand} runs a full generated-artifact sync before starting the watchers, then keeps the editor and type-derived artifacts moving together during local development. Use ${startCommand} for a one-shot sync plus editor startup, and ${doctorCommand} when you want an explicit verification pass before build or commit.`;
 }
 /**
  * Returns the onboarding note explaining when manual sync is optional.

package/dist/runtime/templates/scaffold-template-variable-groups.d.ts

@@ -154,5 +154,9 @@ export type PersistenceScaffoldTemplateVariablesLike = ScaffoldTemplateVariableG
 export declare function attachScaffoldTemplateVariableGroups<TVariables extends Record<string, string>>(variables: TVariables, groups: ScaffoldTemplateVariableGroups): TVariables & ScaffoldTemplateVariableGroupsCarrier;
 export declare function getScaffoldTemplateVariableGroups(variables: ScaffoldTemplateVariableGroupsCarrier): ScaffoldTemplateVariableGroups;
 export declare function isCompoundPersistenceEnabled(variables: ScaffoldTemplateVariableGroupsCarrier): boolean;
+/**
+ * Return whether a built-in scaffold family emits compiler-derived REST files.
+ */
+export declare function emitsBuiltInPersistenceArtifacts(templateId: ScaffoldTemplateFamily, variables: ScaffoldTemplateVariableGroupsCarrier): boolean;
 export declare function getScaffoldAlternateRenderTargets(variables: ScaffoldTemplateVariableGroupsCarrier): ScaffoldAlternateRenderTargetVariableGroup;
 export {};

package/dist/runtime/templates/scaffold-template-variable-groups.js

@@ -15,6 +15,13 @@ export function isCompoundPersistenceEnabled(variables) {
     const compound = getScaffoldTemplateVariableGroups(variables).compound;
     return compound.enabled && compound.persistenceEnabled;
 }
+/**
+ * Return whether a built-in scaffold family emits compiler-derived REST files.
+ */
+export function emitsBuiltInPersistenceArtifacts(templateId, variables) {
+    return (templateId === "persistence" ||
+        (templateId === "compound" && isCompoundPersistenceEnabled(variables)));
+}
 export function getScaffoldAlternateRenderTargets(variables) {
     return getScaffoldTemplateVariableGroups(variables).alternateRenderTargets;
 }

package/dist/runtime/templates/scaffold.d.ts

@@ -172,6 +172,8 @@ interface ScaffoldProjectOptions {
     profile?: CreateProfileId;
     projectDir: string;
     repositoryReference?: string;
+    /** Whether compiler-backed metadata and REST artifacts should be seeded. */
+    seedCompilerArtifacts?: boolean;
     templateId: string;
     variant?: string;
     withMigrationUi?: boolean;
@@ -204,4 +206,4 @@ export declare function isCreateProfileId(value: string): value is CreateProfile
  * profile list for CLI diagnostics.
  */
 export declare function resolveCreateProfileId(profile?: string): CreateProfileId | undefined;
-export declare function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd, allowExistingDir, noInstall, installDependencies, onProgress, variant, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;
+export declare function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, seedCompilerArtifacts, cwd, allowExistingDir, noInstall, installDependencies, onProgress, variant, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;

package/dist/runtime/templates/scaffold.js

@@ -77,7 +77,7 @@ async function applyCreateProfile({ profile, projectDir, }) {
 async function reportScaffoldProgress(onProgress, event) {
     await onProgress?.(event);
 }
-export async function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, onProgress = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, wpVersion, }) {
+export async function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, seedCompilerArtifacts = true, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, onProgress = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, wpVersion, }) {
     const resolvedTemplateId = normalizeTemplateSelection(templateId);
     const resolvedPackageManager = getPackageManager(packageManager).id;
     const isBuiltInTemplate = isBuiltInTemplateId(resolvedTemplateId);
@@ -123,6 +123,7 @@ export async function scaffoldProject({ projectDir, templateId, answers, alterna
             installDependencies,
             onProgress,
             rendered,
+            seedCompilerArtifacts,
         });
     }
     if (externalLayerSource || externalLayerId) {

package/dist/runtime/templates/starter-manifests.js

@@ -29,5 +29,5 @@ export function getStarterManifestFiles(templateId, variables) {
  * convention.
  */
 export function stringifyStarterManifest(document) {
-    return `${JSON.stringify(document, null, "\t")}\n`;
+    return JSON.stringify(document, null, "\t");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.24.11",
+  "version": "0.24.13",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -126,8 +126,8 @@
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
     "test:quick": "bun run build && bun test tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts tests/scaffold-compound.test.ts",
-    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/package-versions.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
-    "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts",
+    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/cli-doctor-boundaries.test.ts tests/cli-doctor-standalone-shared.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/package-versions.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
+    "test:workspace": "bun run build && bun test tests/cli-add-workspace-mutation.test.ts tests/cli-add-workspace-boundaries.test.ts tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
     "test:migration-planning": "bun run build && bun test tests/migration-init.test.ts tests/migration-config.test.ts tests/migration-plan-wizard.test.ts",
     "test:migration-execution": "bun run build && bun test tests/migration-scaffold-diff.test.ts tests/migration-doctor.test.ts tests/migration-fixtures-fuzz.test.ts",
@@ -166,9 +166,9 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.6",
-    "@wp-typia/block-runtime": "^0.7.1",
+    "@wp-typia/block-runtime": "^0.7.2",
     "@wp-typia/rest": "^0.3.14",
-    "@wp-typia/block-types": "^0.3.5",
+    "@wp-typia/block-types": "^0.4.0",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
     "semver": "^7.7.3",

package/templates/_shared/compound/core/scripts/add-compound-child.ts.mustache

@@ -347,7 +347,7 @@ function createCompoundChildStarterManifest(
 }
 
 function stringifyStarterManifest( document: StarterManifestDocument ): string {
-	return `${ JSON.stringify( document, null, '\t' ) }\n`;
+	return JSON.stringify( document, null, '\t' );
 }
 
 function insertBeforeMarker( filePath: string, marker: string, insertionLines: string[] ) {

package/templates/_shared/compound/persistence/package.json.mustache

@@ -43,6 +43,7 @@
     "@wordpress/block-editor": "~15.19.0",
     "@wordpress/blocks": "~15.19.0",
     "@wordpress/components": "^30.2.0",
+    "@wordpress/data": "~10.46.0",
     "@wordpress/element": "^6.29.0",
     "@wordpress/i18n": "^6.2.0",
     "@wordpress/interactivity": "^6.29.0"

package/templates/_shared/persistence/core/package.json.mustache

@@ -40,6 +40,7 @@
 		"@wordpress/block-editor": "~15.19.0",
 		"@wordpress/blocks": "~15.19.0",
 		"@wordpress/components": "^30.2.0",
+		"@wordpress/data": "~10.46.0",
 		"@wordpress/element": "^6.29.0",
 		"@wordpress/i18n": "^6.2.0",
 		"@wordpress/interactivity": "^6.29.0"