@wp-typia/project-tools 0.24.3 → 0.24.5

package/dist/runtime/cli-templates.js

@@ -1,166 +1 @@
-import { OFFICIAL_WORKSPACE_TEMPLATE_ALIAS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, getUserFacingTemplateId, getTemplateById, getTemplateSelectOptions, isBuiltInTemplateId, listTemplates, } from "./template-registry.js";
-/**
- * Format one line of template list output for a built-in template.
- *
- * @param template Template metadata including `id` and `description`.
- * @returns One-line summary text for `templates list`.
- */
-export function formatTemplateSummary(template) {
-    return `${getUserFacingTemplateId(template.id).padEnd(14)} ${template.description}`;
-}
-/**
- * Format the feature and capability hint lines shown under a template summary.
- *
- * @param template Template metadata including the `features` list.
- * @returns Indented feature and capability text for CLI list output.
- */
-export function formatTemplateFeatures(template) {
-    const lines = [`  Features: ${template.features.join(" • ")}`];
-    const bestForHint = getTemplateBestForHint(template);
-    if (bestForHint) {
-        lines.push(`  Best for: ${bestForHint}`);
-    }
-    const capabilityHints = getTemplateCapabilityHints(template);
-    if (capabilityHints.length > 0) {
-        lines.push(`  Supports: ${capabilityHints.join(" • ")}`);
-    }
-    const specialNotes = getTemplateSpecialNotes(template);
-    if (specialNotes.length > 0) {
-        lines.push(`  Notes: ${specialNotes.join(" • ")}`);
-    }
-    if (template.id === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
-        lines.push(`  Alias: ${OFFICIAL_WORKSPACE_TEMPLATE_ALIAS} (\`--template ${OFFICIAL_WORKSPACE_TEMPLATE_ALIAS}\`)`);
-    }
-    return lines.join("\n");
-}
-/**
- * Format the detailed template description for `templates inspect`.
- *
- * This expands special layer combinations for the `persistence` and `compound`
- * templates and returns a multi-line block centered on human-facing identity,
- * capabilities, and logical layer composition.
- *
- * @param template Template metadata including `id`, `defaultCategory`,
- * `templateDir`, and `features`.
- * @returns Multi-line template details text for CLI output.
- */
-export function formatTemplateDetails(template) {
-    const detailLines = [
-        getUserFacingTemplateId(template.id),
-        `Summary: ${template.description}`,
-        `Best for: ${getTemplateBestForHint(template)}`,
-        ...getTemplateIdentityLines(template),
-        `Category: ${template.defaultCategory}`,
-    ];
-    const capabilityHints = getTemplateCapabilityHints(template);
-    if (capabilityHints.length > 0) {
-        detailLines.push("Capabilities:");
-        for (const capabilityHint of capabilityHints) {
-            detailLines.push(`  - ${capabilityHint}`);
-        }
-    }
-    const specialNotes = getTemplateSpecialNotes(template);
-    if (specialNotes.length > 0) {
-        detailLines.push("Notes:");
-        for (const specialNote of specialNotes) {
-            detailLines.push(`  - ${specialNote}`);
-        }
-    }
-    detailLines.push("Logical layers:");
-    for (const logicalLayer of getTemplateLogicalLayerSummaries(template)) {
-        detailLines.push(`  - ${logicalLayer}`);
-    }
-    detailLines.push(`Features: ${template.features.join(", ")}`);
-    return detailLines.join("\n");
-}
-function getTemplateBestForHint(template) {
-    if (template.id === "basic") {
-        return "minimal static-first block scaffolds with Typia validation and the lightest default surface";
-    }
-    if (template.id === "interactivity") {
-        return "interactive single-block experiences that keep client-side state and actions inside one scaffold";
-    }
-    if (template.id === "persistence") {
-        return "typed REST-backed blocks that need persistence-aware reads, writes, and schema refresh workflows";
-    }
-    if (template.id === "compound") {
-        return "parent-and-child block families that own nested authoring conventions and optional persistence wiring";
-    }
-    if (template.id === "query-loop") {
-        return "create-time `core/query` variations with connected starter patterns instead of `add block` families";
-    }
-    return "official multi-block workspaces that extend through `wp-typia add ...` and workspace doctor flows";
-}
-function getTemplateCapabilityHints(template) {
-    if (template.id === "persistence" || template.id === "compound") {
-        return [
-            "--alternate-render-targets",
-            "--data-storage",
-            "--persistence-policy",
-            "external layers",
-        ];
-    }
-    if (template.id === "query-loop") {
-        return ["--query-post-type", "external layers"];
-    }
-    if (isBuiltInTemplateId(template.id)) {
-        return ["external layers"];
-    }
-    return [];
-}
-function getTemplateSpecialNotes(template) {
-    if (template.id === "query-loop") {
-        return [
-            "Create-time variation scaffold only; use `wp-typia create <project-dir> --template query-loop` instead of `wp-typia add block`.",
-            "Owns a `core/query` variation, so it does not generate `src/types.ts`, `block.json`, or Typia manifests.",
-        ];
-    }
-    return [];
-}
-function getTemplateIdentityLines(template) {
-    if (template.id === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
-        return [
-            "Identity:",
-            `  - User-facing alias: ${OFFICIAL_WORKSPACE_TEMPLATE_ALIAS} (\`--template ${OFFICIAL_WORKSPACE_TEMPLATE_ALIAS}\`)`,
-            `  - Official package: ${OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE}`,
-            "Type: official workspace scaffold",
-        ];
-    }
-    if (template.id === "query-loop") {
-        return [
-            "Identity:",
-            "  - Built-in template id: query-loop",
-            "Type: create-time core/query variation scaffold",
-            "Output model: variation-only scaffold; does not generate block.json or Typia manifests",
-        ];
-    }
-    return [
-        "Identity:",
-        `  - Built-in template id: ${template.id}`,
-        "Type: built-in block scaffold",
-    ];
-}
-function getTemplateLogicalLayerSummaries(template) {
-    if (!isBuiltInTemplateId(template.id)) {
-        return ["workspace package scaffold"];
-    }
-    if (template.id === "persistence") {
-        return [
-            "authenticated write policy: shared/base -> rest helpers (shared) -> persistence core -> authenticated write policy -> persistence overlay",
-            "public write policy: shared/base -> rest helpers (shared) -> persistence core -> public write policy -> persistence overlay",
-        ];
-    }
-    if (template.id === "compound") {
-        return [
-            "pure block family: shared/base -> compound core -> compound overlay",
-            "authenticated persistence: shared/base -> compound core -> rest helpers (shared) -> compound persistence core -> authenticated write policy -> compound overlay",
-            "public persistence: shared/base -> compound core -> rest helpers (shared) -> compound persistence core -> public write policy -> compound overlay",
-        ];
-    }
-    const overlayName = template.id === "query-loop" ? "query-loop overlay" : `${template.id} overlay`;
-    return [
-        `shared/base -> ${overlayName}`,
-    ];
-}
-export { getTemplateById, getTemplateSelectOptions, listTemplates };
-export { isBuiltInTemplateId };
+export * from "./templates/cli-templates.js";

