@wp-typia/project-tools 0.24.4 → 0.24.6

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

@@ -0,0 +1,370 @@
+import { quoteTsString } from './cli-add-shared.js';
+import { getAdminViewRelativeModuleSpecifier } from './cli-add-workspace-admin-view-templates-shared.js';
+import { toCamelCase, toPascalCase, toTitleCase } from '../shared/string-case.js';
+/**
+ * Builds TypeScript request, response, and form-state types for REST settings.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated type names.
+ * @param restResource - Manual REST settings resource metadata for imports.
+ * @returns Generated TypeScript source for REST settings types.
+ */
+export function buildRestSettingsAdminViewTypesSource(adminViewSlug, restResource) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const restTypesModule = getAdminViewRelativeModuleSpecifier(adminViewSlug, restResource.typesFile);
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const loadResultTypeName = `${pascalName}SettingsLoadResult`;
+    return `import type {
+\t${restResource.bodyTypeName},
+\t${restResource.queryTypeName},
+\t${restResource.responseTypeName},
+} from ${quoteTsString(restTypesModule)};
+
+export type ${pascalName}SettingsRequest = ${restResource.bodyTypeName};
+export type ${pascalName}SettingsQuery = ${restResource.queryTypeName};
+export type ${pascalName}SettingsResponse = ${restResource.responseTypeName};
+export type ${formStateTypeName} = Partial<${pascalName}SettingsRequest>;
+
+export interface ${loadResultTypeName} {
+\tform: ${formStateTypeName};
+\tresponse: ${pascalName}SettingsResponse | null;
+}
+`;
+}
+/**
+ * Builds display metadata for a manual REST settings form admin screen.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated identifiers.
+ * @param textDomain - WordPress i18n text domain for generated labels.
+ * @param restResource - Manual REST settings metadata, including secret fields.
+ * @returns Generated TypeScript source for settings form configuration.
+ */
+export function buildRestSettingsAdminViewConfigSource(adminViewSlug, textDomain, restResource) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const camelName = toCamelCase(adminViewSlug);
+    const title = toTitleCase(adminViewSlug);
+    const configName = `${camelName}SettingsConfig`;
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const secretPreserveOnEmpty = restResource.secretPreserveOnEmpty !== false;
+    const secretFieldSource = restResource.secretFieldName && restResource.secretStateFieldName
+        ? `\t{
+\t\tdescription: __( ${quoteTsString(secretPreserveOnEmpty
+            ? 'Write-only secret value. Leave blank to keep the existing secret.'
+            : 'Write-only secret value. Blank submissions are sent to the REST route.')}, ${quoteTsString(textDomain)} ),
+\t\tid: ${quoteTsString(restResource.secretFieldName)},
+\t\tlabel: __( ${quoteTsString(toTitleCase(restResource.secretFieldName))}, ${quoteTsString(textDomain)} ),
+\t\tpreserveOnEmpty: ${secretPreserveOnEmpty},
+\t\tsecretStateField: ${quoteTsString(restResource.secretStateFieldName)},
+\t\ttype: 'secret',
+\t},`
+        : '';
+    return `import { __ } from '@wordpress/i18n';
+
+import type { ${formStateTypeName} } from './types';
+
+export type ${pascalName}SettingsFieldType = 'secret' | 'text' | 'textarea';
+
+export interface ${pascalName}SettingsField {
+\tdescription?: string;
+\tid: Extract<keyof ${formStateTypeName}, string> | string;
+\tlabel: string;
+\tpreserveOnEmpty?: boolean;
+\tsecretStateField?: string;
+\ttype: ${pascalName}SettingsFieldType;
+}
+
+export const ${configName} = {
+\tdescription: __( 'This generated settings form is backed by the ${restResource.slug} REST contract. Adjust config.ts and data.ts as the contract becomes product-specific.', ${quoteTsString(textDomain)} ),
+\tfields: [
+\t\t{
+\t\t\tdescription: __( 'Primary settings payload for this integration.', ${quoteTsString(textDomain)} ),
+\t\t\tid: 'payload',
+\t\t\tlabel: __( 'Payload', ${quoteTsString(textDomain)} ),
+\t\t\ttype: 'textarea',
+\t\t},
+\t\t{
+\t\t\tdescription: __( 'Optional operator note included with the save request.', ${quoteTsString(textDomain)} ),
+\t\t\tid: 'comment',
+\t\t\tlabel: __( 'Comment', ${quoteTsString(textDomain)} ),
+\t\t\ttype: 'text',
+\t\t},
+${secretFieldSource}
+\t] satisfies ${pascalName}SettingsField[],
+\tsecretFieldName: ${restResource.secretFieldName ? quoteTsString(restResource.secretFieldName) : 'undefined'},
+\tsecretPreserveOnEmpty: ${restResource.secretFieldName ? secretPreserveOnEmpty : 'undefined'},
+\tsecretStateFieldName: ${restResource.secretStateFieldName ? quoteTsString(restResource.secretStateFieldName) : 'undefined'},
+\ttitle: __( ${quoteTsString(title)}, ${quoteTsString(textDomain)} ),
+};
+`;
+}
+/**
+ * Builds load and save helpers for a manual REST settings form.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive generated identifiers.
+ * @param restResource - Manual REST settings metadata for API imports and secret handling.
+ * @returns Generated TypeScript source for settings data helpers.
+ */
+export function buildRestSettingsAdminViewDataSource(adminViewSlug, restResource) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const restApiModule = getAdminViewRelativeModuleSpecifier(adminViewSlug, restResource.apiFile);
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const loadResultTypeName = `${pascalName}SettingsLoadResult`;
+    const loadName = `load${pascalName}Settings`;
+    const saveName = `save${pascalName}Settings`;
+    const secretPreserveOnEmpty = restResource.secretPreserveOnEmpty !== false;
+    const initialFieldLines = [
+        '\tpayload: \'\',',
+        '\tcomment: \'\',',
+        ...(restResource.secretFieldName && !secretPreserveOnEmpty
+            ? [`\t${quoteTsString(restResource.secretFieldName)}: '',`]
+            : []),
+    ];
+    const initialFields = initialFieldLines.join('\n');
+    const requestBodySource = restResource.secretFieldName && secretPreserveOnEmpty
+        ? `\tconst requestBody = { ...form } as Record<string, unknown>;
+\tif (requestBody[${quoteTsString(restResource.secretFieldName)}] === '') {
+\t\tdelete requestBody[${quoteTsString(restResource.secretFieldName)}];
+\t}
+`
+        : `\tconst requestBody = form as Record<string, unknown>;
+`;
+    return `import { callManualRestContract } from ${quoteTsString(restApiModule)};
+import type {
+\t${formStateTypeName},
+\t${loadResultTypeName},
+\t${pascalName}SettingsQuery,
+\t${pascalName}SettingsRequest,
+\t${pascalName}SettingsResponse,
+} from './types';
+
+function formatValidationError(prefix: string, errors: unknown): string {
+\tif (!Array.isArray(errors) || errors.length === 0) {
+\t\treturn prefix;
+\t}
+
+\treturn \`\${prefix} \${JSON.stringify(errors)}\`;
+}
+
+export function createInitial${pascalName}SettingsFormState(): ${formStateTypeName} {
+\treturn {
+${initialFields}
+\t} as ${formStateTypeName};
+}
+
+export async function ${loadName}(): Promise<${loadResultTypeName}> {
+\treturn {
+\t\tform: createInitial${pascalName}SettingsFormState(),
+\t\tresponse: null,
+\t};
+}
+
+export async function ${saveName}(
+\tform: ${formStateTypeName},
+\tquery: Partial<${pascalName}SettingsQuery> = {},
+): Promise<${pascalName}SettingsResponse> {
+${requestBodySource}
+\tconst result = await callManualRestContract({
+\t\tbody: requestBody as unknown as ${pascalName}SettingsRequest,
+\t\tquery: query as ${pascalName}SettingsQuery,
+\t});
+\tif (!result.isValid) {
+\t\tconst message =
+\t\t\tresult.validationTarget === 'request'
+\t\t\t\t? 'Settings request failed validation.'
+\t\t\t\t: 'Settings response failed validation.';
+\t\tthrow new Error(formatValidationError(message, result.errors));
+\t}
+
+\treturn result.data as ${pascalName}SettingsResponse;
+}
+`;
+}
+/**
+ * Builds the React form screen for a manual REST settings 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 REST settings screen.
+ */
+export function buildRestSettingsAdminViewScreenSource(adminViewSlug, textDomain) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const componentName = `${pascalName}AdminViewScreen`;
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const responseTypeName = `${pascalName}SettingsResponse`;
+    const camelName = toCamelCase(adminViewSlug);
+    const configName = `${camelName}SettingsConfig`;
+    const loadName = `load${pascalName}Settings`;
+    const saveName = `save${pascalName}Settings`;
+    return `import {
+\tButton,
+\tNotice,
+\tSpinner,
+\tTextControl,
+\tTextareaControl,
+} from '@wordpress/components';
+import { useEffect, useState } from '@wordpress/element';
+import { __ } from '@wordpress/i18n';
+
+import { ${configName} } from './config';
+import { ${loadName}, ${saveName} } from './data';
+import type { ${formStateTypeName}, ${responseTypeName} } from './types';
+
+function getFieldValue(form: ${formStateTypeName}, fieldId: string): string {
+\tconst value = (form as Record<string, unknown>)[fieldId];
+\tif (typeof value === 'string') {
+\t\treturn value;
+\t}
+\tif (value == null) {
+\t\treturn '';
+\t}
+
+\treturn String(value);
+}
+
+function getSecretState(response: ${responseTypeName} | null): boolean | null {
+\tconst stateField = ${configName}.secretStateFieldName;
+\tif (!stateField || !response) {
+\t\treturn null;
+\t}
+
+\tconst value = (response as unknown as Record<string, unknown>)[stateField];
+\treturn typeof value === 'boolean' ? value : null;
+}
+
+export function ${componentName}() {
+\tconst [form, setForm] = useState<${formStateTypeName}>({});
+\tconst [response, setResponse] = useState<${responseTypeName} | null>(null);
+\tconst [error, setError] = useState<string | null>(null);
+\tconst [isLoading, setIsLoading] = useState(true);
+\tconst [isSaving, setIsSaving] = useState(false);
+\tconst [successMessage, setSuccessMessage] = useState<string | null>(null);
+
+\tuseEffect(() => {
+\t\tlet isCurrent = true;
+\t\tsetIsLoading(true);
+\t\tsetError(null);
+
+\t\tvoid ${loadName}()
+\t\t\t.then((result) => {
+\t\t\t\tif (isCurrent) {
+\t\t\t\t\tsetForm(result.form);
+\t\t\t\t\tsetResponse(result.response);
+\t\t\t\t}
+\t\t\t})
+\t\t\t.catch((nextError: unknown) => {
+\t\t\t\tif (isCurrent) {
+\t\t\t\t\tsetError(
+\t\t\t\t\t\tnextError instanceof Error
+\t\t\t\t\t\t\t? nextError.message
+\t\t\t\t\t\t\t: __( 'Unable to prepare settings form.', ${quoteTsString(textDomain)} ),
+\t\t\t\t\t);
+\t\t\t\t}
+\t\t\t})
+\t\t\t.finally(() => {
+\t\t\t\tif (isCurrent) {
+\t\t\t\t\tsetIsLoading(false);
+\t\t\t\t}
+\t\t\t});
+
+\t\treturn () => {
+\t\t\tisCurrent = false;
+\t\t};
+\t}, []);
+
+\tconst setFormValue = (fieldId: string, value: string) => {
+\t\tsetForm(
+\t\t\t(current) =>
+\t\t\t\t({
+\t\t\t\t\t...current,
+\t\t\t\t\t[fieldId]: value,
+\t\t\t\t}) as ${formStateTypeName},
+\t\t);
+\t};
+\tconst secretState = getSecretState(response);
+
+\tconst handleSubmit = (event: { preventDefault: () => void }) => {
+\t\tevent.preventDefault();
+\t\tsetError(null);
+\t\tsetSuccessMessage(null);
+\t\tsetIsSaving(true);
+
+\t\tvoid ${saveName}(form)
+\t\t\t.then((nextResponse) => {
+\t\t\t\tsetResponse(nextResponse);
+\t\t\t\tsetSuccessMessage(__( 'Settings saved.', ${quoteTsString(textDomain)} ));
+\t\t\t})
+\t\t\t.catch((nextError: unknown) => {
+\t\t\t\tsetError(
+\t\t\t\t\tnextError instanceof Error
+\t\t\t\t\t\t? nextError.message
+\t\t\t\t\t\t: __( 'Unable to save settings.', ${quoteTsString(textDomain)} ),
+\t\t\t\t);
+\t\t\t})
+\t\t\t.finally(() => setIsSaving(false));
+\t};
+
+\treturn (
+\t\t<div className="wp-typia-admin-view-screen wp-typia-admin-view-screen--settings">
+\t\t\t<header className="wp-typia-admin-view-screen__header">
+\t\t\t\t<div>
+\t\t\t\t\t<p className="wp-typia-admin-view-screen__eyebrow">
+\t\t\t\t\t\t{ __( 'Typed settings screen', ${quoteTsString(textDomain)} ) }
+\t\t\t\t\t</p>
+\t\t\t\t\t<h1>{ ${configName}.title }</h1>
+\t\t\t\t\t<p>{ ${configName}.description }</p>
+\t\t\t\t</div>
+\t\t\t\t<div className="wp-typia-admin-view-screen__actions">
+\t\t\t\t\t{ isLoading || isSaving ? <Spinner /> : null }
+\t\t\t\t</div>
+\t\t\t</header>
+\t\t\t{ error ? (
+\t\t\t\t<Notice isDismissible={ false } status="error">
+\t\t\t\t\t{ error }
+\t\t\t\t</Notice>
+\t\t\t) : null }
+\t\t\t{ successMessage ? (
+\t\t\t\t<Notice isDismissible={ false } status="success">
+\t\t\t\t\t{ successMessage }
+\t\t\t\t</Notice>
+\t\t\t) : null }
+\t\t\t{ secretState !== null ? (
+\t\t\t\t<Notice isDismissible={ false } status="info">
+\t\t\t\t\t{ secretState
+\t\t\t\t\t\t? __( 'A secret is currently configured for this integration.', ${quoteTsString(textDomain)} )
+\t\t\t\t\t\t: __( 'No secret is currently configured for this integration.', ${quoteTsString(textDomain)} ) }
+\t\t\t\t</Notice>
+\t\t\t) : null }
+\t\t\t<form className="wp-typia-admin-view-screen__settings-form" onSubmit={ handleSubmit }>
+\t\t\t\t{ ${configName}.fields.map((field) => (
+\t\t\t\t\t<div className="wp-typia-admin-view-screen__field" key={ field.id }>
+\t\t\t\t\t\t{ field.type === 'textarea' ? (
+\t\t\t\t\t\t\t<TextareaControl
+\t\t\t\t\t\t\t\thelp={ field.description }
+\t\t\t\t\t\t\t\tlabel={ field.label }
+\t\t\t\t\t\t\t\tonChange={ (value) => setFormValue(field.id, value) }
+\t\t\t\t\t\t\t\tvalue={ getFieldValue(form, field.id) }
+\t\t\t\t\t\t\t/>
+\t\t\t\t\t\t) : (
+\t\t\t\t\t\t\t<TextControl
+\t\t\t\t\t\t\t\thelp={ field.description }
+\t\t\t\t\t\t\t\tlabel={ field.label }
+\t\t\t\t\t\t\t\tonChange={ (value) => setFormValue(field.id, value) }
+\t\t\t\t\t\t\t\ttype={ field.type === 'secret' ? 'password' : 'text' }
+\t\t\t\t\t\t\t\tvalue={ getFieldValue(form, field.id) }
+\t\t\t\t\t\t\t/>
+\t\t\t\t\t\t) }
+\t\t\t\t\t</div>
+\t\t\t\t)) }
+\t\t\t\t<Button
+\t\t\t\t\tdisabled={ isLoading || isSaving }
+\t\t\t\t\tisBusy={ isSaving }
+\t\t\t\t\ttype="submit"
+\t\t\t\t\tvariant="primary"
+\t\t\t\t>
+\t\t\t\t\t{ __( 'Save settings', ${quoteTsString(textDomain)} ) }
+\t\t\t\t</Button>
+\t\t\t</form>
+\t\t</div>
+\t);
+}
+`;
+}

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

