@wp-typia/project-tools 0.24.3 → 0.24.4

package/dist/runtime/block-targets.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Caller-owned error messages for full block name validation.
+ */
+export interface FullBlockNameDiagnostics {
+    /**
+     * Message returned when the candidate block name is empty.
+     */
+    empty: () => string;
+    /**
+     * Message returned when the candidate is not `namespace/block-slug`.
+     */
+    invalidFormat: () => string;
+}
 export interface WorkspaceBlockTargetName {
     blockName: string;
     blockSlug: string;
@@ -12,11 +25,11 @@ export interface WorkspaceBlockTargetDiagnostics {
  * Validate a full `namespace/block-slug` block name.
  *
  * @param blockName Candidate block name.
- * @param flagName CLI flag name used in diagnostics.
+ * @param diagnostics CLI flag name or diagnostic builders for caller-owned UX.
  * @returns The trimmed full block name.
  * @throws {Error} When the block name is empty or not a full block name.
  */
-export declare function assertFullBlockName(blockName: string, flagName: string): string;
+export declare function assertFullBlockName(blockName: string, diagnostics: string | FullBlockNameDiagnostics): string;
 /**
  * Resolve a workspace block target from either `block-slug` or
  * `namespace/block-slug` input while preserving caller-owned diagnostics.

package/dist/runtime/block-targets.js

@@ -1,20 +1,30 @@
 import { normalizeBlockSlug } from "./scaffold-identifiers.js";
 const FULL_BLOCK_NAME_PATTERN = /^[a-z0-9-]+\/[a-z0-9-]+$/u;
+function resolveFullBlockNameDiagnostics(diagnostics) {
+    if (typeof diagnostics !== "string") {
+        return diagnostics;
+    }
+    return {
+        empty: () => `\`${diagnostics}\` requires a block name.`,
+        invalidFormat: () => `\`${diagnostics}\` must use <namespace/block-slug> format.`,
+    };
+}
 /**
  * Validate a full `namespace/block-slug` block name.
  *
  * @param blockName Candidate block name.
- * @param flagName CLI flag name used in diagnostics.
+ * @param diagnostics CLI flag name or diagnostic builders for caller-owned UX.
  * @returns The trimmed full block name.
  * @throws {Error} When the block name is empty or not a full block name.
  */
-export function assertFullBlockName(blockName, flagName) {
+export function assertFullBlockName(blockName, diagnostics) {
+    const messages = resolveFullBlockNameDiagnostics(diagnostics);
     const trimmed = blockName.trim();
     if (!trimmed) {
-        throw new Error(`\`${flagName}\` requires a block name.`);
+        throw new Error(messages.empty());
     }
     if (!FULL_BLOCK_NAME_PATTERN.test(trimmed)) {
-        throw new Error(`\`${flagName}\` must use <namespace/block-slug> format.`);
+        throw new Error(messages.invalidFormat());
     }
     return trimmed;
 }

package/dist/runtime/cli-add-types.d.ts

@@ -1,4 +1,5 @@
 import { PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, type PatternCatalogScope } from "./pattern-catalog.js";
+import type { FullBlockNameDiagnostics } from "./block-targets.js";
 export { ADD_KIND_IDS } from "./cli-add-kind-ids.js";
 export type { AddKindId } from "./cli-add-kind-ids.js";
 export { PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, };
@@ -95,11 +96,14 @@ export interface RunAddVariationCommandOptions {
  *
  * @property cwd Working directory used to resolve the nearest official workspace.
  * @property targetBlockName Full `namespace/block` name that receives the variation.
+ * @property targetBlockNameDiagnostics Optional diagnostics for positional target
+ * block names. Omitted callers keep legacy target diagnostics.
  * @property variationName Human-entered variation name normalized into a slug.
  */
 export interface RunAddCoreVariationCommandOptions {
     cwd?: string;
     targetBlockName: string;
+    targetBlockNameDiagnostics?: string | FullBlockNameDiagnostics;
     variationName: string;
 }
 /**

package/dist/runtime/cli-add-workspace-core-variation.d.ts

@@ -13,7 +13,7 @@ import { type RunAddCoreVariationCommandOptions } from "./cli-add-shared.js";
  * target block name is not full `namespace/block` form, or the generated file
  * already exists.
  */
-export declare function runAddCoreVariationCommand({ cwd, targetBlockName, variationName, }: RunAddCoreVariationCommandOptions): Promise<{
+export declare function runAddCoreVariationCommand({ cwd, targetBlockName, targetBlockNameDiagnostics, variationName, }: RunAddCoreVariationCommandOptions): Promise<{
     projectDir: string;
     targetBlockName: string;
     variationFile: string;

package/dist/runtime/cli-add-workspace-core-variation.js

@@ -369,9 +369,9 @@ async function writeCoreVariationRegistry(projectDir, targetBlockName, textDomai
  * target block name is not full `namespace/block` form, or the generated file
  * already exists.
  */
-export async function runAddCoreVariationCommand({ cwd = process.cwd(), targetBlockName, variationName, }) {
+export async function runAddCoreVariationCommand({ cwd = process.cwd(), targetBlockName, targetBlockNameDiagnostics = "core-variation target", variationName, }) {
     const workspace = resolveWorkspaceProject(cwd);
-    const resolvedTargetBlockName = assertFullBlockName(targetBlockName, "core-variation target");
+    const resolvedTargetBlockName = assertFullBlockName(targetBlockName, targetBlockNameDiagnostics);
     const variationSlug = assertValidGeneratedSlug("Core variation name", normalizeBlockSlug(variationName), CORE_VARIATION_USAGE);
     const unknownCoreTargetWarning = getUnknownCoreVariationTargetWarning(resolvedTargetBlockName);
     assertCoreVariationSlugIsNotRegistryIndex(variationSlug);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.24.3",
+  "version": "0.24.4",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",