package/dist/runtime/cli-validation.d.ts

@@ -1,66 +1 @@
-/**
- * Normalize one optional CLI string flag by trimming whitespace and collapsing
- * empty strings to `undefined`.
- *
- * @param value Raw CLI value before normalization.
- * @returns The trimmed string when present, otherwise `undefined`.
- */
-export declare function normalizeOptionalCliString(value?: string): string | undefined;
-/**
- * Resolve one CLI path flag relative to the caller when it is expressed as a
- * local filesystem path.
- *
- * Non-local values such as npm package specs or `github:` locators pass
- * through unchanged. Local relative and absolute paths are resolved against the
- * provided `cwd` and must exist on disk.
- *
- * @param options Path resolution inputs for one CLI flag.
- * @param options.cwd Caller working directory used for relative path
- * resolution.
- * @param options.label Human-readable option label used in thrown errors.
- * @param options.value Raw CLI value before trimming and path resolution.
- * @returns The normalized string, or `undefined` when the option was omitted.
- * @throws When a local-looking path resolves to a missing filesystem entry.
- */
-export declare function resolveLocalCliPathOption(options: {
-    cwd: string;
-    label: string;
-    value?: string;
-}): string | undefined;
-/**
- * Validate the built-in template composition rule for external layers.
- *
- * @param options External layer CLI options after normalization.
- * @param options.externalLayerId Optional selected layer id.
- * @param options.externalLayerSource Optional layer source locator or path.
- * @throws When `externalLayerId` is provided without `externalLayerSource`.
- */
-export declare function assertExternalLayerCompositionOptions(options: {
-    externalLayerId?: string;
-    externalLayerSource?: string;
-}): void;
-/**
- * Build the shared error message used when a built-in template receives a
- * `--variant` override.
- *
- * @param options Built-in template context.
- * @param options.templateId Built-in template id that rejected the variant.
- * @param options.variant User-supplied variant override.
- * @returns The canonical user-facing error message.
- */
-export declare function createBuiltInVariantErrorMessage(options: {
-    templateId: string;
-    variant: string;
-}): string;
-/**
- * Reject unsupported `--variant` usage for built-in templates.
- *
- * @param options Built-in template validation context.
- * @param options.templateId Built-in template id being scaffolded.
- * @param options.variant Optional variant override from CLI flags.
- * @throws When a built-in template receives any explicit `--variant` value.
- */
-export declare function assertBuiltInTemplateVariantAllowed(options: {
-    templateId: string;
-    variant?: string;
-}): void;
+export * from "./cli/cli-validation.js";

