@wp-typia/project-tools 0.21.0 → 0.22.0

package/dist/runtime/cli-doctor-workspace.js

@@ -814,15 +814,16 @@ function checkWorkspaceAdminViewConfig(adminView, inventory) {
         return createDoctorCheck(`Admin view config ${adminView.slug}`, "pass", "Admin view uses a replaceable local fetcher");
     }
     const source = adminView.source.trim();
-    const sourceMatch = /^rest-resource:([a-z][a-z0-9-]*)$/u.exec(source);
-    const restResourceSlug = sourceMatch?.[1];
+    const restSourceMatch = /^rest-resource:([a-z][a-z0-9-]*)$/u.exec(source);
+    const coreDataSourceMatch = /^core-data:(postType|taxonomy)\/([a-z0-9][a-z0-9_-]*)$/u.exec(source);
+    const restResourceSlug = restSourceMatch?.[1];
     const restResource = restResourceSlug
         ? inventory.restResources.find((entry) => entry.slug === restResourceSlug)
         : undefined;
-    const isValid = Boolean(restResource?.methods.includes("list"));
+    const isValid = Boolean(restResource?.methods.includes("list")) || Boolean(coreDataSourceMatch);
     return createDoctorCheck(`Admin view config ${adminView.slug}`, isValid ? "pass" : "fail", isValid
         ? `Admin view source ${source} is list-capable`
-        : "Admin view source must use rest-resource:<slug> and reference a list-capable REST resource");
+        : "Admin view source must use rest-resource:<slug> with a list-capable REST resource or core-data:<postType|taxonomy>/<name>");
 }
 function checkWorkspaceAdminViewBootstrap(projectDir, packageName, phpPrefix) {
     const packageBaseName = packageName.split("/").pop() ?? packageName;

package/dist/runtime/cli-help.js

@@ -18,7 +18,7 @@ export function formatHelpText() {
   wp-typia create <project-dir> [--template compound] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
   wp-typia <project-dir> [create flags...]
   wp-typia init [project-dir] [--apply] [--package-manager <id>]
-  wp-typia add admin-view <name> [--source <rest-resource:slug>]
+  wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]
   wp-typia add block <name> [--template <basic|interactivity|persistence|compound>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>]
   wp-typia add variation <name> --block <block-slug>
   wp-typia add style <name> --block <block-slug>
@@ -49,7 +49,10 @@ Notes:
   \`wp-typia init\` previews the minimum retrofit sync surface by default; rerun with \`--apply\` to write package.json updates and generated helper scripts.
   Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
   Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
-  \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`; pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
+  \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
+  Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
+  Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
+  Public installs currently gate this workflow until \`@wp-typia/dataviews\` is published to npm.
   \`query-loop\` is create-only. Use \`wp-typia create <project-dir> --template query-loop\`; \`wp-typia add block\` accepts only basic, interactivity, persistence, and compound families.
   \`add variation\` uses an existing workspace block from \`scripts/block-config.ts\`.
   \`add style\` registers a Block Styles option for an existing generated block.

package/dist/runtime/external-layer-selection.d.ts

@@ -1,4 +1,5 @@
-import { type SelectableExternalTemplateLayer } from "./template-layers.js";
+import { resolveTemplateSeed } from "./template-source.js";
+import { listSelectableExternalTemplateLayers, type SelectableExternalTemplateLayer } from "./template-layers.js";
 export interface ExternalLayerSelectionOption extends SelectableExternalTemplateLayer {
 }
 export interface ResolvedExternalLayerSelection {
@@ -6,9 +7,14 @@ export interface ResolvedExternalLayerSelection {
     externalLayerId?: string;
     externalLayerSource?: string;
 }
-export declare function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, selectExternalLayerId, }: {
+type ResolveExternalTemplateSeed = typeof resolveTemplateSeed;
+type ListExternalTemplateLayers = typeof listSelectableExternalTemplateLayers;
+export declare function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, listExternalTemplateLayers, resolveExternalTemplateSeed, selectExternalLayerId, }: {
     callerCwd: string;
     externalLayerId?: string;
     externalLayerSource?: string;
+    listExternalTemplateLayers?: ListExternalTemplateLayers;
+    resolveExternalTemplateSeed?: ResolveExternalTemplateSeed;
     selectExternalLayerId?: (options: ExternalLayerSelectionOption[]) => Promise<string>;
 }): Promise<ResolvedExternalLayerSelection>;
+export {};

package/dist/runtime/external-layer-selection.js

@@ -1,15 +1,15 @@
 import { parseTemplateLocator, resolveTemplateSeed, } from "./template-source.js";
 import { listSelectableExternalTemplateLayers, } from "./template-layers.js";
-export async function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, selectExternalLayerId, }) {
+export async function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, listExternalTemplateLayers = listSelectableExternalTemplateLayers, resolveExternalTemplateSeed = resolveTemplateSeed, selectExternalLayerId, }) {
     if (!externalLayerSource || externalLayerId || !selectExternalLayerId) {
         return {
             externalLayerId,
             externalLayerSource,
         };
     }
-    const layerSeed = await resolveTemplateSeed(parseTemplateLocator(externalLayerSource), callerCwd);
+    const layerSeed = await resolveExternalTemplateSeed(parseTemplateLocator(externalLayerSource), callerCwd);
     try {
-        const selectableLayers = await listSelectableExternalTemplateLayers(layerSeed.rootDir);
+        const selectableLayers = await listExternalTemplateLayers(layerSeed.rootDir);
         if (selectableLayers.length <= 1) {
             await layerSeed.cleanup?.();
             return {
@@ -25,7 +25,6 @@ export async function resolveOptionalInteractiveExternalLayerId({ callerCwd, ext
                 externalLayerSource: layerSeed.rootDir,
             };
         }
-        await layerSeed.cleanup?.();
         throw new Error(`Unknown external layer "${selectedLayerId}". Expected one of: ${selectableLayers.map((layer) => layer.id).join(", ")}`);
     }
     catch (error) {

package/dist/runtime/package-versions.d.ts

@@ -11,6 +11,19 @@ export interface PackageVersions {
     wpTypiaPackageExactVersion: string;
     wpTypiaPackageVersion: string;
 }
+/**
+ * Explicit fallback ranges for managed WordPress-facing workspace dependencies.
+ *
+ * These remain centralized here even when individual scaffold flows resolve a
+ * fresher local or installed manifest version first, so add-command defaults do
+ * not drift across runtime modules.
+ */
+export declare const DEFAULT_WORDPRESS_ABILITIES_VERSION = "^0.10.0";
+export declare const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0";
+export declare const DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0";
+export declare const DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0";
+export declare const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
+export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.0";
 /**
  * Clears the in-memory cache used by `getPackageVersions()`.
  *

package/dist/runtime/package-versions.js

@@ -7,6 +7,19 @@ const DEFAULT_VERSION_RANGE = "^0.0.0";
 const DEFAULT_EXACT_VERSION = "0.0.0";
 const DEFAULT_TSX_PACKAGE_VERSION = "^4.20.5";
 const DEFAULT_TYPIA_UNPLUGIN_PACKAGE_VERSION = "^12.0.1";
+/**
+ * Explicit fallback ranges for managed WordPress-facing workspace dependencies.
+ *
+ * These remain centralized here even when individual scaffold flows resolve a
+ * fresher local or installed manifest version first, so add-command defaults do
+ * not drift across runtime modules.
+ */
+export const DEFAULT_WORDPRESS_ABILITIES_VERSION = "^0.10.0";
+export const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0";
+export const DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0";
+export const DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0";
+export const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
+export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.0";
 let cachedPackageVersions = null;
 function getErrorCode(error) {
     return typeof error === "object" && error !== null && "code" in error

package/dist/runtime/scaffold-compatibility.d.ts

@@ -4,7 +4,7 @@
  * The policy keeps plugin headers, runtime gates, and workspace inventory
  * metadata aligned when optional or required AI-capable features are added.
  */
-import { type AiFeatureCapabilitySelection, type AiFeatureCompatibilityFloor, type ResolvedAiFeatureCapabilityPlan } from "./ai-feature-capability.js";
+import { type AiFeatureCapabilitySelection, type AiFeatureCompatibilityFloor, type ResolvedAiFeatureCapabilityPlan } from './ai-feature-capability.js';
 /**
  * WordPress plugin header version floors emitted by scaffold templates.
  */
@@ -25,7 +25,7 @@ export interface ScaffoldCompatibilityPolicy {
  */
 export interface ScaffoldCompatibilityConfig {
     hardMinimums: AiFeatureCompatibilityFloor;
-    mode: "baseline" | "optional" | "required";
+    mode: 'baseline' | 'optional' | 'required';
     optionalFeatures: string[];
     requiredFeatures: string[];
     runtimeGates: string[];

package/dist/runtime/scaffold-compatibility.js

@@ -4,14 +4,15 @@
  * The policy keeps plugin headers, runtime gates, and workspace inventory
  * metadata aligned when optional or required AI-capable features are added.
  */
-import { AI_FEATURE_DEFINITIONS, resolveAiFeatureCapabilityPlan, } from "./ai-feature-capability.js";
+import { AI_FEATURE_DEFINITIONS, resolveAiFeatureCapabilityPlan, } from './ai-feature-capability.js';
+import { pickHigherVersionFloor } from './version-floor.js';
 /**
  * Baseline headers used by scaffold output before optional features are added.
  */
 export const DEFAULT_SCAFFOLD_COMPATIBILITY = {
-    requiresAtLeast: "6.7",
-    requiresPhp: "8.0",
-    testedUpTo: "6.9",
+    requiresAtLeast: '6.7',
+    requiresPhp: '8.0',
+    testedUpTo: '6.9',
 };
 /**
  * Optional WordPress AI Client surface used by server-only AI feature scaffold.
@@ -19,7 +20,7 @@ export const DEFAULT_SCAFFOLD_COMPATIBILITY = {
 export const OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY = [
     {
         featureId: AI_FEATURE_DEFINITIONS.wordpressAiClient.id,
-        mode: "optional",
+        mode: 'optional',
     },
 ];
 /**
@@ -28,42 +29,15 @@ export const OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY = [
 export const REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY = [
     {
         featureId: AI_FEATURE_DEFINITIONS.wordpressServerAbilities.id,
-        mode: "required",
+        mode: 'required',
     },
     {
         featureId: AI_FEATURE_DEFINITIONS.wordpressCoreAbilities.id,
-        mode: "required",
+        mode: 'required',
     },
 ];
-function parseVersionFloorParts(value) {
-    return value.split(".").map((part, index) => {
-        if (!/^\d+$/u.test(part)) {
-            throw new Error(`parseVersionFloorParts received an invalid version floor "${value}" at segment ${index + 1}.`);
-        }
-        return Number.parseInt(part, 10);
-    });
-}
-function compareVersionFloors(left, right) {
-    const leftParts = parseVersionFloorParts(left);
-    const rightParts = parseVersionFloorParts(right);
-    const length = Math.max(leftParts.length, rightParts.length);
-    for (let index = 0; index < length; index += 1) {
-        const leftValue = leftParts[index] ?? 0;
-        const rightValue = rightParts[index] ?? 0;
-        if (leftValue > rightValue) {
-            return 1;
-        }
-        if (leftValue < rightValue) {
-            return -1;
-        }
-    }
-    return 0;
-}
-function pickHigherVersionFloor(current, candidate) {
-    if (!candidate) {
-        return current;
-    }
-    return compareVersionFloors(current, candidate) >= 0 ? current : candidate;
+function pickHigherScaffoldVersionFloor(current, candidate) {
+    return pickHigherVersionFloor(current, candidate) ?? current;
 }
 function pickHigherHeaderVersionFloor(policyValue, currentValue) {
     const normalizedCurrentValue = currentValue.trim();
@@ -71,7 +45,7 @@ function pickHigherHeaderVersionFloor(policyValue, currentValue) {
         return policyValue;
     }
     try {
-        return pickHigherVersionFloor(policyValue, normalizedCurrentValue);
+        return pickHigherScaffoldVersionFloor(policyValue, normalizedCurrentValue);
     }
     catch {
         return policyValue;
@@ -82,21 +56,21 @@ function formatRuntimeGate(feature) {
 }
 function getPolicyMode(capabilityPlan) {
     if (capabilityPlan.requiredFeatures.length > 0) {
-        return "required";
+        return 'required';
     }
     if (capabilityPlan.optionalFeatures.length > 0) {
-        return "optional";
+        return 'optional';
     }
-    return "baseline";
+    return 'baseline';
 }
 /**
  * Resolve plugin header floors and capability gates for scaffold selections.
  */
 export function resolveScaffoldCompatibilityPolicy(selections, { baseline = DEFAULT_SCAFFOLD_COMPATIBILITY, } = {}) {
     const capabilityPlan = resolveAiFeatureCapabilityPlan(selections);
-    const requiresAtLeast = pickHigherVersionFloor(baseline.requiresAtLeast, capabilityPlan.hardMinimums.wordpress);
-    const requiresPhp = pickHigherVersionFloor(baseline.requiresPhp, capabilityPlan.hardMinimums.php);
-    const testedUpTo = pickHigherVersionFloor(baseline.testedUpTo, requiresAtLeast);
+    const requiresAtLeast = pickHigherScaffoldVersionFloor(baseline.requiresAtLeast, capabilityPlan.hardMinimums.wordpress);
+    const requiresPhp = pickHigherScaffoldVersionFloor(baseline.requiresPhp, capabilityPlan.hardMinimums.php);
+    const testedUpTo = pickHigherScaffoldVersionFloor(baseline.testedUpTo, requiresAtLeast);
     return {
         capabilityPlan,
         pluginHeader: {
@@ -125,16 +99,16 @@ export function createScaffoldCompatibilityConfig(policy) {
 /**
  * Render compatibility metadata as formatted TypeScript object literal JSON.
  */
-export function renderScaffoldCompatibilityConfig(policy, indent = "\t\t") {
+export function renderScaffoldCompatibilityConfig(policy, indent = '\t\t') {
     const config = createScaffoldCompatibilityConfig(policy);
-    return JSON.stringify(config, null, "\t")
-        .split("\n")
+    return JSON.stringify(config, null, '\t')
+        .split('\n')
         .map((line, index) => (index === 0 ? line : `${indent}${line}`))
-        .join("\n");
+        .join('\n');
 }
 function replacePluginHeaderVersionFloor(source, pattern, policyValue) {
     return source.replace(pattern, (_match, prefix, currentValue, lineEnding) => {
-        const versionPrefix = prefix.endsWith(":") ? `${prefix} ` : prefix;
+        const versionPrefix = prefix.endsWith(':') ? `${prefix} ` : prefix;
         return `${versionPrefix}${pickHigherHeaderVersionFloor(policyValue, currentValue)}${lineEnding}`;
     });
 }

package/dist/runtime/version-floor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parse a dotted version floor into numeric parts for stable comparisons.
+ *
+ * @param value Human-authored version floor such as `7.0` or `8.1.2`.
+ * @returns Numeric version segments suitable for ordered comparison.
+ * @throws When any segment contains non-digit characters.
+ */
+export declare function parseVersionFloorParts(value: string): number[];
+/**
+ * Compare two dotted version floors.
+ *
+ * Missing trailing segments are treated as zero so `7.0` equals `7.0.0`.
+ *
+ * @param left Left-hand version floor.
+ * @param right Right-hand version floor.
+ * @returns `1` when left is higher, `-1` when right is higher, or `0` when equal.
+ */
+export declare function compareVersionFloors(left: string, right: string): number;
+/**
+ * Pick the higher version floor while tolerating undefined values.
+ *
+ * @param current Current resolved floor, when present.
+ * @param candidate Candidate floor to compare against the current floor.
+ * @returns The higher defined floor, or undefined when neither value exists.
+ */
+export declare function pickHigherVersionFloor(current: string | undefined, candidate: string | undefined): string | undefined;

package/dist/runtime/version-floor.js

@@ -0,0 +1,56 @@
+/**
+ * Parse a dotted version floor into numeric parts for stable comparisons.
+ *
+ * @param value Human-authored version floor such as `7.0` or `8.1.2`.
+ * @returns Numeric version segments suitable for ordered comparison.
+ * @throws When any segment contains non-digit characters.
+ */
+export function parseVersionFloorParts(value) {
+    return value.split('.').map((part, index) => {
+        if (!/^\d+$/u.test(part)) {
+            throw new Error(`parseVersionFloorParts received an invalid version floor "${value}" at segment ${index + 1}.`);
+        }
+        return Number.parseInt(part, 10);
+    });
+}
+/**
+ * Compare two dotted version floors.
+ *
+ * Missing trailing segments are treated as zero so `7.0` equals `7.0.0`.
+ *
+ * @param left Left-hand version floor.
+ * @param right Right-hand version floor.
+ * @returns `1` when left is higher, `-1` when right is higher, or `0` when equal.
+ */
+export function compareVersionFloors(left, right) {
+    const leftParts = parseVersionFloorParts(left);
+    const rightParts = parseVersionFloorParts(right);
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftValue = leftParts[index] ?? 0;
+        const rightValue = rightParts[index] ?? 0;
+        if (leftValue > rightValue) {
+            return 1;
+        }
+        if (leftValue < rightValue) {
+            return -1;
+        }
+    }
+    return 0;
+}
+/**
+ * Pick the higher version floor while tolerating undefined values.
+ *
+ * @param current Current resolved floor, when present.
+ * @param candidate Candidate floor to compare against the current floor.
+ * @returns The higher defined floor, or undefined when neither value exists.
+ */
+export function pickHigherVersionFloor(current, candidate) {
+    if (!candidate) {
+        return current;
+    }
+    if (!current) {
+        return candidate;
+    }
+    return compareVersionFloors(current, candidate) >= 0 ? current : candidate;
+}

package/dist/runtime/workspace-inventory.d.ts

@@ -96,7 +96,8 @@ export interface WorkspaceAiFeatureInventoryEntry {
  * @property file Relative path to the generated admin view shared entry file.
  * @property phpFile Relative path to the generated WordPress admin page glue.
  * @property slug Normalized admin view slug.
- * @property source Optional source locator such as `rest-resource:products`.
+ * @property source Optional source locator such as `rest-resource:products` or
+ * `core-data:postType/post`.
  */
 export interface WorkspaceAdminViewInventoryEntry {
     file: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -105,6 +105,7 @@
     "prepack": "bun run build && node ./scripts/publish-manifest.mjs prepare",
     "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/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/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
@@ -146,7 +147,7 @@
   "dependencies": {
     "@wp-typia/api-client": "^0.4.5",
     "@wp-typia/block-runtime": "^0.5.0",
-    "@wp-typia/rest": "^0.3.11",
+    "@wp-typia/rest": "^0.3.12",
     "@wp-typia/block-types": "^0.2.4",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",