wp-typia 0.21.0 → 0.22.0

package/dist-bunli/{cli-add-93945fc2.js → cli-add-kjhghdqq.js}

@@ -20,13 +20,19 @@ import {
   scaffoldProject,
   syncPersistenceRestArtifacts,
   updatePluginHeaderCompatibility
-} from "./cli-pav309dt.js";
+} from "./cli-1w5vkye4.js";
 import {
+  DEFAULT_WORDPRESS_ABILITIES_VERSION,
+  DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION,
+  DEFAULT_WORDPRESS_CORE_DATA_VERSION,
+  DEFAULT_WORDPRESS_DATAVIEWS_VERSION,
+  DEFAULT_WORDPRESS_DATA_VERSION,
+  DEFAULT_WP_TYPIA_DATAVIEWS_VERSION,
   getPackageVersions
-} from "./cli-syg9qpxw.js";
+} from "./cli-39er8888.js";
 import {
   snapshotProjectVersion
-} from "./cli-jfj54qej.js";
+} from "./cli-e623rs7g.js";
 import {
   ensureMigrationDirectories,
   parseMigrationConfig,
@@ -87,11 +93,14 @@ import {
   toPascalCase,
   toSnakeCase,
   toTitleCase
-} from "./cli-hx88xwr4.js";
+} from "./cli-j180bk07.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";
-import"./cli-p95wr1q8.js";
+import {
+  CLI_DIAGNOSTIC_CODES,
+  createCliDiagnosticCodeError
+} from "./cli-p95wr1q8.js";
 import {
   resolveWorkspaceProject
 } from "./cli-pd5pqgre.js";
@@ -779,14 +788,19 @@ import fs3 from "fs";
 import { promises as fsp3 } from "fs";
 import { createRequire } from "module";
 import path4 from "path";
-var ADMIN_VIEW_SOURCE_KIND = "rest-resource";
+var ADMIN_VIEW_REST_SOURCE_KIND = "rest-resource";
+var ADMIN_VIEW_CORE_DATA_SOURCE_KIND = "core-data";
+var ADMIN_VIEW_CORE_DATA_ENTITY_KIND_IDS = ["postType", "taxonomy"];
+var ADMIN_VIEW_CORE_DATA_ENTITY_SEGMENT_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/u;
+var ADMIN_VIEW_CORE_DATA_ENTITY_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]*$/u;
+var ADMIN_VIEW_SOURCE_USAGE = "wp-typia add admin-view <name> --source <rest-resource:slug|core-data:kind/name>";
 var ADMIN_VIEWS_SCRIPT = "build/admin-views/index.js";
 var ADMIN_VIEWS_ASSET = "build/admin-views/index.asset.php";
 var ADMIN_VIEWS_STYLE = "build/admin-views/style-index.css";
 var ADMIN_VIEWS_STYLE_RTL = "build/admin-views/style-index-rtl.css";
 var ADMIN_VIEWS_PHP_GLOB = "/inc/admin-views/*.php";
-var DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.0";
-var DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
+var ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV = "WP_TYPIA_ALLOW_UNPUBLISHED_DATAVIEWS";
+var ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED = false;
 var require2 = createRequire(import.meta.url);
 function toCamelCase(input) {
   const pascalCase = toPascalCase(input);
@@ -799,14 +813,25 @@ function normalizeVersionRange(value, fallback) {
   }
   return /^[~^<>=]/u.test(trimmed) ? trimmed : `^${trimmed}`;
 }