package/dist/runtime/cli-validation.js

@@ -1,93 +1 @@
-import fs from "node:fs";
-import path from "node:path";
-import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from "./cli-diagnostics.js";
-/**
- * Normalize one optional CLI string flag by trimming whitespace and collapsing
- * empty strings to `undefined`.
- *
- * @param value Raw CLI value before normalization.
- * @returns The trimmed string when present, otherwise `undefined`.
- */
-export function normalizeOptionalCliString(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-function looksLikeLocalCliPath(value) {
-    return (path.isAbsolute(value) ||
-        value.startsWith("./") ||
-        value.startsWith("../") ||
-        value.startsWith(".\\") ||
-        value.startsWith("..\\"));
-}
-/**
- * Resolve one CLI path flag relative to the caller when it is expressed as a
- * local filesystem path.
- *
- * Non-local values such as npm package specs or `github:` locators pass
- * through unchanged. Local relative and absolute paths are resolved against the
- * provided `cwd` and must exist on disk.
- *
- * @param options Path resolution inputs for one CLI flag.
- * @param options.cwd Caller working directory used for relative path
- * resolution.
- * @param options.label Human-readable option label used in thrown errors.
- * @param options.value Raw CLI value before trimming and path resolution.
- * @returns The normalized string, or `undefined` when the option was omitted.
- * @throws When a local-looking path resolves to a missing filesystem entry.
- */
-export function resolveLocalCliPathOption(options) {
-    const normalizedValue = normalizeOptionalCliString(options.value);
-    if (!normalizedValue || !looksLikeLocalCliPath(normalizedValue)) {
-        return normalizedValue;
-    }
-    const resolvedPath = path.resolve(options.cwd, normalizedValue);
-    if (!fs.existsSync(resolvedPath)) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `\`${options.label}\` path does not exist: ${resolvedPath}. Check the path relative to ${options.cwd}.`);
-    }
-    return resolvedPath;
-}
-/**
- * Validate the built-in template composition rule for external layers.
- *
- * @param options External layer CLI options after normalization.
- * @param options.externalLayerId Optional selected layer id.
- * @param options.externalLayerSource Optional layer source locator or path.
- * @throws When `externalLayerId` is provided without `externalLayerSource`.
- */
-export function assertExternalLayerCompositionOptions(options) {
-    if (options.externalLayerId && !options.externalLayerSource) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, "externalLayerId requires externalLayerSource when composing built-in template layers.");
-    }
-}
-/**
- * Build the shared error message used when a built-in template receives a
- * `--variant` override.
- *
- * @param options Built-in template context.
- * @param options.templateId Built-in template id that rejected the variant.
- * @param options.variant User-supplied variant override.
- * @returns The canonical user-facing error message.
- */
-export function createBuiltInVariantErrorMessage(options) {
-    return `--variant is only supported for official external template configs. Received variant "${options.variant}" for built-in template "${options.templateId}".`;
-}
-/**
- * Reject unsupported `--variant` usage for built-in templates.
- *
- * @param options Built-in template validation context.
- * @param options.templateId Built-in template id being scaffolded.
- * @param options.variant Optional variant override from CLI flags.
- * @throws When a built-in template receives any explicit `--variant` value.
- */
-export function assertBuiltInTemplateVariantAllowed(options) {
-    if (!options.variant) {
-        return;
-    }
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, createBuiltInVariantErrorMessage({
-        templateId: options.templateId,
-        variant: options.variant,
-    }));
-}
+export * from "./cli/cli-validation.js";

