@wp-typia/project-tools 0.24.4 → 0.24.5

package/dist/runtime/add/cli-add-workspace-admin-view-scaffold.js

@@ -0,0 +1,294 @@
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import { pathExists, readOptionalUtf8File } from '../shared/fs-async.js';
+import { safeJsonParse } from '../shared/json-utils.js';
+import { appendWorkspaceInventoryEntries, readWorkspaceInventoryAsync, } from '../workspace/workspace-inventory.js';
+import { buildAdminViewConfigEntry, buildAdminViewConfigSource, buildAdminViewEntrySource, buildAdminViewPhpSource, buildAdminViewRegistrySource, buildAdminViewScreenSource, buildAdminViewStyleSource, buildAdminViewTypesSource, buildCoreDataAdminViewDataSource, buildCoreDataAdminViewScreenSource, buildDefaultAdminViewDataSource, buildRestAdminViewDataSource, buildRestSettingsAdminViewConfigSource, buildRestSettingsAdminViewDataSource, buildRestSettingsAdminViewScreenSource, buildRestSettingsAdminViewTypesSource, } from './cli-add-workspace-admin-view-templates.js';
+import { ADMIN_VIEWS_PHP_GLOB, isAdminViewCoreDataSource, isAdminViewManualSettingsRestResource, } from './cli-add-workspace-admin-view-types.js';
+import { buildManualRestContractApiSource } from './cli-add-workspace-rest-manual-source-emitters.js';
+import { getWorkspaceBootstrapPath, patchFile, } from './cli-add-shared.js';
+import { appendPhpSnippetBeforeClosingTag, executeWorkspaceMutationPlan, insertPhpSnippetBeforeWorkspaceAnchors, } from './cli-add-workspace-mutation.js';
+import { DEFAULT_WORDPRESS_CORE_DATA_VERSION, DEFAULT_WORDPRESS_DATA_VERSION, DEFAULT_WORDPRESS_DATAVIEWS_VERSION, DEFAULT_WP_TYPIA_DATAVIEWS_VERSION, resolveManagedPackageVersionRange, } from '../shared/package-versions.js';
+import { findPhpFunctionRange, hasPhpFunctionDefinition, replacePhpFunctionDefinition, } from '../shared/php-utils.js';
+function detectJsonIndent(source) {
+    const indentMatch = /\n([ \t]+)"/u.exec(source);
+    return indentMatch?.[1] ?? 2;
+}
+const LEGACY_MANUAL_REST_API_SOURCE_PATTERN = /^\s*export\s+\*\s+from\s+["']\.\/api-client["'];?\s*$/u;
+const MANUAL_REST_API_DIRECT_CALL_EXPORT_PATTERN = /(?:^|\n)\s*export\s+(?:(?:async\s+)?function|const|let|var)\s+callManualRestContract\b/u;
+const MANUAL_REST_API_NAMED_EXPORT_PATTERN = /(?:^|\n)\s*export\s*\{([^}]*)\}/gu;
+function hasManualRestContractCallerExport(apiSource) {
+    if (MANUAL_REST_API_DIRECT_CALL_EXPORT_PATTERN.test(apiSource)) {
+        return true;
+    }
+    return Array.from(apiSource.matchAll(MANUAL_REST_API_NAMED_EXPORT_PATTERN)).some((match) => match[1].split(',').some((specifier) => {
+        const [localName, exportedName] = specifier.trim().split(/\s+as\s+/u);
+        return (exportedName ?? localName)?.trim() === 'callManualRestContract';
+    }));
+}
+async function ensureManualSettingsRestApiShim(workspace, restResource) {
+    const apiPath = path.join(workspace.projectDir, restResource.apiFile);
+    const apiSource = await fsp.readFile(apiPath, 'utf8');
+    if (hasManualRestContractCallerExport(apiSource)) {
+        return;
+    }
+    if (!LEGACY_MANUAL_REST_API_SOURCE_PATTERN.test(apiSource)) {
+        throw new Error(`Manual REST resource source "${restResource.slug}" must export callManualRestContract from ${restResource.apiFile}. Restore the generated manual REST api.ts or update it before scaffolding a settings admin view.`);
+    }
+    await fsp.writeFile(apiPath, buildManualRestContractApiSource({
+        bodyTypeName: restResource.bodyTypeName,
+        queryTypeName: restResource.queryTypeName,
+        restResourceSlug: restResource.slug,
+    }), 'utf8');
+}
+async function ensureAdminViewPackageDependencies(workspace, adminViewSource, restResource) {
+    const packageJsonPath = path.join(workspace.projectDir, 'package.json');
+    const wpTypiaDataViewsVersion = resolveManagedPackageVersionRange({
+        fallback: DEFAULT_WP_TYPIA_DATAVIEWS_VERSION,
+        packageName: '@wp-typia/dataviews',
+        workspacePackageDirName: 'wp-typia-dataviews',
+    });
+    const wordpressDataViewsVersion = resolveManagedPackageVersionRange({
+        fallback: DEFAULT_WORDPRESS_DATAVIEWS_VERSION,
+        packageName: '@wordpress/dataviews',
+    });
+    const wordpressCoreDataVersion = resolveManagedPackageVersionRange({
+        fallback: DEFAULT_WORDPRESS_CORE_DATA_VERSION,
+        packageName: '@wordpress/core-data',
+    });
+    const wordpressDataVersion = resolveManagedPackageVersionRange({
+        fallback: DEFAULT_WORDPRESS_DATA_VERSION,
+        packageName: '@wordpress/data',
+    });
+    await patchFile(packageJsonPath, (source) => {
+        const packageJson = safeJsonParse(source, {
+            context: 'admin view package manifest',
+            filePath: packageJsonPath,
+        });
+        const needsDataViews = !isAdminViewManualSettingsRestResource(restResource);
+        const coreDataDependencies = isAdminViewCoreDataSource(adminViewSource)
+            ? {
+                '@wordpress/core-data': packageJson.dependencies?.['@wordpress/core-data'] ??
+                    wordpressCoreDataVersion,
+                '@wordpress/data': packageJson.dependencies?.['@wordpress/data'] ??
+                    wordpressDataVersion,
+            }
+            : {};
+        const nextDependencies = {
+            ...(packageJson.dependencies ?? {}),
+            ...(needsDataViews
+                ? {
+                    '@wordpress/dataviews': packageJson.dependencies?.['@wordpress/dataviews'] ??
+                        wordpressDataViewsVersion,
+                }
+                : {}),
+            ...coreDataDependencies,
+        };
+        const nextDevDependencies = {
+            ...(packageJson.devDependencies ?? {}),
+            ...(needsDataViews
+                ? {
+                    '@wp-typia/dataviews': packageJson.devDependencies?.['@wp-typia/dataviews'] ??
+                        wpTypiaDataViewsVersion,
+                }
+                : {}),
+        };
+        if (JSON.stringify(nextDependencies) ===
+            JSON.stringify(packageJson.dependencies ?? {}) &&
+            JSON.stringify(nextDevDependencies) ===
+                JSON.stringify(packageJson.devDependencies ?? {})) {
+            return source;
+        }
+        packageJson.dependencies = nextDependencies;
+        packageJson.devDependencies = nextDevDependencies;
+        return `${JSON.stringify(packageJson, null, detectJsonIndent(source))}\n`;
+    });
+}
+async function ensureAdminViewBootstrapAnchors(workspace) {
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    await patchFile(bootstrapPath, (source) => {
+        let nextSource = source;
+        const loadFunctionName = `${workspace.workspace.phpPrefix}_load_admin_views`;
+        const loadHook = `add_action( 'plugins_loaded', '${loadFunctionName}' );`;
+        const loadHookPattern = new RegExp(`add_action\\(\\s*['"]plugins_loaded['"]\\s*,\\s*['"]${loadFunctionName}['"]\\s*\\)\\s*;`, 'u');
+        const loadFunction = `
+
+function ${loadFunctionName}() {
+\tforeach ( glob( __DIR__ . '${ADMIN_VIEWS_PHP_GLOB}' ) ?: array() as $admin_view_module ) {
+\t\trequire_once $admin_view_module;
+\t}
+}
+`;
+        if (!hasPhpFunctionDefinition(nextSource, loadFunctionName)) {
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, loadFunction);
+        }
+        else {
+            const functionRange = findPhpFunctionRange(nextSource, loadFunctionName);
+            const functionSource = functionRange
+                ? nextSource.slice(functionRange.start, functionRange.end)
+                : '';
+            if (!functionSource.includes(ADMIN_VIEWS_PHP_GLOB)) {
+                const replacedSource = replacePhpFunctionDefinition(nextSource, loadFunctionName, loadFunction);
+                if (!replacedSource) {
+                    throw new Error(`Unable to repair ${path.basename(bootstrapPath)} for ${loadFunctionName}.`);
+                }
+                nextSource = replacedSource;
+            }
+        }
+        if (!loadHookPattern.test(nextSource)) {
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
+        }
+        return nextSource;
+    });
+}
+async function ensureAdminViewBuildScriptAnchors(workspace) {
+    const buildScriptPath = path.join(workspace.projectDir, 'scripts', 'build-workspace.mjs');
+    await patchFile(buildScriptPath, (source) => {
+        if (/['"]src\/admin-views\/index\.(?:ts|js)['"]/u.test(source)) {
+            return source;
+        }
+        const currentSharedEntriesPattern = /(\r?\n\s*['"]src\/editor-plugins\/index\.js['"])\s*,?/u;
+        let nextSource = source.replace(currentSharedEntriesPattern, `$1,
+\t\t'src/admin-views/index.ts',
+\t\t'src/admin-views/index.js',`);
+        if (nextSource !== source) {
+            return nextSource;
+        }
+        const legacySharedEntriesPattern = /\[\s*['"]src\/bindings\/index\.ts['"]\s*,\s*['"]src\/bindings\/index\.js['"]\s*(?:,\s*)?\]/u;
+        nextSource = source.replace(legacySharedEntriesPattern, `[
+\t\t'src/bindings/index.ts',
+\t\t'src/bindings/index.js',
+\t\t'src/editor-plugins/index.ts',
+\t\t'src/editor-plugins/index.js',
+\t\t'src/admin-views/index.ts',
+\t\t'src/admin-views/index.js',
+\t]`);
+        if (nextSource !== source) {
+            return nextSource;
+        }
+        throw new Error(`Unable to update ${path.relative(workspace.projectDir, buildScriptPath)} for admin view shared entries.`);
+    });
+}
+async function ensureAdminViewWebpackAnchors(workspace) {
+    const webpackConfigPath = path.join(workspace.projectDir, 'webpack.config.js');
+    await patchFile(webpackConfigPath, (source) => {
+        if (/['"]admin-views\/index['"]/u.test(source)) {
+            return source;
+        }
+        const editorPluginEntryPattern = /(\n\s*\[\s*['"]editor-plugins\/index['"][\s\S]*?['"]src\/editor-plugins\/index\.js['"][\s\S]*?\]\s*\])\s*,?/u;
+        let nextSource = source.replace(editorPluginEntryPattern, `$1,
+\t\t[
+\t\t\t'admin-views/index',
+\t\t\t[ 'src/admin-views/index.ts', 'src/admin-views/index.js' ],
+\t\t],`);
+        if (nextSource !== source) {
+            return nextSource;
+        }
+        const legacySharedEntriesBlockPattern = /for\s*\(\s*const\s+relativePath\s+of\s+\[\s*['"]src\/bindings\/index\.ts['"]\s*,\s*['"]src\/bindings\/index\.js['"]\s*(?:,\s*)?\]\s*\)\s*\{[\s\S]*?entries\.push\(\s*\[\s*['"]bindings\/index['"]\s*,\s*entryPath\s*\]\s*\);\s*break;\s*\}/u;
+        const nextSharedEntriesBlock = `\tfor ( const [ entryName, candidates ] of [\n\t\t[\n\t\t\t'bindings/index',\n\t\t\t[ 'src/bindings/index.ts', 'src/bindings/index.js' ],\n\t\t],\n\t\t[\n\t\t\t'editor-plugins/index',\n\t\t\t[ 'src/editor-plugins/index.ts', 'src/editor-plugins/index.js' ],\n\t\t],\n\t\t[\n\t\t\t'admin-views/index',\n\t\t\t[ 'src/admin-views/index.ts', 'src/admin-views/index.js' ],\n\t\t],\n\t] ) {\n\t\tfor ( const relativePath of candidates ) {\n\t\t\tconst entryPath = path.resolve( process.cwd(), relativePath );\n\t\t\tif ( ! fs.existsSync( entryPath ) ) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tentries.push( [ entryName, entryPath ] );\n\t\t\tbreak;\n\t\t}\n\t}`;
+        nextSource = source.replace(legacySharedEntriesBlockPattern, nextSharedEntriesBlock);
+        if (nextSource === source) {
+            throw new Error(`Unable to update ${path.relative(workspace.projectDir, webpackConfigPath)} for admin view shared entries.`);
+        }
+        return nextSource;
+    });
+}
+async function resolveAdminViewRegistryPath(projectDir) {
+    const adminViewsDir = path.join(projectDir, 'src', 'admin-views');
+    for (const candidatePath of [
+        path.join(adminViewsDir, 'index.ts'),
+        path.join(adminViewsDir, 'index.js'),
+    ]) {
+        if (await pathExists(candidatePath)) {
+            return candidatePath;
+        }
+    }
+    return path.join(adminViewsDir, 'index.ts');
+}
+async function readAdminViewRegistrySlugs(registryPath) {
+    const source = await readOptionalUtf8File(registryPath);
+    if (source === null) {
+        return [];
+    }
+    return Array.from(source.matchAll(/^\s*import\s+['"]\.\/([^/'"]+)(?:\/index(?:\.[cm]?[jt]sx?)?)?['"];?\s*$/gmu)).map((match) => match[1]);
+}
+async function writeAdminViewRegistry(projectDir, adminViewSlug) {
+    const adminViewsDir = path.join(projectDir, 'src', 'admin-views');
+    const registryPath = await resolveAdminViewRegistryPath(projectDir);
+    await fsp.mkdir(adminViewsDir, { recursive: true });
+    const existingAdminViewSlugs = (await readWorkspaceInventoryAsync(projectDir)).adminViews.map((entry) => entry.slug);
+    const existingRegistrySlugs = await readAdminViewRegistrySlugs(registryPath);
+    const nextAdminViewSlugs = Array.from(new Set([
+        ...existingAdminViewSlugs,
+        ...existingRegistrySlugs,
+        adminViewSlug,
+    ])).sort();
+    await fsp.writeFile(registryPath, buildAdminViewRegistrySource(nextAdminViewSlugs), 'utf8');
+}
+export async function scaffoldAdminViewWorkspace(options) {
+    const { adminViewSlug, coreDataSource, parsedSource, restResource, workspace, } = options;
+    const blockConfigPath = path.join(workspace.projectDir, 'scripts', 'block-config.ts');
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    const buildScriptPath = path.join(workspace.projectDir, 'scripts', 'build-workspace.mjs');
+    const packageJsonPath = path.join(workspace.projectDir, 'package.json');
+    const webpackConfigPath = path.join(workspace.projectDir, 'webpack.config.js');
+    const adminViewsIndexPath = await resolveAdminViewRegistryPath(workspace.projectDir);
+    const adminViewDir = path.join(workspace.projectDir, 'src', 'admin-views', adminViewSlug);
+    const manualSettingsRestResource = isAdminViewManualSettingsRestResource(restResource) ? restResource : undefined;
+    const manualSettingsRestApiPath = manualSettingsRestResource
+        ? path.join(workspace.projectDir, manualSettingsRestResource.apiFile)
+        : undefined;
+    const adminViewPhpPath = path.join(workspace.projectDir, 'inc', 'admin-views', `${adminViewSlug}.php`);
+    await executeWorkspaceMutationPlan({
+        filePaths: [
+            adminViewsIndexPath,
+            blockConfigPath,
+            bootstrapPath,
+            buildScriptPath,
+            packageJsonPath,
+            webpackConfigPath,
+            ...(manualSettingsRestApiPath ? [manualSettingsRestApiPath] : []),
+        ],
+        targetPaths: [adminViewDir, adminViewPhpPath],
+        run: async () => {
+            await fsp.mkdir(adminViewDir, { recursive: true });
+            await fsp.mkdir(path.dirname(adminViewPhpPath), { recursive: true });
+            await ensureAdminViewPackageDependencies(workspace, parsedSource, restResource);
+            await ensureAdminViewBootstrapAnchors(workspace);
+            await ensureAdminViewBuildScriptAnchors(workspace);
+            await ensureAdminViewWebpackAnchors(workspace);
+            if (manualSettingsRestResource) {
+                await ensureManualSettingsRestApiShim(workspace, manualSettingsRestResource);
+            }
+            await fsp.writeFile(path.join(adminViewDir, 'types.ts'), manualSettingsRestResource
+                ? buildRestSettingsAdminViewTypesSource(adminViewSlug, manualSettingsRestResource)
+                : buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'config.ts'), manualSettingsRestResource
+                ? buildRestSettingsAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, manualSettingsRestResource)
+                : buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, parsedSource, restResource), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'data.ts'), manualSettingsRestResource
+                ? buildRestSettingsAdminViewDataSource(adminViewSlug, manualSettingsRestResource)
+                : coreDataSource
+                    ? buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource)
+                    : restResource
+                        ? buildRestAdminViewDataSource(adminViewSlug, restResource)
+                        : buildDefaultAdminViewDataSource(adminViewSlug), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'Screen.tsx'), manualSettingsRestResource
+                ? buildRestSettingsAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain)
+                : coreDataSource
+                    ? buildCoreDataAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain)
+                    : buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'index.tsx'), buildAdminViewEntrySource(adminViewSlug, {
+                includeDataViewsStyle: !manualSettingsRestResource,
+            }), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'style.scss'), buildAdminViewStyleSource(), 'utf8');
+            await fsp.writeFile(adminViewPhpPath, buildAdminViewPhpSource(adminViewSlug, workspace), 'utf8');
+            await writeAdminViewRegistry(workspace.projectDir, adminViewSlug);
+            await appendWorkspaceInventoryEntries(workspace.projectDir, {
+                adminViewEntries: [
+                    buildAdminViewConfigEntry(adminViewSlug, parsedSource),
+                ],
+            });
+        },
+    });
+}