-function readPackageManifestVersion(packageJsonPath) {
+function readPackageManifest(packageJsonPath) {
   try {
-    const packageJson = JSON.parse(fs3.readFileSync(packageJsonPath, "utf8"));
-    return packageJson.version;
+    return JSON.parse(fs3.readFileSync(packageJsonPath, "utf8"));
   } catch {
     return;
   }
 }
+function readPackageManifestVersion(packageJsonPath) {
+  return readPackageManifest(packageJsonPath)?.version;
+}
+function isAdminViewUnpublishedDataViewsOverrideEnabled() {
+  return process.env[ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV]?.trim() === "1";
+}
+function assertAdminViewPackageAvailability() {
+  if (isAdminViewUnpublishedDataViewsOverrideEnabled() || ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED) {
+    return;
+  }
+  throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, "`wp-typia add admin-view` is temporarily unavailable because `@wp-typia/dataviews` is not published to npm for public installs yet.");
+}
 function detectJsonIndent(source) {
   const indentMatch = /\n([ \t]+)"/u.exec(source);
   return indentMatch?.[1] ?? 2;
@@ -831,22 +856,77 @@ function getAdminViewRelativeModuleSpecifier(adminViewSlug, workspaceFile) {
   const relativeModulePath = path4.posix.relative(adminViewDir, modulePath);
   return relativeModulePath.startsWith(".") ? relativeModulePath : `./${relativeModulePath}`;
 }
+function isAdminViewCoreDataSource(source) {
+  return source?.kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND;
+}
+function isAdminViewRestResourceSource(source) {
+  return source?.kind === ADMIN_VIEW_REST_SOURCE_KIND;
+}
+function assertValidCoreDataEntitySegment(label, value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    throw new Error(`${label} is required. Use \`${ADMIN_VIEW_SOURCE_USAGE}\`.`);
+  }
+  if (!ADMIN_VIEW_CORE_DATA_ENTITY_SEGMENT_PATTERN.test(trimmed)) {
+    throw new Error(`${label} must start with a letter and contain only letters, numbers, underscores, or hyphens.`);
+  }
+  return trimmed;
+}
+function assertValidCoreDataEntityName(value) {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`Admin view source entity name is required. Use \`${ADMIN_VIEW_SOURCE_USAGE}\`.`);
+  }
+  if (!ADMIN_VIEW_CORE_DATA_ENTITY_NAME_PATTERN.test(normalized)) {
+    throw new Error("Admin view source entity name must start with a lowercase letter or number and contain only lowercase letters, numbers, underscores, or hyphens.");
+  }
+  return normalized;
+}
+function assertValidCoreDataEntityKind(value) {
+  const normalized = assertValidCoreDataEntitySegment("Admin view source entity kind", value);
+  if (!ADMIN_VIEW_CORE_DATA_ENTITY_KIND_IDS.includes(normalized)) {
+    throw new Error(`Admin view core-data sources currently support only: ${ADMIN_VIEW_CORE_DATA_ENTITY_KIND_IDS.join(", ")}.`);
+  }
+  return normalized;
+}
+function formatAdminViewSourceLocator(source) {
+  if (isAdminViewCoreDataSource(source)) {
+    return `${source.kind}:${source.entityKind}/${source.entityName}`;
+  }
+  return `${source.kind}:${source.slug}`;
+}
 function parseAdminViewSource(source) {
   const trimmed = source?.trim();
   if (!trimmed) {
     return;
   }
-  const [kind, slug, extra] = trimmed.split(":");
-  if (kind !== ADMIN_VIEW_SOURCE_KIND || !slug || extra !== undefined) {
-    throw new Error("Admin view source must use `rest-resource:<slug>` for now.");
+  const separatorIndex = trimmed.indexOf(":");
+  const kind = separatorIndex === -1 ? trimmed : trimmed.slice(0, separatorIndex);
+  const locator = separatorIndex === -1 ? "" : trimmed.slice(separatorIndex + 1);
+  if (!locator) {
+    throw new Error("Admin view source must use `rest-resource:<slug>` or `core-data:<kind>/<name>`.");
   }
-  return {
-    kind,
-    slug: assertValidGeneratedSlug("Admin view source slug", normalizeBlockSlug(slug), "wp-typia add admin-view <name> --source rest-resource:<slug>")
-  };
+  if (kind === ADMIN_VIEW_REST_SOURCE_KIND) {
+    return {
+      kind,
+      slug: assertValidGeneratedSlug("Admin view source slug", locator, ADMIN_VIEW_SOURCE_USAGE)
+    };
+  }
+  if (kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND) {
+    const [entityKind, entityName, extra] = locator.split("/");
+    if (!entityKind || !entityName || extra !== undefined) {
+      throw new Error("Admin view core-data sources must use `core-data:<kind>/<name>`, for example `core-data:postType/post`.");
+    }
+    return {
+      entityKind: assertValidCoreDataEntityKind(entityKind),
+      entityName: assertValidCoreDataEntityName(entityName),
+      kind
+    };
+  }
+  throw new Error("Admin view source must use `rest-resource:<slug>` or `core-data:<kind>/<name>`.");
 }
 function resolveRestResourceSource(restResources, source) {
-  if (!source) {
+  if (!isAdminViewRestResourceSource(source)) {
     return;
   }
   const restResource = restResources.find((entry) => entry.slug === source.slug);
@@ -864,7 +944,7 @@ function buildAdminViewConfigEntry(adminViewSlug, source) {
     `		file: ${quoteTsString(`src/admin-views/${adminViewSlug}/index.tsx`)},`,
     `		phpFile: ${quoteTsString(`inc/admin-views/${adminViewSlug}.php`)},`,
     `		slug: ${quoteTsString(adminViewSlug)},`,
-    source ? `		source: ${quoteTsString(`${source.kind}:${source.slug}`)},` : null,
+    source ? `		source: ${quoteTsString(formatAdminViewSourceLocator(source))},` : null,
     "\t},"
   ].filter((line) => typeof line === "string").join(`
 `);
@@ -877,8 +957,9 @@ function buildAdminViewRegistrySource(adminViewSlugs) {
 ` : ""}// wp-typia add admin-view entries
 `;
 }
-function buildAdminViewTypesSource(adminViewSlug, restResource) {
+function buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource) {
   const pascalName = toPascalCase(adminViewSlug);
+  const coreDataRecordTypeName = `${pascalName}CoreDataRecord`;
   const itemTypeName = `${pascalName}AdminViewItem`;
   const dataSetTypeName = `${pascalName}AdminViewDataSet`;
   if (restResource) {
@@ -888,6 +969,74 @@ function buildAdminViewTypesSource(adminViewSlug, restResource) {
 
 export type ${itemTypeName} = ${restPascalName}Record;
 
+export interface ${dataSetTypeName} {
+	items: ${itemTypeName}[];
+	paginationInfo: {
+		totalItems: number;
+		totalPages: number;
+	};
+}
+`;
+  }
+  if (coreDataSource) {
+    if (coreDataSource.entityKind === "taxonomy") {
+      return `export interface ${coreDataRecordTypeName} {
+	count?: number;
+	description?: string;
+	id: number;
+	link?: string;
+	meta?: Record<string, unknown>;
+	name?: string;
+	parent?: number;
+	slug?: string;
+	taxonomy?: string;
+	[key: string]: unknown;
+}
+
+export interface ${itemTypeName} {
+	count: number;
+	description: string;
+	id: number;
+	link: string;
+	name: string;
+	parent: number;
+	raw: ${coreDataRecordTypeName};
+	slug: string;
+	taxonomy: string;
+}
+
+export interface ${dataSetTypeName} {
+	items: ${itemTypeName}[];
+	paginationInfo: {
+		totalItems: number;
+		totalPages: number;
+	};
+}
+`;
+    }
+    return `export interface ${coreDataRecordTypeName} {
+	id: number;
+	date?: string;
+	modified?: string;
+	name?: string;
+	slug?: string;
+	status?: string;
+	title?: string | {
+		raw?: string;
+		rendered?: string;
+	};
+	[key: string]: unknown;
+}
+
+export interface ${itemTypeName} {
+	id: number;
+	raw: ${coreDataRecordTypeName};
+	slug: string;
+	status: string;
+	title: string;
+	updatedAt: string;
+}
+
 export interface ${dataSetTypeName} {
 	items: ${itemTypeName}[];
 	paginationInfo: {
@@ -916,22 +1065,74 @@ export interface ${dataSetTypeName} {
 }
 `;
 }
-function buildAdminViewConfigSource(adminViewSlug, textDomain, restResource) {
+function buildAdminViewConfigSource(adminViewSlug, textDomain, source, restResource) {
   const pascalName = toPascalCase(adminViewSlug);
   const camelName = toCamelCase(adminViewSlug);
   const itemTypeName = `${pascalName}AdminViewItem`;
   const dataViewsName = `${camelName}AdminDataViews`;
-  const defaultViewFields = restResource ? "['id']" : "['title', 'status', 'updatedAt']";
+  const isCoreDataSource = source?.kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND;
+  const isTaxonomyCoreDataSource = source?.kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND && source.entityKind === "taxonomy";
+  const defaultViewFields = restResource ? "['id']" : isTaxonomyCoreDataSource ? "['name', 'slug', 'count']" : isCoreDataSource ? "['title', 'slug', 'status', 'updatedAt']" : "['title', 'status', 'updatedAt']";
   const searchEnabled = restResource ? "false" : "true";
-  const titleFieldSource = restResource ? "" : `	titleField: 'title',
+  const titleFieldSource = restResource ? "" : isTaxonomyCoreDataSource ? `	titleField: 'name',
+` : `	titleField: 'title',
 `;
-  const defaultViewEnhancementsSource = restResource ? "" : `		sort: {
+  const defaultViewEnhancementsSource = restResource ? "" : isTaxonomyCoreDataSource ? `		titleField: 'name',
+` : isCoreDataSource ? `		titleField: 'title',
+` : `		sort: {
 			direction: 'desc',
 			field: 'updatedAt',
 		},
 		titleField: 'title',
 `;
-  const additionalFieldsSource = restResource ? "\t\t// REST-backed screens start with the guaranteed ID column. Add project-owned fields here once they are declared on the REST record type." : `		owner: {
+  const additionalFieldsSource = restResource ? "\t\t// REST-backed screens start with the guaranteed ID column. Add project-owned fields here once they are declared on the REST record type." : isTaxonomyCoreDataSource ? `		count: {
+			label: __( 'Count', ${quoteTsString(textDomain)} ),
+			schema: { type: 'integer' },
+		},
+		description: {
+			label: __( 'Description', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},
+		link: {
+			label: __( 'Link', ${quoteTsString(textDomain)} ),
+			schema: { format: 'uri', type: 'string' },
+		},
+		name: {
+			enableGlobalSearch: true,
+			label: __( 'Name', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},
+		parent: {
+			label: __( 'Parent', ${quoteTsString(textDomain)} ),
+			schema: { type: 'integer' },
+		},
+		slug: {
+			enableGlobalSearch: true,
+			label: __( 'Slug', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},
+		taxonomy: {
+			label: __( 'Taxonomy', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},` : isCoreDataSource ? `		slug: {
+			enableGlobalSearch: true,
+			label: __( 'Slug', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},
+		status: {
+			label: __( 'Status', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},
+		title: {
+			enableGlobalSearch: true,
+			label: __( 'Name', ${quoteTsString(textDomain)} ),
+			schema: { type: 'string' },
+		},
+		updatedAt: {
+			label: __( 'Updated', ${quoteTsString(textDomain)} ),
+			schema: { format: 'date-time', type: 'string' },
+			type: 'datetime',
+		},` : `		owner: {
 			label: __( 'Owner', ${quoteTsString(textDomain)} ),
 			schema: { type: 'string' },
 		},
@@ -1118,6 +1319,217 @@ export async function ${fetchName}(
 }
 `;
 }
+function buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource) {
+  const pascalName = toPascalCase(adminViewSlug);
+  const camelName = toCamelCase(adminViewSlug);
+  const coreDataRecordTypeName = `${pascalName}CoreDataRecord`;
+  const dataSetTypeName = `${pascalName}AdminViewDataSet`;
+  const itemTypeName = `${pascalName}AdminViewItem`;
+  const queryTypeName = `${pascalName}AdminViewQuery`;
+  const dataViewsName = `${camelName}AdminDataViews`;
+  const useEntityRecordName = `use${pascalName}EntityRecord`;
+  const useEntityRecordsName = `use${pascalName}EntityRecords`;
+  const useAdminViewDataName = `use${pascalName}AdminViewData`;
+  if (coreDataSource.entityKind === "taxonomy") {
+    return `import type { DataViewsView } from '@wp-typia/dataviews';
+import { useEntityRecord, useEntityRecords } from '@wordpress/core-data';
+import { useMemo } from '@wordpress/element';
+
+import { ${dataViewsName} } from './config';
+import type {
+	${coreDataRecordTypeName},
+	${dataSetTypeName},
+	${itemTypeName},
+} from './types';
+
+export interface ${queryTypeName} {
+	page?: number;
+	per_page?: number;
+	search?: string;
+}
+
+const CORE_DATA_ENTITY_KIND = ${quoteTsString(coreDataSource.entityKind)};
+const CORE_DATA_ENTITY_NAME = ${quoteTsString(coreDataSource.entityName)};
+
+function normalizeCoreDataNumber(value: unknown): number {
+	return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+
+function normalizeCoreDataString(value: unknown): string {
+	return typeof value === 'string' ? value : '';
+}
+
+function normalizeTaxonomyRecord(record: ${coreDataRecordTypeName}): ${itemTypeName} {
+	return {
+		count: normalizeCoreDataNumber(record.count),
+		description: normalizeCoreDataString(record.description),
+		id: record.id,
+		link: normalizeCoreDataString(record.link),
+		name: normalizeCoreDataString(record.name) || normalizeCoreDataString(record.slug),
+		parent: normalizeCoreDataNumber(record.parent),
+		raw: record,
+		slug: normalizeCoreDataString(record.slug),
+		taxonomy: normalizeCoreDataString(record.taxonomy),
+	};
+	}
+
+export function ${useEntityRecordName}(recordId: number | undefined) {
+	return useEntityRecord<${coreDataRecordTypeName}>(
+		CORE_DATA_ENTITY_KIND,
+		CORE_DATA_ENTITY_NAME,
+		recordId ?? 0,
+		{ enabled: typeof recordId === 'number' },
+	);
+	}
+
+export function ${useEntityRecordsName}(view: DataViewsView<${itemTypeName}>) {
+	const query = ${dataViewsName}.toQueryArgs<${queryTypeName}>(view, {
+		perPageParam: 'per_page',
+	});
+
+	return useEntityRecords<${coreDataRecordTypeName}>(
+		CORE_DATA_ENTITY_KIND,
+		CORE_DATA_ENTITY_NAME,
+		query,
+	);
+	}
+
+export function ${useAdminViewDataName}(view: DataViewsView<${itemTypeName}>) {
+	const { hasResolved, isResolving, records, totalItems, totalPages } =
+		${useEntityRecordsName}(view);
+	const items = useMemo(
+		() => (records ?? []).map((record) => normalizeTaxonomyRecord(record)),
+		[records],
+	);
+	const dataSet = useMemo<${dataSetTypeName}>(
+		() => ({
+			items,
+			paginationInfo: {
+				totalItems: totalItems ?? items.length,
+				totalPages: Math.max(1, totalPages ?? 1),
+			},
+		}),
+		[items, totalItems, totalPages],
+	);
+	const error =
+		!isResolving && hasResolved && records === null
+			? 'Unable to load core-data entity records.'
+			: null;
+
+	return {
+		dataSet,
+		error,
+		isLoading: isResolving,
+	};
+	}
+`;
+  }
+  return `import type { DataViewsView } from '@wp-typia/dataviews';
+import { useEntityRecord, useEntityRecords } from '@wordpress/core-data';
+import { useMemo } from '@wordpress/element';
+
+import { ${dataViewsName} } from './config';
+import type {
+	${coreDataRecordTypeName},
+	${dataSetTypeName},
+	${itemTypeName},
+} from './types';
+
+export interface ${queryTypeName} {
+	page?: number;
+	per_page?: number;
+	search?: string;
+}
+
+const CORE_DATA_ENTITY_KIND = ${quoteTsString(coreDataSource.entityKind)};
+const CORE_DATA_ENTITY_NAME = ${quoteTsString(coreDataSource.entityName)};
+
+function normalizeCoreDataString(value: unknown): string {
+	return typeof value === 'string' ? value : '';
+}
+
+function normalizeCoreDataTitle(record: ${coreDataRecordTypeName}): string {
+	if (typeof record.title === 'string') {
+		return record.title;
+	}
+	if (record.title && typeof record.title === 'object') {
+		if (typeof record.title.rendered === 'string') {
+			return record.title.rendered;
+		}
+		if (typeof record.title.raw === 'string') {
+			return record.title.raw;
+		}
+	}
+
+	return normalizeCoreDataString(record.name) || normalizeCoreDataString(record.slug);
+}
+
+function normalizeCoreDataUpdatedAt(record: ${coreDataRecordTypeName}): string {
+	return normalizeCoreDataString(record.modified) || normalizeCoreDataString(record.date);
+}
+
+function normalizeCoreDataRecord(record: ${coreDataRecordTypeName}): ${itemTypeName} {
+	return {
+		id: record.id,
+		raw: record,
+		slug: normalizeCoreDataString(record.slug),
+		status: normalizeCoreDataString(record.status),
+		title: normalizeCoreDataTitle(record),
+		updatedAt: normalizeCoreDataUpdatedAt(record),
+	};
+}
+
+export function ${useEntityRecordName}(recordId: number | undefined) {
+	return useEntityRecord<${coreDataRecordTypeName}>(
+		CORE_DATA_ENTITY_KIND,
+		CORE_DATA_ENTITY_NAME,
+		recordId ?? 0,
+		{ enabled: typeof recordId === 'number' },
+	);
+}
+
+export function ${useEntityRecordsName}(view: DataViewsView<${itemTypeName}>) {
+	const query = ${dataViewsName}.toQueryArgs<${queryTypeName}>(view, {
+		perPageParam: 'per_page',
+	});
+
+	return useEntityRecords<${coreDataRecordTypeName}>(
+		CORE_DATA_ENTITY_KIND,
+		CORE_DATA_ENTITY_NAME,
+		query,
+	);
+}
+
+export function ${useAdminViewDataName}(view: DataViewsView<${itemTypeName}>) {
+	const { hasResolved, isResolving, records, totalItems, totalPages } =
+		${useEntityRecordsName}(view);
+	const items = useMemo(
+		() => (records ?? []).map((record) => normalizeCoreDataRecord(record)),
+		[records],
+	);
+	const dataSet = useMemo<${dataSetTypeName}>(
+		() => ({
+			items,
+			paginationInfo: {
+				totalItems: totalItems ?? items.length,
+				totalPages: Math.max(1, totalPages ?? 1),
+			},
+		}),
+		[items, totalItems, totalPages],
+	);
+	const error =
+		!isResolving && hasResolved && records === null
+			? 'Unable to load core-data entity records.'
+			: null;
+
+	return {
+		dataSet,
+		error,
+		isLoading: isResolving,
+	};
+}
+`;
+}
 function buildAdminViewScreenSource(adminViewSlug, textDomain) {
   const pascalName = toPascalCase(adminViewSlug);
   const camelName = toCamelCase(adminViewSlug);
@@ -1231,6 +1643,81 @@ export function ${componentName}() {
 }
 `;
 }
+function buildCoreDataAdminViewScreenSource(adminViewSlug, textDomain) {
+  const pascalName = toPascalCase(adminViewSlug);
+  const camelName = toCamelCase(adminViewSlug);
+  const itemTypeName = `${pascalName}AdminViewItem`;
+  const dataSetTypeName = `${pascalName}AdminViewDataSet`;
+  const componentName = `${pascalName}AdminViewScreen`;
+  const dataViewsName = `${camelName}AdminDataViews`;
+  const useAdminViewDataName = `use${pascalName}AdminViewData`;
+  const title = toTitleCase(adminViewSlug);
+  return `import type { DataViewsConfig, DataViewsView } from '@wp-typia/dataviews';
+import { Notice, Spinner } from '@wordpress/components';
+import { useState } from '@wordpress/element';
+import { __ } from '@wordpress/i18n';
+import { DataViews } from '@wordpress/dataviews/wp';
+
+import { ${dataViewsName} } from './config';
+import { ${useAdminViewDataName} } from './data';
+import type { ${dataSetTypeName}, ${itemTypeName} } from './types';
+
+const TypedDataViews = DataViews as unknown as <TItem extends object>(
+	props: DataViewsConfig<TItem>,
+) => ReturnType<typeof DataViews>;
+
+const EMPTY_DATA_SET: ${dataSetTypeName} = {
+	items: [],
+	paginationInfo: {
+		totalItems: 0,
+		totalPages: 1,
+	},
+};
+
+export function ${componentName}() {
+	const [view, setView] = useState<DataViewsView<${itemTypeName}>>(
+		${dataViewsName}.defaultView,
+	);
+	const {
+		dataSet = EMPTY_DATA_SET,
+		error,
+		isLoading,
+	} = ${useAdminViewDataName}(view);
+	const config = ${dataViewsName}.createConfig({
+		data: dataSet.items,
+		isLoading,
+		onChangeView: setView,
+		paginationInfo: dataSet.paginationInfo,
+		view,
+	});
+
+	return (
+		<div className="wp-typia-admin-view-screen">
+			<header className="wp-typia-admin-view-screen__header">
+				<div>
+					<p className="wp-typia-admin-view-screen__eyebrow">
+						{ __( 'DataViews admin screen', ${quoteTsString(textDomain)} ) }
+					</p>
+					<h1>{ __( ${quoteTsString(title)}, ${quoteTsString(textDomain)} ) }</h1>
+					<p>
+						{ __( 'This screen reads from the WordPress core-data entity store. Extend data.ts when you need entity-specific field mapping or edit flows.', ${quoteTsString(textDomain)} ) }
+					</p>
+				</div>
+				<div className="wp-typia-admin-view-screen__actions">
+					{ isLoading ? <Spinner /> : null }
+				</div>
+			</header>
+			{ error ? (
+				<Notice isDismissible={ false } status="error">
+					{ error }
+				</Notice>
+			) : null }
+			<TypedDataViews<${itemTypeName}> { ...config } />
+		</div>
+	);
+}
+`;
+}
 function buildAdminViewEntrySource(adminViewSlug) {
   const pascalName = toPascalCase(adminViewSlug);
   const componentName = `${pascalName}AdminViewScreen`;
@@ -1400,15 +1887,22 @@ add_action( 'admin_menu', '${registerFunctionName}' );
 add_action( 'admin_enqueue_scripts', '${enqueueFunctionName}' );
 `;
 }
-async function ensureAdminViewPackageDependencies(workspace) {
+async function ensureAdminViewPackageDependencies(workspace, adminViewSource) {
   const packageJsonPath = path4.join(workspace.projectDir, "package.json");
   const wpTypiaDataViewsVersion = resolvePackageVersionRange("@wp-typia/dataviews", DEFAULT_WP_TYPIA_DATAVIEWS_VERSION, "wp-typia-dataviews");
   const wordpressDataViewsVersion = resolvePackageVersionRange("@wordpress/dataviews", DEFAULT_WORDPRESS_DATAVIEWS_VERSION);
+  const wordpressCoreDataVersion = resolvePackageVersionRange("@wordpress/core-data", DEFAULT_WORDPRESS_CORE_DATA_VERSION);
+  const wordpressDataVersion = resolvePackageVersionRange("@wordpress/data", DEFAULT_WORDPRESS_DATA_VERSION);
   await patchFile(packageJsonPath, (source) => {
     const packageJson = JSON.parse(source);
+    const coreDataDependencies = isAdminViewCoreDataSource(adminViewSource) ? {
+      "@wordpress/core-data": packageJson.dependencies?.["@wordpress/core-data"] ?? wordpressCoreDataVersion,
+      "@wordpress/data": packageJson.dependencies?.["@wordpress/data"] ?? wordpressDataVersion
+    } : {};
     const nextDependencies = {
       ...packageJson.dependencies ?? {},
-      "@wordpress/dataviews": packageJson.dependencies?.["@wordpress/dataviews"] ?? wordpressDataViewsVersion
+      "@wordpress/dataviews": packageJson.dependencies?.["@wordpress/dataviews"] ?? wordpressDataViewsVersion,
+      ...coreDataDependencies
     };
     const nextDevDependencies = {
       ...packageJson.devDependencies ?? {},
@@ -1588,10 +2082,12 @@ async function runAddAdminViewCommand({
   source
 }) {
   const workspace = resolveWorkspaceProject(cwd);
-  const adminViewSlug = assertValidGeneratedSlug("Admin view name", normalizeBlockSlug(adminViewName), "wp-typia add admin-view <name> [--source rest-resource:<slug>]");
+  assertAdminViewPackageAvailability();
+  const adminViewSlug = assertValidGeneratedSlug("Admin view name", normalizeBlockSlug(adminViewName), "wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]");
   const parsedSource = parseAdminViewSource(source);
   const inventory = readWorkspaceInventory(workspace.projectDir);
   const restResource = resolveRestResourceSource(inventory.restResources, parsedSource);
+  const coreDataSource = isAdminViewCoreDataSource(parsedSource) ? parsedSource : undefined;
   assertAdminViewDoesNotExist(workspace.projectDir, adminViewSlug, inventory);
   const blockConfigPath = path4.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
@@ -1616,14 +2112,14 @@ async function runAddAdminViewCommand({
   try {
     await fsp3.mkdir(adminViewDir, { recursive: true });
     await fsp3.mkdir(path4.dirname(adminViewPhpPath), { recursive: true });
-    await ensureAdminViewPackageDependencies(workspace);
+    await ensureAdminViewPackageDependencies(workspace, parsedSource);
     await ensureAdminViewBootstrapAnchors(workspace);
     await ensureAdminViewBuildScriptAnchors(workspace);
     await ensureAdminViewWebpackAnchors(workspace);
-    await fsp3.writeFile(path4.join(adminViewDir, "types.ts"), buildAdminViewTypesSource(adminViewSlug, restResource), "utf8");
-    await fsp3.writeFile(path4.join(adminViewDir, "config.ts"), buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, restResource), "utf8");
-    await fsp3.writeFile(path4.join(adminViewDir, "data.ts"), restResource ? buildRestAdminViewDataSource(adminViewSlug, restResource) : buildDefaultAdminViewDataSource(adminViewSlug), "utf8");
-    await fsp3.writeFile(path4.join(adminViewDir, "Screen.tsx"), buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), "utf8");
+    await fsp3.writeFile(path4.join(adminViewDir, "types.ts"), buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource), "utf8");
+    await fsp3.writeFile(path4.join(adminViewDir, "config.ts"), buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, parsedSource, restResource), "utf8");
+    await fsp3.writeFile(path4.join(adminViewDir, "data.ts"), coreDataSource ? buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource) : restResource ? buildRestAdminViewDataSource(adminViewSlug, restResource) : buildDefaultAdminViewDataSource(adminViewSlug), "utf8");
+    await fsp3.writeFile(path4.join(adminViewDir, "Screen.tsx"), coreDataSource ? buildCoreDataAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain) : buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), "utf8");
     await fsp3.writeFile(path4.join(adminViewDir, "index.tsx"), buildAdminViewEntrySource(adminViewSlug), "utf8");
     await fsp3.writeFile(path4.join(adminViewDir, "style.scss"), buildAdminViewStyleSource(), "utf8");
     await fsp3.writeFile(adminViewPhpPath, buildAdminViewPhpSource(adminViewSlug, workspace), "utf8");
@@ -1634,7 +2130,7 @@ async function runAddAdminViewCommand({
     return {
       adminViewSlug,
       projectDir: workspace.projectDir,
-      source: parsedSource ? `${parsedSource.kind}:${parsedSource.slug}` : undefined
+      source: parsedSource ? formatAdminViewSourceLocator(parsedSource) : undefined
     };
   } catch (error) {
     await rollbackWorkspaceMutation(mutationSnapshot);
@@ -3862,8 +4358,6 @@ var ABILITY_EDITOR_SCRIPT = "build/abilities/index.js";
 var ABILITY_EDITOR_ASSET = "build/abilities/index.asset.php";
 var ABILITY_REGISTRY_END_MARKER = "// wp-typia add ability entries end";
 var ABILITY_REGISTRY_START_MARKER = "// wp-typia add ability entries start";
-var WP_ABILITIES_PACKAGE_VERSION = "^0.10.0";
-var WP_CORE_ABILITIES_PACKAGE_VERSION = "^0.9.0";
 var WP_ABILITIES_SCRIPT_MODULE_ID = "@wordpress/abilities";
 var WP_CORE_ABILITIES_SCRIPT_MODULE_ID = "@wordpress/core-abilities";
 function resolveManagedDependencyVersion(existingVersion, requiredVersion) {
@@ -4493,8 +4987,8 @@ async function ensureAbilityPackageScripts(workspace) {
   };
   const nextDependencies = {
     ...packageJson.dependencies ?? {},
-    [WP_ABILITIES_SCRIPT_MODULE_ID]: resolveManagedDependencyVersion(packageJson.dependencies?.[WP_ABILITIES_SCRIPT_MODULE_ID], WP_ABILITIES_PACKAGE_VERSION),
-    [WP_CORE_ABILITIES_SCRIPT_MODULE_ID]: resolveManagedDependencyVersion(packageJson.dependencies?.[WP_CORE_ABILITIES_SCRIPT_MODULE_ID], WP_CORE_ABILITIES_PACKAGE_VERSION)
+    [WP_ABILITIES_SCRIPT_MODULE_ID]: resolveManagedDependencyVersion(packageJson.dependencies?.[WP_ABILITIES_SCRIPT_MODULE_ID], DEFAULT_WORDPRESS_ABILITIES_VERSION),
+    [WP_CORE_ABILITIES_SCRIPT_MODULE_ID]: resolveManagedDependencyVersion(packageJson.dependencies?.[WP_CORE_ABILITIES_SCRIPT_MODULE_ID], DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION)
   };
   if (JSON.stringify(nextScripts) === JSON.stringify(packageJson.scripts ?? {}) && JSON.stringify(nextDependencies) === JSON.stringify(packageJson.dependencies ?? {})) {
     return;
@@ -6652,4 +7146,4 @@ export {
   ADD_BLOCK_TEMPLATE_IDS
 };
 
-//# debugId=7C11AF8BB98BD78764756E2164756E21
+//# debugId=8932DC6C8A5BAD5564756E2164756E21