package/dist/runtime/compound-inner-blocks.d.ts

@@ -1,78 +1 @@
-/**
- * Stable preset ids exposed to scaffold and UI consumers for compound
- * InnerBlocks authoring behavior.
- */
-export declare const COMPOUND_INNER_BLOCKS_PRESET_IDS: readonly ["freeform", "ordered", "horizontal", "locked-structure"];
-export type CompoundInnerBlocksPresetId = (typeof COMPOUND_INNER_BLOCKS_PRESET_IDS)[number];
-/**
- * Default preset applied when callers do not provide an explicit compound
- * InnerBlocks mode.
- */
-export declare const DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID: CompoundInnerBlocksPresetId;
-export type CompoundInnerBlocksOrientation = "horizontal" | "vertical";
-export type CompoundInnerBlocksTemplateLock = false | "insert" | "all";
-/**
- * Runtime-facing description of one compound InnerBlocks preset.
- */
-export interface CompoundInnerBlocksPresetDefinition {
-    description: string;
-    directInsert: boolean;
-    label: string;
-    orientation?: CompoundInnerBlocksOrientation;
-    templateLock: CompoundInnerBlocksTemplateLock;
-}
-/**
- * Canonical preset registry used by the CLI, generated scaffolds, and TUI
- * forms.
- */
-export declare const COMPOUND_INNER_BLOCKS_PRESET_REGISTRY: {
-    readonly freeform: {
-        readonly description: "Unlocked nested authoring with the default inserter and starter child template.";
-        readonly directInsert: false;
-        readonly label: "freeform";
-        readonly orientation: "vertical";
-        readonly templateLock: false;
-    };
-    readonly ordered: {
-        readonly description: "Vertical ordered flow that keeps starter structure fixed while allowing new sibling inserts.";
-        readonly directInsert: true;
-        readonly label: "ordered";
-        readonly orientation: "vertical";
-        readonly templateLock: "insert";
-    };
-    readonly horizontal: {
-        readonly description: "Horizontal nested layout with one-click direct inserts for row or tab style containers.";
-        readonly directInsert: true;
-        readonly label: "horizontal";
-        readonly orientation: "horizontal";
-        readonly templateLock: false;
-    };
-    readonly "locked-structure": {
-        readonly description: "Locked starter structure for guided document shells where authors should only edit seeded children.";
-        readonly directInsert: false;
-        readonly label: "locked-structure";
-        readonly orientation: "vertical";
-        readonly templateLock: "all";
-    };
-};
-/**
- * Returns whether a string matches one of the supported compound preset ids.
- */
-export declare function isCompoundInnerBlocksPresetId(value: string): value is CompoundInnerBlocksPresetId;
-/**
- * Parses a raw CLI or config value into a supported preset id.
- *
- * Returns `undefined` for non-string or empty input, and throws when the input
- * is a non-empty unsupported preset id.
- */
-export declare function parseCompoundInnerBlocksPreset(value?: string): CompoundInnerBlocksPresetId | undefined;
-/**
- * Resolves an optional preset id to a concrete preset, defaulting to
- * `DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID`.
- */
-export declare function resolveCompoundInnerBlocksPreset(value?: CompoundInnerBlocksPresetId): CompoundInnerBlocksPresetId;
-/**
- * Looks up the preset definition for the provided preset id, applying the
- * default preset when the input is omitted.
- */
-export declare function getCompoundInnerBlocksPresetDefinition(value?: CompoundInnerBlocksPresetId): CompoundInnerBlocksPresetDefinition;
+export * from "./add/compound-inner-blocks.js";