@@ -0,0 +1,49 @@
+import { type AdminViewSource } from './cli-add-workspace-admin-view-types.js';
+import { type WorkspaceProject } from '../workspace/workspace-project.js';
+/**
+ * Resolves a relative module specifier from an admin-view module to a workspace file.
+ *
+ * @param adminViewSlug - Admin-view slug that determines the generated source directory.
+ * @param workspaceFile - Workspace file path to import from the admin-view module.
+ * @returns Relative extensionless module specifier for generated TypeScript imports.
+ */
+export declare function getAdminViewRelativeModuleSpecifier(adminViewSlug: string, workspaceFile: string): string;
+/**
+ * Builds one workspace admin-view config entry.
+ *
+ * @param adminViewSlug - Admin-view slug used for generated file paths.
+ * @param source - Optional source metadata stored with the config entry.
+ * @returns Generated TypeScript object entry for the admin-view registry.
+ */
+export declare function buildAdminViewConfigEntry(adminViewSlug: string, source: AdminViewSource | undefined): string;
+/**
+ * Builds the admin-view registry source that imports generated view entries.
+ *
+ * @param adminViewSlugs - Ordered admin-view slugs to import into the registry.
+ * @returns Generated TypeScript source for the admin-view registry module.
+ */
+export declare function buildAdminViewRegistrySource(adminViewSlugs: string[]): string;
+/**
+ * Builds the generated admin-view browser entrypoint.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive component and root ids.
+ * @param options - Optional entrypoint generation flags.
+ * @returns Generated TSX source for mounting the admin-view screen.
+ */
+export declare function buildAdminViewEntrySource(adminViewSlug: string, options?: {
+    includeDataViewsStyle?: boolean;
+}): string;
+/**
+ * Builds shared SCSS for generated admin-view screens.
+ *
+ * @returns Generated SCSS source for admin-view layouts and settings forms.
+ */
+export declare function buildAdminViewStyleSource(): string;
+/**
+ * Builds the PHP registration module for a generated admin-view page.
+ *
+ * @param adminViewSlug - Admin-view slug used for hooks, handles, and root ids.
+ * @param workspace - Workspace metadata used for PHP prefixes and text domains.
+ * @returns Generated PHP source for registering and enqueueing the admin view.
+ */
+export declare function buildAdminViewPhpSource(adminViewSlug: string, workspace: WorkspaceProject): string;

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

