@mpfrontend/nx-plugin 0.0.0-stage → 1.0.0

package/dist/scaffold.js

@@ -0,0 +1,227 @@
+import { readFile } from 'node:fs/promises';
+import { posix, resolve } from 'node:path';
+import { NAME_PATTERN, constant, exists, importPath, pascal, safeRelative, templateFiles, workspaceFormatter, writeNew } from './templates.js';
+export function diskReader(root) {
+    return {
+        exists: path => exists(resolve(root, path)),
+        read: async (path) => { try {
+            return await readFile(resolve(root, path), 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        } },
+    };
+}
+const prefix = (directory, files) => Object.fromEntries(Object.entries(files).map(([path, content]) => [directory + '/' + path, content]));
+/** The application template ships English only; a product adds its own locales to its registry. */
+export const TEMPLATE_LOCALES = { defaultLocale: 'en', locales: ['en'] };
+const localeCode = /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8}){0,3}$/;
+/** Reads the registry of `src/config/app.ts` as the application template writes it. */
+export function readAppLocales(source) {
+    const body = /createLocaleRegistry\(\{[\s\S]*?locales:\s*\{([\s\S]*?)\}\s*,\s*defaultLocale:\s*'([^']+)'/.exec(source);
+    if (!body)
+        return undefined;
+    const locales = [...body[1].matchAll(/(?:^|[,{\s])'?([a-z]{2,3}(?:-[A-Za-z0-9]{2,8}){0,3})'?\s*:\s*\{/g)].map(match => match[1]);
+    if (!locales.length || !locales.includes(body[2]) || locales.some(code => !localeCode.test(code)))
+        return undefined;
+    return { defaultLocale: body[2], locales };
+}
+const humanize = (name) => name.charAt(0).toUpperCase() + name.slice(1).replaceAll('-', ' ');
+const quote = (value) => "'" + value.replaceAll('\\', '\\\\').replaceAll("'", "\\'") + "'";
+const identifier = (code) => code.replaceAll('-', '_');
+/**
+ * The catalog set of a feature: one module per app locale under `model/messages/`, and `model/messages.ts`.
+ * The base locale holds the starter text; every other locale starts with the same text, to be translated.
+ */
+export function messageFiles(directory, base, locales, depth) {
+    const entries = Object.entries(base).map(([key, value]) => '  ' + key + ': ' + quote(value) + ',').join('\n');
+    const files = {};
+    files[directory + '/messages/' + locales.defaultLocale + '.ts'] = `import { defineMessages } from '@mpfrontend/i18n';\n\nexport default defineMessages({\n${entries}\n});\n`;
+    for (const code of locales.locales.filter(code => code !== locales.defaultLocale)) {
+        files[directory + '/messages/' + code + '.ts'] = `import type { Translation } from '@mpfrontend/i18n';\nimport type base from './${locales.defaultLocale}';\n\n// Starts with the base text: translate each message.\nexport default {\n${entries}\n} satisfies Translation<typeof base>;\n`;
+    }
+    const others = locales.locales.filter(code => code !== locales.defaultLocale);
+    files[directory + '/messages.ts'] = `import { coreMessages, createMessages } from '@mpfrontend/i18n';
+import { localeRegistry } from '${'../'.repeat(depth)}config/app';
+import base from './messages/${locales.defaultLocale}';
+${others.map(code => `import ${identifier(code)} from './messages/${code}';`).join('\n')}${others.length ? '\n' : ''}
+/** The messages of this unit. The base catalog defines the keys and their parameters. */
+export const messages = createMessages({
+  defaultLocale: ${quote(locales.defaultLocale)},
+  base,
+  // Each other locale of the registry: import its catalog and list it here.
+  translations: {${others.length ? ' ' + others.map(code => code.includes('-') ? quote(code) + ': ' + identifier(code) : code).join(', ') + ' ' : ''}},
+  core: coreMessages,
+  numberingSystem: localeRegistry.numberingSystem,
+});
+`;
+    return files;
+}
+const listMessages = (name) => ({
+    title: humanize(name), search: 'Search', apply: 'Apply', unavailable: 'The data is not available. Try again.', empty: 'No records found.', loading: 'Loading.',
+    detail: 'Details', back: 'Back', pagination: 'Pages', pageOf: 'Page {page, number} of {count, number}', previous: 'Previous', next: 'Next',
+    yes: 'Yes', no: 'No',
+});
+const screenMessages = (name) => ({
+    title: humanize(name), run: 'Run', running: 'Running', done: 'Done', failed: 'Not completed. Try again.', unbound: 'Not available yet.',
+});
+/**
+ * Files of a feature, relative to the app directory. Without a resource it is a `screen` feature: a view, a
+ * hook, a model, a request boundary and a helper. With a resource of the app's `ftg.config.json` it is a
+ * `list` feature: a URL-driven list and detail over that generated read, its entity and its server boundary.
+ */
+export async function featureFiles(name, options = {}) {
+    if (!NAME_PATTERN.test(name))
+        throw new Error('INVALID_FEATURE_NAME');
+    const locales = options.locales ?? TEMPLATE_LOCALES;
+    const model = 'features/' + name + '/model';
+    if (options.resource === undefined)
+        return prefix('src', { ...await templateFiles('feature/screen', { __feature__: name, __Feature__: pascal(name) }), ...messageFiles(model, screenMessages(name), locales, 3) });
+    if (!NAME_PATTERN.test(options.resource))
+        throw new Error('INVALID_RESOURCE_NAME');
+    const output = safeRelative(options.generatedOutput ?? '', 'INVALID_GENERATED_OUTPUT');
+    // The list protocol names the operation of the resource; it is checked against the captured contract.
+    if (!options.operationId || !/^[A-Za-z_][A-Za-z0-9_.-]{0,99}$/.test(options.operationId))
+        throw new Error('INVALID_OPERATION_ID');
+    return prefix('src', { ...await templateFiles('feature/list', {
+            __FEATURE_TO_OUTPUT__: importPath('src/features/' + name + '/model', output),
+            __ENTITY_TO_OUTPUT__: importPath('src/entities/' + options.resource + '/model', output),
+            __SERVER_TO_OUTPUT__: importPath('src/api/server', output),
+            __RESOURCE_CONSTANT__: constant(options.resource), __OPERATION_ID__: options.operationId,
+            __feature__: name, __Feature__: pascal(name), __resource__: options.resource, __Resource__: pascal(options.resource),
+        }), ...messageFiles(model, listMessages(name), locales, 3) });
+}
+export async function planFeature(reader, request) {
+    const app = safeRelative(request.app, 'INVALID_APP_DIRECTORY');
+    if (!NAME_PATTERN.test(request.name))
+        throw new Error('INVALID_FEATURE_NAME');
+    if (!await reader.exists(app + '/project.json'))
+        throw new Error('APP_NOT_FOUND');
+    if (await reader.exists(app + '/src/features/' + request.name))
+        throw new Error('DESTINATION_EXISTS');
+    const locales = readAppLocales(await reader.read(app + '/src/config/app.ts') ?? '');
+    if (!locales)
+        throw new Error('APP_PREREQUISITE_MISSING:src/config/app.ts locale registry');
+    // Feature screens render inside the shared page frame.
+    const manifest = JSON.parse(await reader.read(app + '/package.json') ?? '{}');
+    if (!manifest.dependencies?.['@mpfrontend/app-layout'])
+        throw new Error('APP_PREREQUISITE_MISSING:@mpfrontend/app-layout');
+    let generatedOutput, operationId;
+    if (request.resource !== undefined) {
+        for (const required of ['src/config/app.ts', 'src/config/server.ts'])
+            if (!await reader.exists(app + '/' + required))
+                throw new Error('APP_PREREQUISITE_MISSING:' + required);
+        const config = JSON.parse(await reader.read(app + '/ftg.config.json') ?? 'null');
+        if (!config || typeof config.output !== 'string' || !Array.isArray(config.resources))
+            throw new Error('APP_PREREQUISITE_MISSING:ftg.config.json');
+        const selected = config.resources.find(resource => resource.name === request.resource);
+        if (!selected)
+            throw new Error('UNKNOWN_RESOURCE');
+        if (typeof selected.operationId !== 'string')
+            throw new Error('APP_PREREQUISITE_MISSING:ftg.config.json operationId');
+        operationId = selected.operationId;
+        generatedOutput = posix.normalize(config.output);
+    }
+    const all = prefix(app, await featureFiles(request.name, { locales, ...(request.resource !== undefined ? { resource: request.resource } : {}), ...(operationId ? { operationId } : {}), ...(generatedOutput ? { generatedOutput } : {}) }));
+    const files = {}, kept = [];
+    for (const [path, content] of Object.entries(all)) {
+        // The entity and the server boundary of a resource are shared; an existing one is authored and kept.
+        if (!path.startsWith(app + '/src/features/') && await reader.exists(path)) {
+            kept.push(path);
+            continue;
+        }
+        files[path] = content;
+    }
+    const untranslated = Object.keys(files).filter(path => /\/model\/messages\/[^/]+\.ts$/.test(path) && !path.endsWith('/' + locales.defaultLocale + '.ts')).sort();
+    return { files, kept, untranslated };
+}
+// ------------------------------------------------------------------------------------------------------ routes
+const segmentPattern = /^(?:[a-z0-9][a-z0-9-]*|\[[a-z][a-zA-Z0-9]*\])$/;
+/** One Next.js route per screen: a thin page that renders a feature screen with the route's base path. */
+export function routeFiles(path, feature, screen) {
+    const segments = path.split('/');
+    if (!path || segments.some(segment => !segmentPattern.test(segment)) || segments[0] === 'api')
+        throw new Error('INVALID_ROUTE_PATH');
+    if (!NAME_PATTERN.test(feature))
+        throw new Error('INVALID_FEATURE_NAME');
+    if (!/^[A-Z][A-Za-z0-9]{0,79}$/.test(screen))
+        throw new Error('INVALID_SCREEN_NAME');
+    const dynamic = segments.filter(segment => segment.startsWith('[')).map(segment => segment.slice(1, -1));
+    if (new Set(dynamic).size !== dynamic.length)
+        throw new Error('INVALID_ROUTE_PATH');
+    const staticPart = segments.slice(0, segments.findIndex(segment => segment.startsWith('[')) >= 0 ? segments.findIndex(segment => segment.startsWith('[')) : segments.length);
+    const basePath = '/' + staticPart.join('/');
+    const entry = '../'.repeat(segments.length + 1) + 'features/' + feature;
+    const params = dynamic.length ? `type Params = Promise<{ ${dynamic.map(name => name + ': string').join('; ')} }>;\n` : '';
+    const props = dynamic.length ? '{ params: Params; searchParams: SearchParams }' : '{ searchParams: SearchParams }';
+    return { ['src/app/' + path + '/page.tsx']: `import { ${screen} } from '${entry}';
+
+${params}type SearchParams = Promise<Record<string, string | string[] | undefined>>;
+
+export default function Page(props: ${props}) {
+  return <${screen} {...props} basePath="${basePath}" />;
+}
+` };
+}
+export async function planRoute(reader, request) {
+    const app = safeRelative(request.app, 'INVALID_APP_DIRECTORY');
+    const screen = request.screen ?? pascal(request.feature) + 'Screen';
+    const files = prefix(app, routeFiles(request.path, request.feature, screen));
+    if (!await reader.exists(app + '/project.json'))
+        throw new Error('APP_NOT_FOUND');
+    const entry = await reader.read(app + '/src/features/' + request.feature + '/index.ts');
+    if (entry === undefined)
+        throw new Error('UNKNOWN_FEATURE');
+    if (!new RegExp('\\b' + screen + '\\b').test(entry))
+        throw new Error('UNKNOWN_FEATURE_SCREEN');
+    const directory = app + '/src/app/' + request.path;
+    for (const file of ['page.tsx', 'page.ts', 'page.jsx', 'page.js', 'route.ts', 'route.js'])
+        if (await reader.exists(directory + '/' + file))
+            throw new Error('DESTINATION_EXISTS');
+    return { files, kept: [] };
+}
+/** A shared package: tags, a public entry, a build to dist and the quality targets of the workspace. */
+export async function packageFiles(name, scope, directory, runtime = 'universal') {
+    if (!NAME_PATTERN.test(name))
+        throw new Error('INVALID_PACKAGE_NAME');
+    if (!/^[a-z0-9][a-z0-9._-]{0,99}$/.test(scope))
+        throw new Error('INVALID_PACKAGE_SCOPE');
+    if (!['universal', 'client', 'server'].includes(runtime))
+        throw new Error('INVALID_PACKAGE_RUNTIME');
+    if (!/^packages\/[a-z][a-z0-9-]{1,48}$/.test(directory))
+        throw new Error('INVALID_PACKAGE_DIRECTORY');
+    return prefix(directory, await templateFiles('package', { __SCOPE__: scope, __name__: name, __runtime__: runtime, __DIRECTORY__: directory }));
+}
+export async function planPackage(reader, request) {
+    const directory = request.directory ?? 'packages/' + request.name;
+    const manifest = JSON.parse(await reader.read('package.json') ?? 'null');
+    if (!manifest || typeof manifest.name !== 'string')
+        throw new Error('WORKSPACE_ROOT_REQUIRED');
+    const scope = manifest.name.startsWith('@') ? manifest.name.slice(1).split('/')[0] : manifest.name;
+    const files = await packageFiles(request.name, scope, directory, request.runtime ?? 'universal');
+    if (await reader.exists(directory))
+        throw new Error('DESTINATION_EXISTS');
+    return { files, kept: [] };
+}
+async function apply(plan, options) {
+    const root = resolve(options.root ?? process.cwd());
+    let formatted = false;
+    if (!options.dryRun)
+        formatted = await writeNew(root, plan.files, options.formatter ?? await workspaceFormatter(root));
+    return { files: Object.keys(plan.files).sort(), kept: plan.kept.sort(), ...(plan.untranslated ? { untranslated: plan.untranslated } : {}), dryRun: options.dryRun === true, formatted };
+}
+export async function createFeature(request) {
+    const plan = await planFeature(diskReader(resolve(request.root ?? process.cwd())), request);
+    return { ok: true, kind: (request.resource === undefined ? 'screen' : 'list'), name: request.name, ...await apply(plan, request) };
+}
+export async function createRoute(request) {
+    const plan = await planRoute(diskReader(resolve(request.root ?? process.cwd())), request);
+    return { ok: true, path: request.path, ...await apply(plan, request) };
+}
+export async function createPackage(request) {
+    const plan = await planPackage(diskReader(resolve(request.root ?? process.cwd())), request);
+    return { ok: true, name: request.name, ...await apply(plan, request) };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/templates.d.ts

@@ -0,0 +1,21 @@
+/** Lower-case kebab names: apps, features, resources and packages. */
+export declare const NAME_PATTERN: RegExp;
+export declare const pascal: (name: string) => string;
+export declare const constant: (name: string) => string;
+export type Replacements = Readonly<Record<string, string>>;
+/** Reads a template folder; placeholders are replaced in file paths and contents, `.template` is dropped. */
+export declare function templateFiles(folder: string, replacements: Replacements): Promise<Record<string, string>>;
+/** A POSIX import specifier from one source directory to another. */
+export declare function importPath(fromDirectory: string, toPath: string): string;
+/** A workspace-relative directory without traversal, absolute paths or backslashes. */
+export declare function safeRelative(path: string, error: string): string;
+export declare function exists(path: string): Promise<boolean>;
+/** Formats one file's content; `path` is the absolute path the file will be written to. */
+export type Formatter = (path: string, content: string) => Promise<string>;
+/**
+ * The workspace formatter, when the workspace has one: Prettier resolved from the workspace root with the
+ * workspace's own configuration. Without it, files are written exactly as the templates hold them.
+ */
+export declare function workspaceFormatter(root: string): Promise<Formatter | undefined>;
+/** Formats the files and writes them with exclusive creation; an existing file is never replaced. */
+export declare function writeNew(root: string, files: Record<string, string>, formatter?: Formatter): Promise<boolean>;

package/dist/templates.js

@@ -0,0 +1,83 @@
+import { readFile, readdir, lstat, mkdir, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve, relative, isAbsolute, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Lower-case kebab names: apps, features, resources and packages. */
+export const NAME_PATTERN = /^[a-z][a-z0-9-]{1,48}$/;
+export const pascal = (name) => name.split('-').map(part => part.charAt(0).toUpperCase() + part.slice(1)).join('');
+export const constant = (name) => name.replaceAll('-', '_').toUpperCase();
+/** Reads a template folder; placeholders are replaced in file paths and contents, `.template` is dropped. */
+export async function templateFiles(folder, replacements) {
+    const root = fileURLToPath(new URL('../templates/' + folder + '/', import.meta.url));
+    const apply = (text) => Object.entries(replacements).reduce((value, [key, replacement]) => value.replaceAll(key, replacement), text);
+    const result = {};
+    async function visit(dir, prefix) {
+        for (const entry of await readdir(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name), key = prefix + entry.name;
+            if (entry.isDirectory())
+                await visit(path, key + '/');
+            else
+                result[apply(key.replace(/\.template$/, ''))] = apply(await readFile(path, 'utf8'));
+        }
+    }
+    await visit(root, '');
+    return result;
+}
+/** A POSIX import specifier from one source directory to another. */
+export function importPath(fromDirectory, toPath) {
+    const path = relative(fromDirectory, toPath).split(sep).join('/');
+    return path.startsWith('.') ? path : './' + path;
+}
+/** A workspace-relative directory without traversal, absolute paths or backslashes. */
+export function safeRelative(path, error) {
+    const parts = path.split('/');
+    if (!path || isAbsolute(path) || path.includes('\\') || parts.some(part => part === '' || part === '.' || part === '..'))
+        throw new Error(error);
+    return parts.join('/');
+}
+export async function exists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+/**
+ * The workspace formatter, when the workspace has one: Prettier resolved from the workspace root with the
+ * workspace's own configuration. Without it, files are written exactly as the templates hold them.
+ */
+export async function workspaceFormatter(root) {
+    let entry;
+    try {
+        entry = createRequire(join(root, 'package.json')).resolve('prettier');
+    }
+    catch {
+        return undefined;
+    }
+    const loaded = await import(entry);
+    const prettier = (loaded.default ?? loaded);
+    return async (path, content) => {
+        // The parser comes from the file name; ignore files do not apply to output the generator is writing.
+        if (!(await prettier.getFileInfo(path, { withNodeModules: true })).inferredParser)
+            return content;
+        return prettier.format(content, { ...(await prettier.resolveConfig(path)), filepath: path });
+    };
+}
+/** Formats the files and writes them with exclusive creation; an existing file is never replaced. */
+export async function writeNew(root, files, formatter) {
+    const output = [];
+    for (const [path, content] of Object.entries(files)) {
+        const target = resolve(root, path);
+        output.push([target, formatter ? await formatter(target, content) : content]);
+    }
+    for (const [target, content] of output) {
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, content, { flag: 'wx' });
+    }
+    return formatter !== undefined;
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/dist/workspace.d.ts

@@ -0,0 +1,41 @@
+export type DesignSource = 'none' | 'existing';
+export type WorkspaceOptions = {
+    name: string;
+    directory: string;
+    designSource?: DesignSource;
+    dryRun?: boolean;
+};
+/** The cohort a new workspace pins; the quality profile is upgraded with it, never copied into the workspace. */
+export declare const COHORT: {
+    readonly cli: "1.0.0";
+    readonly nxPlugin: "1.0.0";
+    readonly workspaceConfig: "1.0.0";
+};
+/** The scope of the framework packages, bound to the registry that publishes them. */
+export declare const NPMRC = "@mpfrontend:registry=https://registry.npmjs.org/\nsave-exact=true\n";
+/** Tool versions the quality profile is verified with. */
+export declare const QUALITY_TOOLS: {
+    readonly eslint: "10.12.0";
+    readonly prettier: "3.9.9";
+    readonly tsx: "4.23.15";
+};
+/** Workspace scripts. `check` is the gate that CI and the CI-neutral script run. */
+export declare const WORKSPACE_SCRIPTS: {
+    readonly build: "nx run-many -t build";
+    readonly format: "prettier --write .";
+    readonly 'format:check': "prettier --check .";
+    readonly lint: "nx run-many -t lint";
+    readonly test: "nx run-many -t test";
+    readonly check: "prettier --check . && nx run-many -t lint typecheck test build generated-check catalog-check";
+};
+/** A neutral Nx/pnpm shell only. Backend contracts, secrets and deployment decisions are not invented. */
+export declare function workspaceFiles(name: string, designSource?: DesignSource): Record<string, string>;
+export declare function createWorkspace(options: WorkspaceOptions): Promise<{
+    ok: boolean;
+    name: string;
+    directory: string;
+    files: string[];
+    dryRun: boolean;
+    runtimeProfile: string;
+    designSource: DesignSource;
+}>;

package/dist/workspace.js

@@ -0,0 +1,213 @@
+import { lstat, mkdir, writeFile } from 'node:fs/promises';
+import { resolve, join, dirname } from 'node:path';
+const json = (value) => JSON.stringify(value, null, 2) + '\n';
+/** The cohort a new workspace pins; the quality profile is upgraded with it, never copied into the workspace. */
+export const COHORT = { cli: '1.0.0', nxPlugin: '1.0.0', workspaceConfig: '1.0.0' };
+/** The scope of the framework packages, bound to the registry that publishes them. */
+export const NPMRC = '@mpfrontend:registry=https://registry.npmjs.org/\nsave-exact=true\n';
+/** Tool versions the quality profile is verified with. */
+export const QUALITY_TOOLS = { eslint: '10.12.0', prettier: '3.9.9', tsx: '4.23.15' };
+/** Workspace scripts. `check` is the gate that CI and the CI-neutral script run. */
+export const WORKSPACE_SCRIPTS = {
+    build: 'nx run-many -t build',
+    format: 'prettier --write .',
+    'format:check': 'prettier --check .',
+    lint: 'nx run-many -t lint',
+    test: 'nx run-many -t test',
+    check: 'prettier --check . && nx run-many -t lint typecheck test build generated-check catalog-check',
+};
+// Written in the formatter's own layout so that a new workspace passes its format check.
+const nxJson = `{
+  "namedInputs": {
+    "default": [
+      "{projectRoot}/**/*",
+      "!{projectRoot}/.next/**/*",
+      "!{projectRoot}/node_modules/**/*",
+      "!{projectRoot}/runtime-assets/**/*"
+    ],
+    "sharedGlobals": [
+      "{workspaceRoot}/pnpm-lock.yaml",
+      "{workspaceRoot}/package.json",
+      "{workspaceRoot}/pnpm-workspace.yaml",
+      "{workspaceRoot}/eslint.config.mjs",
+      "{workspaceRoot}/prettier.config.mjs",
+      "{workspaceRoot}/.prettierignore"
+    ]
+  },
+  "targetDefaults": {
+    "build": { "inputs": ["default", "sharedGlobals"], "cache": true },
+    "typecheck": { "inputs": ["default", "sharedGlobals"], "cache": true },
+    "lint": { "inputs": ["default", "sharedGlobals"], "cache": true },
+    "test": { "inputs": ["default", "sharedGlobals"], "cache": true },
+    "format:check": { "inputs": ["default", "sharedGlobals"], "cache": true },
+    "catalog-check": { "inputs": ["default", "sharedGlobals"], "cache": true },
+    "format": { "cache": false }
+  }
+}
+`;
+const prettierIgnore = `# Tool-owned files keep the layout of the tool that writes them.
+pnpm-lock.yaml
+pnpm-workspace.yaml
+**/.mpfrontend/
+.agents/skills/mpfrontend-*/
+.claude/skills/mpfrontend-*/
+artifacts/
+# Hash-bound inputs: a reformatted binding, design export or captured contract reads as drift.
+# List the folder of your normalized design export here when you attach one.
+**/design.binding.json
+contracts/openapi/
+# Generated output is checked by generated-check, not by the formatter.
+**/generated/
+**/*.gen.ts
+**/next-env.d.ts
+`;
+const eslintConfig = `import { workspaceConfig } from '@mpfrontend/workspace-config/eslint';
+
+// The shared MP Frontend profile. Workspace-wide additions go after it; an app or a package
+// spreads this array in its own eslint.config.mjs and appends only its own additions.
+export default [...workspaceConfig()];
+`;
+const prettierConfig = `import profile from '@mpfrontend/workspace-config/prettier';
+
+// The shared MP Frontend formatter profile. Add workspace-wide overrides after the spread.
+export default { ...profile };
+`;
+const ciWorkflow = `# Verification only: a frozen install and the uncached workspace check. No deployment or publication.
+name: check
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: check-\${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: '24.19.0'
+          package-manager-cache: false
+      - name: Install the selected package manager
+        run: npm install --global pnpm@11.25.0
+      - name: Frozen install and uncached check
+        run: sh tools/ci/check.sh
+`;
+const ciScript = `#!/bin/sh
+# CI-neutral workspace gate. Any CI runs this file from the workspace root with Node.js 24.19.0 and
+# pnpm 11.25.0 on the path: a frozen install, then the uncached check. It deploys and publishes nothing.
+set -eu
+export NX_DAEMON=false
+export NEXT_TELEMETRY_DISABLED=1
+pnpm install --frozen-lockfile
+pnpm check --skip-nx-cache
+`;
+const codeowners = `# Code owners. Replace each placeholder with the owning team before you require code-owner reviews.
+*                @owner-placeholder/workspace
+/apps/           @owner-placeholder/apps
+/packages/       @owner-placeholder/shared-packages
+/.agents/skills/ @owner-placeholder/workspace
+/.claude/skills/ @owner-placeholder/workspace
+`;
+const skillsGuide = `# Project and domain skills
+
+Coding agents discover repository skills in this folder. \`mpfrontend skills install\` writes only the
+\`mpfrontend-*\` folders here and in \`.claude/skills/\`, records them in \`.mpfrontend/skills-lock.json\`, and
+never reads, changes or removes another folder.
+
+Add the workspace's own skills beside them:
+
+- \`project-<topic>/SKILL.md\` for a repository workflow, for example adding an app or reviewing a change.
+- \`domain-<topic>/SKILL.md\` for a business procedure that this product owns.
+
+Each \`SKILL.md\` starts with \`name\` and \`description\` metadata, and \`name\` equals the folder name. Copy
+each skill to \`.claude/skills/<name>/SKILL.md\` as well, so that both agents find it. The \`mpfrontend-\`
+prefix is reserved: \`mpfrontend skills check\` refuses a folder with that prefix that the installer does not
+own. A skill calls the workspace generators and \`pnpm check\` instead of repeating their steps.
+`;
+const agents = `# Consumer workspace
+
+Use pnpm and Nx. Product behavior, DLS bindings and assets stay in this repository; MP Frontend core
+remains product-neutral. Read the README and approved API/design contracts before changing behavior.
+Preserve authored overrides. Never commit secrets or claim production readiness from a scaffold/build
+alone. Repository skills are installed explicitly with mpfrontend skills install; no global
+configuration is changed.
+
+Run \`pnpm check\` before a change is reviewed. It runs the format check, then lint, typecheck, test, build,
+generated-check and catalog-check of every project. Lint fails on an import across app boundaries, on a raw
+colour outside the theme files, on hand-written CSS outside the theme layer and the global style entry, on a
+physical left or right where a logical start or end belongs, and on literal user-visible text or translated
+text joined to other text. Every visible text is a catalog
+message; the catalog check fails on a key missing in a locale, an unused key, a key that code uses and the
+base does not define, or differing parameters.
+Fix the code; do not weaken a rule to pass the check.
+
+Create code with the generators, not by copying: \`mpfrontend create app\`, \`create feature\`,
+\`create route\` and \`create package\` (or the matching \`nx g @mpfrontend/nx-plugin:<generator>\`).
+A feature lives in \`src/features/<feature>/\` with \`ui/\`, \`model/\`, \`hooks/\`, \`api/\` and \`utils/\`, and
+code outside it imports only its \`index.ts\`. Every screen is its own route. Code that two apps need is a
+package under \`packages/\`, never a copy. The workspace's own skills follow \`.agents/skills/README.md\`.
+`;
+/** A neutral Nx/pnpm shell only. Backend contracts, secrets and deployment decisions are not invented. */
+export function workspaceFiles(name, designSource = 'none') {
+    if (!/^[a-z][a-z0-9-]{1,48}$/.test(name))
+        throw new Error('INVALID_WORKSPACE_NAME');
+    if (!['none', 'existing'].includes(designSource))
+        throw new Error('INVALID_DESIGN_SOURCE');
+    const designStatus = designSource === 'none' ? 'disabled' : 'pending';
+    return {
+        'package.json': json({ name, private: true, type: 'module', packageManager: 'pnpm@11.25.0', engines: { node: '>=24 <25' },
+            scripts: WORKSPACE_SCRIPTS,
+            devDependencies: { '@mpfrontend/ftg-cli': COHORT.cli, '@mpfrontend/nx-plugin': COHORT.nxPlugin, '@mpfrontend/workspace-config': COHORT.workspaceConfig, eslint: QUALITY_TOOLS.eslint, nx: '23.2.1', prettier: QUALITY_TOOLS.prettier, tsx: QUALITY_TOOLS.tsx, typescript: '5.9.3', '@types/node': '24.10.1', '@types/react': '19.3.0', '@types/react-dom': '19.2.3' } }),
+        'pnpm-workspace.yaml': 'packages:\n  - apps/*\n  - packages/*\n  - themes/*\noverrides:\n  axios@1.18.1: 1.20.0\n  brace-expansion@5.0.9: 5.0.12\n  smol-toml@1.6.1: 1.9.0\nallowBuilds:\n  "@scarf/scarf": false\n  esbuild: true\n  nx: true\n  sharp: true\n  unrs-resolver: true\n',
+        'nx.json': nxJson,
+        // The @mpfrontend scope is bound to the public npm registry, so that no other registry can serve it; dependencies
+        // are saved at exact versions.
+        '.npmrc': NPMRC,
+        '.gitignore': 'node_modules/\n.next/\n.nx/\ndist/\nruntime-assets/\n*.tsbuildinfo\n.env\n.env.*\n!.env.example\n.mpfrontend/skills-install.lock\n.ftg-write.lock\n',
+        '.prettierignore': prettierIgnore,
+        'eslint.config.mjs': eslintConfig,
+        // The module boundary rule reads the root tsconfig.base.json for path aliases; it extends the shared profile.
+        'tsconfig.base.json': json({ extends: '@mpfrontend/workspace-config/tsconfig/base.json' }),
+        'prettier.config.mjs': prettierConfig,
+        '.github/workflows/check.yml': ciWorkflow,
+        'tools/ci/check.sh': ciScript,
+        'CODEOWNERS': codeowners,
+        '.agents/skills/README.md': skillsGuide,
+        '.mpfrontend/workspace.json': json({ schemaVersion: 1, name, orchestrator: 'nx', packageManager: 'pnpm', runtimeProfile: 'unconfigured', designSource, cliVersion: COHORT.cli }),
+        '.mpfrontend/design-source.json': json({ schemaVersion: 1, generator: 'MPFrontendDesignSource', cliVersion: COHORT.cli, source: designSource, status: designStatus, binding: null, bindingHash: null, sourceIdentity: null, release: null }),
+        'apps/.gitkeep': '', 'packages/.gitkeep': '', 'themes/.gitkeep': '',
+        'contracts/README.md': '# API ownership\n\nSupply an approved, immutable OpenAPI bundle under openapi/presentation/<app>/openapi.json.\nThe generated catalog example expects listCatalog; configure FTG explicitly for your actual contract.\nNo backend API, permissions or production runtime is generated by workspace initialization.\n',
+        'AGENTS.md': agents,
+        'CLAUDE.md': '@AGENTS.md\n',
+        'README.md': `# ${name}\n\nNeutral MP Frontend Nx/pnpm workspace, initialized with design source \`${designSource}\` without installing dependencies or creating Git history.\n\n1. Install the pinned dependencies with pnpm install. \`.npmrc\` binds the @mpfrontend scope to the public npm registry, and every framework package is pinned to one exact cohort version. Offline, install the archives of a release through pnpm overrides and lock their SHA-256 from the release record.\n2. ${designSource === 'none' ? 'Continue code-first, or attach an approved consumer-owned design source later with mpfrontend design attach.' : 'Create an approved root design.binding.json for the consumer-owned DLS, then complete the pending source with mpfrontend design attach.'}\n3. Run pnpm exec mpfrontend create app --name customer --directory apps/customer. Add features, routes and shared packages with mpfrontend create feature, create route and create package; replace the placeholder owners in CODEOWNERS.\n4. Supply your approved catalog OpenAPI contract as explained in contracts/README.md.\n5. Install application dependencies, then run pnpm check. Review pnpm-lock.yaml and use frozen installs in CI.\n6. Run pnpm exec mpfrontend skills install --for both --profile base only if repository-scoped agent workflows are wanted. The catalog provides eighteen finite workflows; the base profile installs fourteen.\n\n## Quality profile\n\nThe formatter, lint and TypeScript configuration come from \`@mpfrontend/workspace-config\` and are\nupgraded with the MP Frontend cohort. \`eslint.config.mjs\` and \`prettier.config.mjs\` re-export the shared\nprofile; an app adds only its own additions in its own \`eslint.config.mjs\`.\n\n- \`pnpm format\` formats the workspace; \`pnpm format:check\` only checks it.\n- \`pnpm check\` runs the format check, then lint, typecheck, test, build, generated-check and\n  catalog-check of every project, with Nx caching. Pass \`--skip-nx-cache\` to prove the current source.\n- Every project has \`format\`, \`format:check\`, \`lint\` and \`test\` targets for focused feedback.\n- \`tools/ci/check.sh\` is the CI-neutral gate (a frozen install, then the uncached check);\n  \`.github/workflows/check.yml\` runs it on GitHub Actions.\n\nDesign source modes are explicit: \`existing\` attaches a consumer-owned DLS binding and \`none\` remains code-first. MP Frontend does not ship or require a public Community DLS in this release. Initialization never reads, captures or changes Figma.\n\nThe catalog template is not a protected production application. Configure the security BFF, identity, gateway and realtime boundaries with acceptance tests before protected product adoption.\nProduct DLS, fonts, themes, locale policy, exports, mappings and asset rights are consumer-owned. No Figma access/write, watcher, Git operation, deployment, package publication or global installation is performed.\n\nExisting destinations are refused, including an empty directory or symlink. A filesystem failure may leave a partial new destination for inspection; it is never automatically deleted or retried over.\n`,
+    };
+}
+export async function createWorkspace(options) {
+    const designSource = options.designSource ?? 'none', files = workspaceFiles(options.name, designSource), directory = resolve(options.directory);
+    try {
+        await lstat(directory);
+        throw new Error('DESTINATION_EXISTS');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    if (!options.dryRun) {
+        // Exclusive directory creation refuses a competing creator; writes never replace an existing file.
+        await mkdir(directory, { recursive: false });
+        for (const [path, content] of Object.entries(files)) {
+            const target = join(directory, path);
+            await mkdir(dirname(target), { recursive: true });
+            await writeFile(target, content, { flag: 'wx' });
+        }
+    }
+    return { ok: true, name: options.name, directory, files: Object.keys(files).sort(), dryRun: options.dryRun === true, runtimeProfile: 'unconfigured', designSource };
+}
+//# sourceMappingURL=workspace.js.map