package/dist/runtime/compound-inner-blocks.js

@@ -1,88 +1 @@
-/**
- * Stable preset ids exposed to scaffold and UI consumers for compound
- * InnerBlocks authoring behavior.
- */
-export const COMPOUND_INNER_BLOCKS_PRESET_IDS = [
-    "freeform",
-    "ordered",
-    "horizontal",
-    "locked-structure",
-];
-/**
- * Default preset applied when callers do not provide an explicit compound
- * InnerBlocks mode.
- */
-export const DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID = "freeform";
-/**
- * Canonical preset registry used by the CLI, generated scaffolds, and TUI
- * forms.
- */
-export const COMPOUND_INNER_BLOCKS_PRESET_REGISTRY = {
-    freeform: {
-        description: "Unlocked nested authoring with the default inserter and starter child template.",
-        directInsert: false,
-        label: "freeform",
-        orientation: "vertical",
-        templateLock: false,
-    },
-    ordered: {
-        description: "Vertical ordered flow that keeps starter structure fixed while allowing new sibling inserts.",
-        directInsert: true,
-        label: "ordered",
-        orientation: "vertical",
-        templateLock: "insert",
-    },
-    horizontal: {
-        description: "Horizontal nested layout with one-click direct inserts for row or tab style containers.",
-        directInsert: true,
-        label: "horizontal",
-        orientation: "horizontal",
-        templateLock: false,
-    },
-    "locked-structure": {
-        description: "Locked starter structure for guided document shells where authors should only edit seeded children.",
-        directInsert: false,
-        label: "locked-structure",
-        orientation: "vertical",
-        templateLock: "all",
-    },
-};
-/**
- * Returns whether a string matches one of the supported compound preset ids.
- */
-export function isCompoundInnerBlocksPresetId(value) {
-    return COMPOUND_INNER_BLOCKS_PRESET_IDS.includes(value);
-}
-/**
- * Parses a raw CLI or config value into a supported preset id.
- *
- * Returns `undefined` for non-string or empty input, and throws when the input
- * is a non-empty unsupported preset id.
- */
-export function parseCompoundInnerBlocksPreset(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const normalizedValue = value.trim();
-    if (normalizedValue.length === 0) {
-        return undefined;
-    }
-    if (!isCompoundInnerBlocksPresetId(normalizedValue)) {
-        throw new Error(`Unsupported InnerBlocks preset "${value}". Expected one of: ${COMPOUND_INNER_BLOCKS_PRESET_IDS.join(", ")}.`);
-    }
-    return normalizedValue;
-}
-/**
- * Resolves an optional preset id to a concrete preset, defaulting to
- * `DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID`.
- */
-export function resolveCompoundInnerBlocksPreset(value) {
-    return value ?? DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID;
-}
-/**
- * Looks up the preset definition for the provided preset id, applying the
- * default preset when the input is omitted.
- */
-export function getCompoundInnerBlocksPresetDefinition(value) {
-    return COMPOUND_INNER_BLOCKS_PRESET_REGISTRY[resolveCompoundInnerBlocksPreset(value)];
-}
+export * from "./add/compound-inner-blocks.js";