@@ -0,0 +1,259 @@
+import path from 'node:path';
+import { quoteTsString } from './cli-add-shared.js';
+import { ADMIN_VIEWS_ASSET, ADMIN_VIEWS_SCRIPT, ADMIN_VIEWS_STYLE, ADMIN_VIEWS_STYLE_RTL, formatAdminViewSourceLocator, } from './cli-add-workspace-admin-view-types.js';
+import { quotePhpString } from '../shared/php-utils.js';
+import { toPascalCase, toTitleCase } from '../shared/string-case.js';
+/**
+ * Resolves a relative module specifier from an admin-view module to a workspace file.
+ *
+ * @param adminViewSlug - Admin-view slug that determines the generated source directory.
+ * @param workspaceFile - Workspace file path to import from the admin-view module.
+ * @returns Relative extensionless module specifier for generated TypeScript imports.
+ */
+export function getAdminViewRelativeModuleSpecifier(adminViewSlug, workspaceFile) {
+    const adminViewDir = `src/admin-views/${adminViewSlug}`;
+    const normalizedFile = workspaceFile.replace(/\\/gu, '/');
+    const modulePath = normalizedFile.replace(/\.[cm]?[jt]sx?$/u, '');
+    const relativeModulePath = path.posix.relative(adminViewDir, modulePath);
+    return relativeModulePath.startsWith('.')
+        ? relativeModulePath
+        : `./${relativeModulePath}`;
+}
+/**
+ * Builds one workspace admin-view config entry.
+ *
+ * @param adminViewSlug - Admin-view slug used for generated file paths.
+ * @param source - Optional source metadata stored with the config entry.
+ * @returns Generated TypeScript object entry for the admin-view registry.
+ */
+export function buildAdminViewConfigEntry(adminViewSlug, source) {
+    return [
+        '\t{',
+        `\t\tfile: ${quoteTsString(`src/admin-views/${adminViewSlug}/index.tsx`)},`,
+        `\t\tphpFile: ${quoteTsString(`inc/admin-views/${adminViewSlug}.php`)},`,
+        `\t\tslug: ${quoteTsString(adminViewSlug)},`,
+        source
+            ? `\t\tsource: ${quoteTsString(formatAdminViewSourceLocator(source))},`
+            : null,
+        '\t},',
+    ]
+        .filter((line) => typeof line === 'string')
+        .join('\n');
+}
+/**
+ * Builds the admin-view registry source that imports generated view entries.
+ *
+ * @param adminViewSlugs - Ordered admin-view slugs to import into the registry.
+ * @returns Generated TypeScript source for the admin-view registry module.
+ */
+export function buildAdminViewRegistrySource(adminViewSlugs) {
+    const importLines = adminViewSlugs
+        .map((adminViewSlug) => `import './${adminViewSlug}';`)
+        .join('\n');
+    return `${importLines}${importLines ? '\n\n' : ''}// wp-typia add admin-view entries\n`;
+}
+/**
+ * Builds the generated admin-view browser entrypoint.
+ *
+ * @param adminViewSlug - Admin-view slug used to derive component and root ids.
+ * @param options - Optional entrypoint generation flags.
+ * @returns Generated TSX source for mounting the admin-view screen.
+ */
+export function buildAdminViewEntrySource(adminViewSlug, options = {}) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const componentName = `${pascalName}AdminViewScreen`;
+    const rootId = `wp-typia-admin-view-${adminViewSlug}`;
+    const dataViewsStyleImport = options.includeDataViewsStyle === false
+        ? ''
+        : "\nimport '@wordpress/dataviews/build-style/style.css';";
+    return `import { createRoot } from '@wordpress/element';
+${dataViewsStyleImport}
+import { ${componentName} } from './Screen';
+import './style.scss';
+
+const ROOT_ELEMENT_ID = ${quoteTsString(rootId)};
+
+function mountAdminView() {
+\tconst rootElement = document.getElementById(ROOT_ELEMENT_ID);
+\tif (!rootElement) {
+\t\treturn;
+\t}
+
+\tcreateRoot(rootElement).render(<${componentName} />);
+}
+
+if (document.readyState === 'loading') {
+\tdocument.addEventListener('DOMContentLoaded', mountAdminView);
+} else {
+\tmountAdminView();
+}
+`;
+}
+/**
+ * Builds shared SCSS for generated admin-view screens.
+ *
+ * @returns Generated SCSS source for admin-view layouts and settings forms.
+ */
+export function buildAdminViewStyleSource() {
+    return `.wp-typia-admin-view-screen {
+\tbox-sizing: border-box;
+\tmax-width: 1180px;
+\tpadding: 24px 24px 48px 0;
+}
+
+.wp-typia-admin-view-screen__header {
+\talign-items: flex-start;
+\tdisplay: flex;
+\tgap: 24px;
+\tjustify-content: space-between;
+\tmargin-bottom: 24px;
+}
+
+.wp-typia-admin-view-screen__header h1 {
+\tfont-size: 28px;
+\tline-height: 1.2;
+\tmargin: 0 0 8px;
+}
+
+.wp-typia-admin-view-screen__header p {
+\tmax-width: 680px;
+}
+
+.wp-typia-admin-view-screen__eyebrow {
+\tcolor: #3858e9;
+\tfont-size: 11px;
+\tfont-weight: 600;
+\tletter-spacing: 0.08em;
+\tmargin: 0 0 8px;
+\ttext-transform: uppercase;
+}
+
+.wp-typia-admin-view-screen__actions {
+\talign-items: center;
+\tdisplay: flex;
+\tgap: 12px;
+}
+
+.wp-typia-admin-view-screen__settings-form {
+\tbackground: #fff;
+\tborder: 1px solid #dcdcde;
+\tborder-radius: 2px;
+\tbox-shadow: 0 1px 1px rgba(0, 0, 0, 0.04);
+\tdisplay: grid;
+\tgap: 20px;
+\tmax-width: 720px;
+\tpadding: 24px;
+}
+
+.wp-typia-admin-view-screen__field .components-base-control {
+\tmargin-bottom: 0;
+}
+`;
+}
+/**
+ * Builds the PHP registration module for a generated admin-view page.
+ *
+ * @param adminViewSlug - Admin-view slug used for hooks, handles, and root ids.
+ * @param workspace - Workspace metadata used for PHP prefixes and text domains.
+ * @returns Generated PHP source for registering and enqueueing the admin view.
+ */
+export function buildAdminViewPhpSource(adminViewSlug, workspace) {
+    const workspaceBaseName = workspace.packageName.split('/').pop() ?? workspace.packageName;
+    const phpSlug = adminViewSlug.replace(/-/g, '_');
+    const functionPrefix = `${workspace.workspace.phpPrefix}_${phpSlug}`;
+    const menuSlugFunctionName = `${functionPrefix}_admin_view_menu_slug`;
+    const renderFunctionName = `${functionPrefix}_render_admin_view`;
+    const registerFunctionName = `${functionPrefix}_register_admin_view`;
+    const enqueueFunctionName = `${functionPrefix}_enqueue_admin_view`;
+    const hookGlobalName = `${functionPrefix}_admin_view_hook`;
+    const rootId = `wp-typia-admin-view-${adminViewSlug}`;
+    const title = toTitleCase(adminViewSlug);
+    return `<?php
+if ( ! defined( 'ABSPATH' ) ) {
+\treturn;
+}
+
+if ( ! function_exists( '${menuSlugFunctionName}' ) ) {
+\tfunction ${menuSlugFunctionName}() : string {
+\t\treturn '${workspaceBaseName}-${adminViewSlug}';
+\t}
+}
+
+if ( ! function_exists( '${renderFunctionName}' ) ) {
+\tfunction ${renderFunctionName}() : void {
+\t\t?>
+\t\t<div class="wrap">
+\t\t\t<div id="${rootId}"></div>
+\t\t</div>
+\t\t<?php
+\t}
+}
+
+if ( ! function_exists( '${registerFunctionName}' ) ) {
+\tfunction ${registerFunctionName}() : void {
+\t\t$GLOBALS['${hookGlobalName}'] = add_submenu_page(
+\t\t\t'tools.php',
+\t\t\t__( ${quotePhpString(title)}, ${quotePhpString(workspace.workspace.textDomain)} ),
+\t\t\t__( ${quotePhpString(title)}, ${quotePhpString(workspace.workspace.textDomain)} ),
+\t\t\t'edit_posts',
+\t\t\t${menuSlugFunctionName}(),
+\t\t\t'${renderFunctionName}'
+\t\t);
+\t}
+}
+
+if ( ! function_exists( '${enqueueFunctionName}' ) ) {
+\tfunction ${enqueueFunctionName}( string $hook_suffix ) : void {
+\t\t$page_hook = isset( $GLOBALS['${hookGlobalName}'] ) && is_string( $GLOBALS['${hookGlobalName}'] )
+\t\t\t? $GLOBALS['${hookGlobalName}']
+\t\t\t: '';
+
+\t\tif ( $page_hook !== $hook_suffix ) {
+\t\t\treturn;
+\t\t}
+
+\t\t$plugin_file = dirname( __DIR__, 2 ) . '/${workspaceBaseName}.php';
+\t\t$script_path = dirname( __DIR__, 2 ) . '/${ADMIN_VIEWS_SCRIPT}';
+\t\t$asset_path  = dirname( __DIR__, 2 ) . '/${ADMIN_VIEWS_ASSET}';
+\t\t$style_path  = dirname( __DIR__, 2 ) . '/${ADMIN_VIEWS_STYLE}';
+\t\t$style_rtl_path = dirname( __DIR__, 2 ) . '/${ADMIN_VIEWS_STYLE_RTL}';
+
+\t\tif ( ! file_exists( $script_path ) || ! file_exists( $asset_path ) ) {
+\t\t\treturn;
+\t\t}
+
+\t\t$asset = require $asset_path;
+\t\tif ( ! is_array( $asset ) ) {
+\t\t\t$asset = array();
+\t\t}
+
+\t\t$dependencies = isset( $asset['dependencies'] ) && is_array( $asset['dependencies'] )
+\t\t\t? $asset['dependencies']
+\t\t\t: array();
+
+\t\twp_enqueue_script(
+\t\t\t'${workspaceBaseName}-${adminViewSlug}-admin-view',
+\t\t\tplugins_url( '${ADMIN_VIEWS_SCRIPT}', $plugin_file ),
+\t\t\t$dependencies,
+\t\t\tisset( $asset['version'] ) ? $asset['version'] : filemtime( $script_path ),
+\t\t\ttrue
+\t\t);
+
+\t\tif ( file_exists( $style_path ) ) {
+\t\t\twp_enqueue_style(
+\t\t\t\t'${workspaceBaseName}-${adminViewSlug}-admin-view',
+\t\t\t\tplugins_url( '${ADMIN_VIEWS_STYLE}', $plugin_file ),
+\t\t\t\tarray( 'wp-components' ),
+\t\t\t\tisset( $asset['version'] ) ? $asset['version'] : filemtime( $style_path )
+\t\t\t);
+\t\t\tif ( file_exists( $style_rtl_path ) ) {
+\t\t\t\twp_style_add_data( '${workspaceBaseName}-${adminViewSlug}-admin-view', 'rtl', 'replace' );
+\t\t\t}
+\t\t}
+\t}
+}
+
+add_action( 'admin_menu', '${registerFunctionName}' );
+add_action( 'admin_enqueue_scripts', '${enqueueFunctionName}' );
+`;
+}