package/dist/runtime/add/cli-add-workspace-admin-view-source.d.ts

@@ -0,0 +1,12 @@
+import { type AdminViewRestResource, type AdminViewSource } from './cli-add-workspace-admin-view-types.js';
+/**
+ * Assert that admin-view package dependencies are available before file writes.
+ *
+ * This is a no-op while `@wp-typia/dataviews` is publicly available on npm.
+ * The exported seam is retained so future availability checks can stay
+ * centralized ahead of scaffold mutations.
+ */
+export declare function assertAdminViewPackageAvailability(): void;
+export declare function parseAdminViewSource(source?: string): AdminViewSource | undefined;
+export declare function resolveRestResourceSource(restResources: AdminViewRestResource[], source: AdminViewSource | undefined): AdminViewRestResource | undefined;
+export declare function resolveAdminViewCoreDataSource(source: AdminViewSource | undefined): import("./cli-add-workspace-admin-view-types.js").AdminViewCoreDataSource | undefined;

package/dist/runtime/add/cli-add-workspace-admin-view-source.js

@@ -0,0 +1,94 @@
+import { assertValidGeneratedSlug } from './cli-add-shared.js';
+import { ADMIN_VIEW_CORE_DATA_ENTITY_KIND_IDS, ADMIN_VIEW_CORE_DATA_ENTITY_NAME_PATTERN, ADMIN_VIEW_CORE_DATA_ENTITY_SEGMENT_PATTERN, ADMIN_VIEW_CORE_DATA_SOURCE_KIND, ADMIN_VIEW_REST_SOURCE_KIND, ADMIN_VIEW_SOURCE_USAGE, hasAdminViewManualSettingsRouteParameters, isAdminViewCoreDataSource, isAdminViewManualSettingsRestResource, isAdminViewRestResourceSource, } from './cli-add-workspace-admin-view-types.js';
+/**
+ * Assert that admin-view package dependencies are available before file writes.
+ *
+ * This is a no-op while `@wp-typia/dataviews` is publicly available on npm.
+ * The exported seam is retained so future availability checks can stay
+ * centralized ahead of scaffold mutations.
+ */
+export function assertAdminViewPackageAvailability() {
+    return;
+}
+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;
+}
+export function parseAdminViewSource(source) {
+    const trimmed = source?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    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>`.');
+    }
+    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>`.');
+}
+export function resolveRestResourceSource(restResources, source) {
+    if (!isAdminViewRestResourceSource(source)) {
+        return undefined;
+    }
+    const restResource = restResources.find((entry) => entry.slug === source.slug);
+    if (!restResource) {
+        throw new Error(`Unknown REST resource source "${source.slug}". Choose one of: ${restResources.map((entry) => entry.slug).join(', ') || '<none>'}.`);
+    }
+    if (isAdminViewManualSettingsRestResource(restResource)) {
+        if (hasAdminViewManualSettingsRouteParameters(restResource)) {
+            throw new Error(`REST resource source "${source.slug}" uses route parameters or regex groups and cannot scaffold a singleton admin settings form. Use a manual REST contract without path parameters or build a custom admin UI.`);
+        }
+        return restResource;
+    }
+    if (restResource.mode === 'manual') {
+        throw new Error(`REST resource source "${source.slug}" must define a request body type before it can scaffold an admin settings form.`);
+    }
+    if (!restResource.methods.includes('list')) {
+        throw new Error(`REST resource source "${source.slug}" must include the list method for DataViews pagination or be a manual settings contract with a body type.`);
+    }
+    return restResource;
+}
+export function resolveAdminViewCoreDataSource(source) {
+    return isAdminViewCoreDataSource(source) ? source : undefined;
+}