package/dist/runtime/contract-artifacts.d.ts

@@ -1,14 +1 @@
-interface SyncStandaloneContractArtifactsOptions {
-    projectDir: string;
-    schemaFile: string;
-    sourceTypeName: string;
-    typesFile: string;
-}
-/**
- * Generate the JSON Schema artifact for a standalone TypeScript contract.
- *
- * @param options Workspace-relative type/schema paths plus the exported source
- * type name.
- */
-export declare function syncStandaloneContractArtifacts({ projectDir, schemaFile, sourceTypeName, typesFile, }: SyncStandaloneContractArtifactsOptions): Promise<void>;
-export {};
+export * from "./add/contract-artifacts.js";

package/dist/runtime/contract-artifacts.js

@@ -1,15 +1 @@
-import { syncTypeSchemas, } from "@wp-typia/block-runtime/metadata-core";
-/**
- * Generate the JSON Schema artifact for a standalone TypeScript contract.
- *
- * @param options Workspace-relative type/schema paths plus the exported source
- * type name.
- */
-export async function syncStandaloneContractArtifacts({ projectDir, schemaFile, sourceTypeName, typesFile, }) {
-    await syncTypeSchemas({
-        jsonSchemaFile: schemaFile,
-        projectRoot: projectDir,
-        sourceTypeName,
-        typesFile,
-    });
-}
+export * from "./add/contract-artifacts.js";

package/dist/runtime/create-template-validation.d.ts

@@ -1,10 +1 @@
-export declare const CREATE_TEMPLATE_SELECTION_HINT: string;
-/**
- * Validate an explicitly supplied create template id before entering the full
- * scaffold flow.
- *
- * Built-in template ids and the workspace alias resolve immediately, common
- * built-in typos keep suggestion diagnostics, and explicit external template
- * locators remain deferred to the external template resolver.
- */
-export declare function validateExplicitCreateTemplateId(templateId: string): string;
+export * from "./templates/create-template-validation.js";

package/dist/runtime/create-template-validation.js

@@ -1,95 +1 @@
-import path from "node:path";
-import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from "./cli-diagnostics.js";
-import { OFFICIAL_WORKSPACE_TEMPLATE_ALIAS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from "./template-registry.js";
-import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
-import { parseNpmTemplateLocator } from "./template-source-locators.js";
-import { suggestCloseId } from "./id-suggestions.js";
-export const CREATE_TEMPLATE_SELECTION_HINT = `--template <${[
-    ...TEMPLATE_IDS,
-    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
-].join("|")}|./path|github:owner/repo/path[#ref]|npm-package>`;
-const TEMPLATE_SUGGESTION_IDS = [
-    ...TEMPLATE_IDS,
-    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
-];
-const USER_FACING_TEMPLATE_IDS = [
-    ...TEMPLATE_IDS,
-    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
-];
-function normalizeCreateTemplateSelection(templateId) {
-    return templateId === OFFICIAL_WORKSPACE_TEMPLATE_ALIAS
-        ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
-        : templateId;
-}
-function looksLikeWindowsAbsoluteTemplatePath(templateId) {
-    return /^[a-z]:[\\/]/iu.test(templateId) || /^\\\\[^\\]+\\[^\\]+/u.test(templateId);
-}
-function looksLikeExplicitNonNpmExternalTemplateLocator(templateId) {
-    return (path.isAbsolute(templateId) ||
-        looksLikeWindowsAbsoluteTemplatePath(templateId) ||
-        templateId.startsWith("./") ||
-        templateId.startsWith(".\\") ||
-        templateId.startsWith("../") ||
-        templateId.startsWith("..\\") ||
-        templateId.startsWith("@") ||
-        templateId.startsWith("github:") ||
-        templateId.includes("/") ||
-        templateId.includes("\\"));
-}
-function looksLikeExplicitCreateExternalTemplateLocator(templateId) {
-    return (looksLikeExplicitNonNpmExternalTemplateLocator(templateId) ||
-        parseNpmTemplateLocator(templateId) !== null);
-}
-function findMistypedBuiltInTemplateSuggestion(templateId) {
-    const normalizedTemplateId = templateId.trim().toLowerCase();
-    if (normalizedTemplateId.length === 0 ||
-        looksLikeExplicitNonNpmExternalTemplateLocator(normalizedTemplateId)) {
-        return null;
-    }
-    return suggestCloseId(normalizedTemplateId, TEMPLATE_SUGGESTION_IDS);
-}
-function getMistypedBuiltInTemplateMessage(templateId) {
-    const suggestion = findMistypedBuiltInTemplateSuggestion(templateId);
-    if (!suggestion) {
-        return null;
-    }
-    const suggestionDescription = suggestion === OFFICIAL_WORKSPACE_TEMPLATE_ALIAS
-        ? "official workspace scaffold"
-        : "built-in scaffold";
-    return `Unknown template "${templateId}". Did you mean "${suggestion}"? Use \`--template ${suggestion}\` for the ${suggestionDescription}, or pass a local path, \`github:owner/repo/path[#ref]\`, or an npm package spec for an external template.`;
-}
-function getUnknownTemplateMessage(templateId) {
-    return [
-        `Unknown template "${templateId}". Expected one of: ${USER_FACING_TEMPLATE_IDS.join(", ")}.`,
-        "Run `wp-typia templates list` to inspect available templates.",
-        "Pass an explicit external template locator such as `./path`, `github:owner/repo/path[#ref]`, or `@scope/template` for custom templates.",
-    ].join(" ");
-}
-/**
- * Validate an explicitly supplied create template id before entering the full
- * scaffold flow.
- *
- * Built-in template ids and the workspace alias resolve immediately, common
- * built-in typos keep suggestion diagnostics, and explicit external template
- * locators remain deferred to the external template resolver.
- */
-export function validateExplicitCreateTemplateId(templateId) {
-    const normalizedTemplateId = normalizeCreateTemplateSelection(templateId);
-    if (isRemovedBuiltInTemplateId(templateId)) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getRemovedBuiltInTemplateMessage(templateId));
-    }
-    if (normalizedTemplateId === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
-        return normalizedTemplateId;
-    }
-    if (isBuiltInTemplateId(normalizedTemplateId)) {
-        return getTemplateById(normalizedTemplateId).id;
-    }
-    const mistypedBuiltInTemplateMessage = getMistypedBuiltInTemplateMessage(templateId);
-    if (mistypedBuiltInTemplateMessage) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, mistypedBuiltInTemplateMessage);
-    }
-    if (!looksLikeExplicitCreateExternalTemplateLocator(normalizedTemplateId)) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getUnknownTemplateMessage(templateId));
-    }
-    return normalizedTemplateId;
-}
+export * from "./templates/create-template-validation.js";

package/dist/runtime/doctor/cli-doctor-environment.d.ts

@@ -0,0 +1,12 @@
+import type { DoctorCheck } from "./cli-doctor.js";
+/**
+ * Collect environment-scoped doctor checks for the current working directory.
+ *
+ * The returned rows cover Bun/Node/git availability, writability of the
+ * current working directory and OS temp directory, and built-in or external
+ * template asset integrity in display order.
+ *
+ * @param cwd Working directory validated for writability.
+ * @returns Ordered environment check rows ready for CLI rendering.
+ */
+export declare function getEnvironmentDoctorChecks(cwd: string): Promise<DoctorCheck[]>;