package/dist/runtime/add/cli-add-workspace-admin-view-templates-core-data.d.ts

@@ -0,0 +1,34 @@
+import { type AdminViewCoreDataSource } from './cli-add-workspace-admin-view-types.js';
+/**
+ * Builds TypeScript item and dataset types for a core-data-backed admin view.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated type names.
+ * @param coreDataSource - WordPress core-data entity source for the admin view.
+ * @returns Generated TypeScript source for core-data admin-view types.
+ */
+export declare function buildCoreDataAdminViewTypesSource(adminViewSlug: string, coreDataSource: AdminViewCoreDataSource): string;
+/**
+ * Builds a DataViews config module for a core-data-backed admin view.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated identifiers.
+ * @param textDomain - WordPress i18n text domain for generated labels.
+ * @param coreDataSource - WordPress core-data entity source for field selection.
+ * @returns Generated TypeScript source for the core-data DataViews config.
+ */
+export declare function buildCoreDataAdminViewConfigSource(adminViewSlug: string, textDomain: string, coreDataSource: AdminViewCoreDataSource): string;
+/**
+ * Builds data hooks for loading records from the WordPress core-data store.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated identifiers.
+ * @param coreDataSource - WordPress core-data entity source for generated hooks.
+ * @returns Generated TypeScript source for core-data data access.
+ */
+export declare function buildCoreDataAdminViewDataSource(adminViewSlug: string, coreDataSource: AdminViewCoreDataSource): string;
+/**
+ * Builds the React screen module for a core-data-backed admin view.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated identifiers.
+ * @param textDomain - WordPress i18n text domain for generated labels.
+ * @returns Generated TSX source for the core-data admin-view screen.
+ */
+export declare function buildCoreDataAdminViewScreenSource(adminViewSlug: string, textDomain: string): string;