semmet-angular 0.28.0 → 0.30.0

package/README.en.md

@@ -19,6 +19,8 @@ Brazilian Portuguese documentation is available in [README.md](./README.md).
 ```
 ng add semmet-angular
 ng generate semmet-angular:accordion my-faq
+ng generate semmet-angular:ci
+ng generate semmet-angular:docker
 ```
 
 `ng add semmet-angular` installs the package and configures the delivery workflow once for the target application, including Playwright e2e support and npm scripts. Each generated component is dropped into your project exactly like `ng generate component` would (respecting your `angular.json` project, source root, and selector prefix), and has **zero runtime dependency** on this package — `semmet-angular` is only needed at generation time.
@@ -47,6 +49,26 @@ npm run e2e:ui
 
 `npm run e2e` runs Playwright against the Angular dev server configured by `playwright.config.ts`; `npm run e2e:ui` opens Playwright's interactive UI.
 
+## GitHub Actions CI
+
+```bash
+ng generate semmet-angular:ci
+```
+
+This command generates `.github/workflows/ci.yml` using the package scripts that already exist in `package.json`. The workflow detects the package manager by lockfile (`package-lock.json`, `pnpm-lock.yaml`, or `yarn.lock`), installs dependencies, and runs `verify` when available. If `verify` does not exist yet, it runs `build`, `test`, and `e2e` when those scripts exist.
+
+By default, the schematic does not overwrite an existing workflow. Use `--force` when you want to replace `.github/workflows/ci.yml`.
+
+## Docker Packaging
+
+```bash
+ng generate semmet-angular:docker
+```
+
+This command generates `Dockerfile`, `.dockerignore`, and `nginx.conf` to package the Angular application as an image served by Nginx. The Dockerfile detects the package manager by lockfile, runs the build in the Node stage, and copies the output configured in `angular.json` to `/usr/share/nginx/html`.
+
+The `nginx.conf` includes SPA fallback with `try_files ... /index.html`. By default, the schematic does not overwrite existing files; use `--force` to replace the current Docker configuration.
+
 ## Projected content containers
 
 Some generated components are containers: they own the ARIA wiring, keyboard behavior, focus management, and visual shell, while your app owns the content rendered inside them.

package/README.md

@@ -19,6 +19,8 @@ English documentation is available in [README.en.md](./README.en.md).
 ```bash
 ng add semmet-angular
 ng generate semmet-angular:accordion minha-faq
+ng generate semmet-angular:ci
+ng generate semmet-angular:docker
 ```
 
 `ng add semmet-angular` instala o pacote e configura uma vez o fluxo de entrega da aplicação alvo, incluindo suporte a e2e com Playwright e scripts npm. Cada componente gerado entra no seu projeto do mesmo jeito que entraria com `ng generate component` (respeitando `angular.json`, `sourceRoot` e prefixo de seletor), e tem **zero dependência em tempo de execução** deste pacote — `semmet-angular` só é necessário na geração.
@@ -47,6 +49,26 @@ npm run lint
 
 `lint` só entra quando a aplicação já tem um script `lint`; `build` e `test` seguem a mesma lógica. O `e2e` entra depois da configuração do Playwright feita pelo `ng add`.
 
+## CI com GitHub Actions
+
+```bash
+ng generate semmet-angular:ci
+```
+
+Esse comando gera `.github/workflows/ci.yml` usando os scripts já existentes no `package.json`. O workflow detecta o gerenciador de pacotes por lockfile (`package-lock.json`, `pnpm-lock.yaml` ou `yarn.lock`), instala dependências e executa `verify` quando disponível. Se `verify` ainda não existir, ele roda `build`, `test` e `e2e` conforme esses scripts existirem.
+
+Por padrão, o schematic não sobrescreve um workflow existente. Use `--force` quando quiser substituir `.github/workflows/ci.yml`.
+
+## Empacotamento com Docker
+
+```bash
+ng generate semmet-angular:docker
+```
+
+Esse comando gera `Dockerfile`, `.dockerignore` e `nginx.conf` para empacotar a aplicação Angular como uma imagem servida por Nginx. O Dockerfile detecta o gerenciador de pacotes por lockfile, executa o build no estágio Node e copia o output configurado no `angular.json` para `/usr/share/nginx/html`.
+
+O `nginx.conf` inclui fallback de SPA com `try_files ... /index.html`. Por padrão, o schematic não sobrescreve arquivos existentes; use `--force` para substituir a configuração Docker atual.
+
 ## Testes Gerados
 
 Todo schematic de componente gera arquivos de teste ao lado do componente:

package/README.pt-BR.md

@@ -17,6 +17,8 @@ Leia a direção geral do produto em [PRODUCT_VISION.md](./PRODUCT_VISION.md).
 ```bash
 ng add semmet-angular
 ng generate semmet-angular:accordion minha-faq
+ng generate semmet-angular:ci
+ng generate semmet-angular:docker
 ```
 
 `ng add semmet-angular` instala o pacote e configura uma vez o fluxo de entrega da aplicação alvo, incluindo suporte a e2e com Playwright e scripts npm. Cada componente gerado entra no seu projeto do mesmo jeito que entraria com `ng generate component` (respeitando `angular.json`, `sourceRoot` e prefixo de seletor), e tem **zero dependência em tempo de execução** deste pacote — `semmet-angular` só é necessário na geração.
@@ -45,6 +47,26 @@ npm run lint
 
 `lint` só entra quando a aplicação já tem um script `lint`; `build` e `test` seguem a mesma lógica. O `e2e` entra depois da configuração do Playwright feita pelo `ng add`.
 
+## CI com GitHub Actions
+
+```bash
+ng generate semmet-angular:ci
+```
+
+Esse comando gera `.github/workflows/ci.yml` usando os scripts já existentes no `package.json`. O workflow detecta o gerenciador de pacotes por lockfile (`package-lock.json`, `pnpm-lock.yaml` ou `yarn.lock`), instala dependências e executa `verify` quando disponível. Se `verify` ainda não existir, ele roda `build`, `test` e `e2e` conforme esses scripts existirem.
+
+Por padrão, o schematic não sobrescreve um workflow existente. Use `--force` quando quiser substituir `.github/workflows/ci.yml`.
+
+## Empacotamento com Docker
+
+```bash
+ng generate semmet-angular:docker
+```
+
+Esse comando gera `Dockerfile`, `.dockerignore` e `nginx.conf` para empacotar a aplicação Angular como uma imagem servida por Nginx. O Dockerfile detecta o gerenciador de pacotes por lockfile, executa o build no estágio Node e copia o output configurado no `angular.json` para `/usr/share/nginx/html`.
+
+O `nginx.conf` inclui fallback de SPA com `try_files ... /index.html`. Por padrão, o schematic não sobrescreve arquivos existentes; use `--force` para substituir a configuração Docker atual.
+
 ## Testes Gerados
 
 Todo schematic de componente gera arquivos de teste ao lado do componente:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semmet-angular",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "Accessible UI Delivery Kit for Angular: schematics that generate ARIA-conformant standalone components with styling, keyboard behavior, unit tests, and Playwright e2e smoke tests.",
   "publisher": "danilodevsilva",
   "license": "MIT",

package/src/ci/index.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '@angular-devkit/schematics';
+import { Schema } from './schema';
+export declare function ci(options: Schema): Rule;

package/src/ci/index.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ci = ci;
+const schematics_1 = require("@angular-devkit/schematics");
+function ci(options) {
+    return (tree) => {
+        const workflowPath = buildWorkflowPath(options.name);
+        if (tree.exists(workflowPath) && !options.force) {
+            throw new schematics_1.SchematicsException(`${workflowPath} already exists. Re-run with --force to overwrite it.`);
+        }
+        const packageJson = readJson(tree, '/package.json');
+        const scripts = packageJson.scripts ?? {};
+        const packageManager = detectPackageManager(tree);
+        const workflow = buildWorkflow(packageManager, Object.keys(scripts), tree.exists('/package-lock.json'));
+        if (tree.exists(workflowPath)) {
+            tree.overwrite(workflowPath, workflow);
+        }
+        else {
+            tree.create(workflowPath, workflow);
+        }
+    };
+}
+function buildWorkflowPath(name = 'ci') {
+    const normalizedName = name.trim().replace(/\.ya?ml$/, '');
+    if (!normalizedName || normalizedName.includes('/') || normalizedName.includes('\\')) {
+        throw new schematics_1.SchematicsException('CI workflow name must be a file name without path separators.');
+    }
+    return `/.github/workflows/${normalizedName}.yml`;
+}
+function detectPackageManager(tree) {
+    if (tree.exists('/pnpm-lock.yaml')) {
+        return 'pnpm';
+    }
+    if (tree.exists('/yarn.lock')) {
+        return 'yarn';
+    }
+    return 'npm';
+}
+function buildWorkflow(packageManager, scriptNames, hasNpmLockfile) {
+    const commands = getPackageManagerCommands(packageManager, hasNpmLockfile);
+    const runSteps = buildRunSteps(commands, scriptNames);
+    const setupPackageManagerStep = commands.setupStep ? `${commands.setupStep}\n` : '';
+    const cacheConfig = commands.cache ? `          cache: ${commands.cache}\n` : '';
+    return `name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+${setupPackageManagerStep}      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+${cacheConfig}
+
+      - name: Install dependencies
+        run: ${commands.install}
+${runSteps}
+`;
+}
+function getPackageManagerCommands(packageManager, hasNpmLockfile) {
+    if (packageManager === 'pnpm') {
+        return {
+            install: 'pnpm install --frozen-lockfile',
+            run: (script) => `pnpm run ${script}`,
+            setupStep: `      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9`,
+            cache: 'pnpm',
+        };
+    }
+    if (packageManager === 'yarn') {
+        return {
+            install: 'yarn install --frozen-lockfile',
+            run: (script) => `yarn ${script}`,
+            cache: 'yarn',
+        };
+    }
+    return {
+        install: hasNpmLockfile ? 'npm ci' : 'npm install',
+        run: (script) => `npm run ${script}`,
+        cache: hasNpmLockfile ? 'npm' : undefined,
+    };
+}
+function buildRunSteps(commands, scriptNames) {
+    const scripts = new Set(scriptNames);
+    const verificationScripts = scripts.has('verify')
+        ? ['verify']
+        : ['build', 'test', 'e2e'].filter((script) => scripts.has(script));
+    if (verificationScripts.length === 0) {
+        return `
+      - name: Check package scripts
+        run: echo "No verify, build, test, or e2e script found in package.json."
+`;
+    }
+    return verificationScripts
+        .map((script) => `
+      - name: Run ${script}
+        run: ${commands.run(script)}
+`)
+        .join('');
+}
+function readJson(tree, path) {
+    const content = tree.readText(path);
+    return JSON.parse(content);
+}
+//# sourceMappingURL=index.js.map

package/src/ci/index.js.map

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

package/src/ci/index.ts

@@ -0,0 +1,143 @@
+import { Rule, SchematicsException, Tree } from '@angular-devkit/schematics';
+import { Schema } from './schema';
+
+type PackageManager = 'npm' | 'pnpm' | 'yarn';
+
+interface PackageManagerCommands {
+  install: string;
+  run: (script: string) => string;
+  setupStep?: string;
+  cache?: string;
+}
+
+export function ci(options: Schema): Rule {
+  return (tree: Tree) => {
+    const workflowPath = buildWorkflowPath(options.name);
+
+    if (tree.exists(workflowPath) && !options.force) {
+      throw new SchematicsException(`${workflowPath} already exists. Re-run with --force to overwrite it.`);
+    }
+
+    const packageJson = readJson(tree, '/package.json');
+    const scripts = packageJson.scripts ?? {};
+    const packageManager = detectPackageManager(tree);
+    const workflow = buildWorkflow(packageManager, Object.keys(scripts), tree.exists('/package-lock.json'));
+
+    if (tree.exists(workflowPath)) {
+      tree.overwrite(workflowPath, workflow);
+    } else {
+      tree.create(workflowPath, workflow);
+    }
+  };
+}
+
+function buildWorkflowPath(name = 'ci'): string {
+  const normalizedName = name.trim().replace(/\.ya?ml$/, '');
+
+  if (!normalizedName || normalizedName.includes('/') || normalizedName.includes('\\')) {
+    throw new SchematicsException('CI workflow name must be a file name without path separators.');
+  }
+
+  return `/.github/workflows/${normalizedName}.yml`;
+}
+
+function detectPackageManager(tree: Tree): PackageManager {
+  if (tree.exists('/pnpm-lock.yaml')) {
+    return 'pnpm';
+  }
+
+  if (tree.exists('/yarn.lock')) {
+    return 'yarn';
+  }
+
+  return 'npm';
+}
+
+function buildWorkflow(packageManager: PackageManager, scriptNames: string[], hasNpmLockfile: boolean): string {
+  const commands = getPackageManagerCommands(packageManager, hasNpmLockfile);
+  const runSteps = buildRunSteps(commands, scriptNames);
+  const setupPackageManagerStep = commands.setupStep ? `${commands.setupStep}\n` : '';
+  const cacheConfig = commands.cache ? `          cache: ${commands.cache}\n` : '';
+
+  return `name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+${setupPackageManagerStep}      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+${cacheConfig}
+
+      - name: Install dependencies
+        run: ${commands.install}
+${runSteps}
+`;
+}
+
+function getPackageManagerCommands(packageManager: PackageManager, hasNpmLockfile: boolean): PackageManagerCommands {
+  if (packageManager === 'pnpm') {
+    return {
+      install: 'pnpm install --frozen-lockfile',
+      run: (script) => `pnpm run ${script}`,
+      setupStep: `      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9`,
+      cache: 'pnpm',
+    };
+  }
+
+  if (packageManager === 'yarn') {
+    return {
+      install: 'yarn install --frozen-lockfile',
+      run: (script) => `yarn ${script}`,
+      cache: 'yarn',
+    };
+  }
+
+  return {
+    install: hasNpmLockfile ? 'npm ci' : 'npm install',
+    run: (script) => `npm run ${script}`,
+    cache: hasNpmLockfile ? 'npm' : undefined,
+  };
+}
+
+function buildRunSteps(commands: PackageManagerCommands, scriptNames: string[]): string {
+  const scripts = new Set(scriptNames);
+  const verificationScripts = scripts.has('verify')
+    ? ['verify']
+    : ['build', 'test', 'e2e'].filter((script) => scripts.has(script));
+
+  if (verificationScripts.length === 0) {
+    return `
+      - name: Check package scripts
+        run: echo "No verify, build, test, or e2e script found in package.json."
+`;
+  }
+
+  return verificationScripts
+    .map(
+      (script) => `
+      - name: Run ${script}
+        run: ${commands.run(script)}
+`
+    )
+    .join('');
+}
+
+function readJson(tree: Tree, path: string): Record<string, any> {
+  const content = tree.readText(path);
+  return JSON.parse(content) as Record<string, any>;
+}

package/src/ci/schema.d.ts

@@ -0,0 +1,4 @@
+export interface Schema {
+    force?: boolean;
+    name?: string;
+}

package/src/ci/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/src/ci/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":""}

package/src/ci/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "SemmetAngularCi",
+  "title": "Semmet Angular CI Options Schema",
+  "type": "object",
+  "description": "Generates a GitHub Actions CI workflow using the target workspace package scripts.",
+  "additionalProperties": false,
+  "properties": {
+    "force": {
+      "type": "boolean",
+      "default": false,
+      "description": "Overwrite an existing CI workflow."
+    },
+    "name": {
+      "type": "string",
+      "default": "ci",
+      "description": "The workflow file name to create under .github/workflows."
+    }
+  }
+}

package/src/ci/schema.ts

@@ -0,0 +1,4 @@
+export interface Schema {
+  force?: boolean;
+  name?: string;
+}

package/src/collection.json

@@ -6,6 +6,16 @@
       "factory": "./ng-add/index#ngAdd",
       "schema": "./ng-add/schema.json"
     },
+    "ci": {
+      "description": "Generates a GitHub Actions CI workflow using existing package scripts.",
+      "factory": "./ci/index#ci",
+      "schema": "./ci/schema.json"
+    },
+    "docker": {
+      "description": "Generates Docker packaging files for an Angular application served by Nginx.",
+      "factory": "./docker/index#docker",
+      "schema": "./docker/schema.json"
+    },
     "accordion": {
       "description": "Generates a standalone Angular Accordion component following the W3C ARIA Authoring Practices Guide.",
       "factory": "./accordion/index#accordion",

package/src/docker/index.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '@angular-devkit/schematics';
+import { Schema } from './schema';
+export declare function docker(options: Schema): Rule;

package/src/docker/index.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docker = docker;
+const schematics_1 = require("@angular-devkit/schematics");
+const DOCKERFILE_PATH = '/Dockerfile';
+const DOCKERIGNORE_PATH = '/.dockerignore';
+const NGINX_CONFIG_PATH = '/nginx.conf';
+function docker(options) {
+    return (tree) => {
+        const files = [DOCKERFILE_PATH, DOCKERIGNORE_PATH, NGINX_CONFIG_PATH];
+        const existingFiles = files.filter((file) => tree.exists(file));
+        if (existingFiles.length > 0 && !options.force) {
+            throw new schematics_1.SchematicsException(`${existingFiles.join(', ')} already exist. Re-run with --force to overwrite them.`);
+        }
+        const workspace = readJson(tree, '/angular.json');
+        const projectName = resolveProjectName(workspace, options.project);
+        const outputPath = resolveBuildOutputPath(workspace, projectName);
+        const packageManager = detectPackageManager(tree);
+        const commands = getPackageManagerCommands(packageManager, tree.exists('/package-lock.json'));
+        writeFile(tree, DOCKERFILE_PATH, buildDockerfile(outputPath, commands));
+        writeFile(tree, DOCKERIGNORE_PATH, buildDockerignore());
+        writeFile(tree, NGINX_CONFIG_PATH, buildNginxConfig());
+    };
+}
+function resolveProjectName(workspace, projectName) {
+    if (projectName) {
+        if (!workspace.projects?.[projectName]) {
+            throw new schematics_1.SchematicsException(`Project "${projectName}" was not found in angular.json.`);
+        }
+        return projectName;
+    }
+    if (workspace.defaultProject && workspace.projects?.[workspace.defaultProject]) {
+        return workspace.defaultProject;
+    }
+    const projects = Object.keys(workspace.projects ?? {});
+    if (projects.length === 0) {
+        throw new schematics_1.SchematicsException('No Angular project was found in angular.json.');
+    }
+    return projects[0];
+}
+function resolveBuildOutputPath(workspace, projectName) {
+    const project = workspace.projects?.[projectName] ?? {};
+    const buildTarget = project.architect?.build ?? project.targets?.build;
+    const outputPath = buildTarget?.options?.outputPath;
+    if (typeof outputPath === 'string') {
+        return trimSlashes(outputPath);
+    }
+    if (outputPath?.base) {
+        return trimSlashes([outputPath.base, outputPath.browser].filter(Boolean).join('/'));
+    }
+    return `dist/${projectName}/browser`;
+}
+function detectPackageManager(tree) {
+    if (tree.exists('/pnpm-lock.yaml')) {
+        return 'pnpm';
+    }
+    if (tree.exists('/yarn.lock')) {
+        return 'yarn';
+    }
+    return 'npm';
+}
+function getPackageManagerCommands(packageManager, hasNpmLockfile) {
+    if (packageManager === 'pnpm') {
+        return {
+            prepare: 'RUN corepack enable',
+            install: 'pnpm install --frozen-lockfile',
+            build: 'pnpm run build',
+        };
+    }
+    if (packageManager === 'yarn') {
+        return {
+            prepare: 'RUN corepack enable',
+            install: 'yarn install --frozen-lockfile',
+            build: 'yarn build',
+        };
+    }
+    return {
+        install: hasNpmLockfile ? 'npm ci' : 'npm install',
+        build: 'npm run build',
+    };
+}
+function buildDockerfile(outputPath, commands) {
+    const prepareStep = commands.prepare ? `${commands.prepare}\n` : '';
+    return `FROM node:20-alpine AS build
+WORKDIR /app
+
+COPY package*.json ./
+COPY pnpm-lock.yaml* yarn.lock* ./
+${prepareStep}RUN ${commands.install}
+
+COPY . .
+RUN ${commands.build}
+
+FROM nginx:1.27-alpine
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=build /app/${outputPath} /usr/share/nginx/html
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]
+`;
+}
+function buildDockerignore() {
+    return `node_modules
+dist
+.angular
+.git
+.github
+coverage
+playwright-report
+test-results
+.DS_Store
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+`;
+}
+function buildNginxConfig() {
+    return `server {
+  listen 80;
+  server_name _;
+
+  root /usr/share/nginx/html;
+  index index.html;
+
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+
+  location ~* \\.(?:css|js|mjs|map|ico|png|jpg|jpeg|gif|svg|webp|woff2?)$ {
+    try_files $uri =404;
+    access_log off;
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+  }
+}
+`;
+}
+function writeFile(tree, path, content) {
+    if (tree.exists(path)) {
+        tree.overwrite(path, content);
+    }
+    else {
+        tree.create(path, content);
+    }
+}
+function trimSlashes(value) {
+    return value.replace(/^\/+|\/+$/g, '');
+}
+function readJson(tree, path) {
+    const content = tree.readText(path);
+    return JSON.parse(content);
+}
+//# sourceMappingURL=index.js.map

package/src/docker/index.js.map

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

package/src/docker/index.ts

@@ -0,0 +1,186 @@
+import { Rule, SchematicsException, Tree } from '@angular-devkit/schematics';
+import { Schema } from './schema';
+
+type PackageManager = 'npm' | 'pnpm' | 'yarn';
+
+interface PackageManagerCommands {
+  install: string;
+  build: string;
+  prepare?: string;
+}
+
+const DOCKERFILE_PATH = '/Dockerfile';
+const DOCKERIGNORE_PATH = '/.dockerignore';
+const NGINX_CONFIG_PATH = '/nginx.conf';
+
+export function docker(options: Schema): Rule {
+  return (tree: Tree) => {
+    const files = [DOCKERFILE_PATH, DOCKERIGNORE_PATH, NGINX_CONFIG_PATH];
+    const existingFiles = files.filter((file) => tree.exists(file));
+
+    if (existingFiles.length > 0 && !options.force) {
+      throw new SchematicsException(`${existingFiles.join(', ')} already exist. Re-run with --force to overwrite them.`);
+    }
+
+    const workspace = readJson(tree, '/angular.json');
+    const projectName = resolveProjectName(workspace, options.project);
+    const outputPath = resolveBuildOutputPath(workspace, projectName);
+    const packageManager = detectPackageManager(tree);
+    const commands = getPackageManagerCommands(packageManager, tree.exists('/package-lock.json'));
+
+    writeFile(tree, DOCKERFILE_PATH, buildDockerfile(outputPath, commands));
+    writeFile(tree, DOCKERIGNORE_PATH, buildDockerignore());
+    writeFile(tree, NGINX_CONFIG_PATH, buildNginxConfig());
+  };
+}
+
+function resolveProjectName(workspace: Record<string, any>, projectName?: string): string {
+  if (projectName) {
+    if (!workspace.projects?.[projectName]) {
+      throw new SchematicsException(`Project "${projectName}" was not found in angular.json.`);
+    }
+
+    return projectName;
+  }
+
+  if (workspace.defaultProject && workspace.projects?.[workspace.defaultProject]) {
+    return workspace.defaultProject as string;
+  }
+
+  const projects = Object.keys(workspace.projects ?? {});
+
+  if (projects.length === 0) {
+    throw new SchematicsException('No Angular project was found in angular.json.');
+  }
+
+  return projects[0];
+}
+
+function resolveBuildOutputPath(workspace: Record<string, any>, projectName: string): string {
+  const project = workspace.projects?.[projectName] ?? {};
+  const buildTarget = project.architect?.build ?? project.targets?.build;
+  const outputPath = buildTarget?.options?.outputPath;
+
+  if (typeof outputPath === 'string') {
+    return trimSlashes(outputPath);
+  }
+
+  if (outputPath?.base) {
+    return trimSlashes([outputPath.base, outputPath.browser].filter(Boolean).join('/'));
+  }
+
+  return `dist/${projectName}/browser`;
+}
+
+function detectPackageManager(tree: Tree): PackageManager {
+  if (tree.exists('/pnpm-lock.yaml')) {
+    return 'pnpm';
+  }
+
+  if (tree.exists('/yarn.lock')) {
+    return 'yarn';
+  }
+
+  return 'npm';
+}
+
+function getPackageManagerCommands(packageManager: PackageManager, hasNpmLockfile: boolean): PackageManagerCommands {
+  if (packageManager === 'pnpm') {
+    return {
+      prepare: 'RUN corepack enable',
+      install: 'pnpm install --frozen-lockfile',
+      build: 'pnpm run build',
+    };
+  }
+
+  if (packageManager === 'yarn') {
+    return {
+      prepare: 'RUN corepack enable',
+      install: 'yarn install --frozen-lockfile',
+      build: 'yarn build',
+    };
+  }
+
+  return {
+    install: hasNpmLockfile ? 'npm ci' : 'npm install',
+    build: 'npm run build',
+  };
+}
+
+function buildDockerfile(outputPath: string, commands: PackageManagerCommands): string {
+  const prepareStep = commands.prepare ? `${commands.prepare}\n` : '';
+
+  return `FROM node:20-alpine AS build
+WORKDIR /app
+
+COPY package*.json ./
+COPY pnpm-lock.yaml* yarn.lock* ./
+${prepareStep}RUN ${commands.install}
+
+COPY . .
+RUN ${commands.build}
+
+FROM nginx:1.27-alpine
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=build /app/${outputPath} /usr/share/nginx/html
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]
+`;
+}
+
+function buildDockerignore(): string {
+  return `node_modules
+dist
+.angular
+.git
+.github
+coverage
+playwright-report
+test-results
+.DS_Store
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+`;
+}
+
+function buildNginxConfig(): string {
+  return `server {
+  listen 80;
+  server_name _;
+
+  root /usr/share/nginx/html;
+  index index.html;
+
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+
+  location ~* \\.(?:css|js|mjs|map|ico|png|jpg|jpeg|gif|svg|webp|woff2?)$ {
+    try_files $uri =404;
+    access_log off;
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+  }
+}
+`;
+}
+
+function writeFile(tree: Tree, path: string, content: string): void {
+  if (tree.exists(path)) {
+    tree.overwrite(path, content);
+  } else {
+    tree.create(path, content);
+  }
+}
+
+function trimSlashes(value: string): string {
+  return value.replace(/^\/+|\/+$/g, '');
+}
+
+function readJson(tree: Tree, path: string): Record<string, any> {
+  const content = tree.readText(path);
+  return JSON.parse(content) as Record<string, any>;
+}

package/src/docker/schema.d.ts

@@ -0,0 +1,4 @@
+export interface Schema {
+    force?: boolean;
+    project?: string;
+}

package/src/docker/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/src/docker/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":""}

package/src/docker/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "SemmetAngularDocker",
+  "title": "Semmet Angular Docker Options Schema",
+  "type": "object",
+  "description": "Generates Docker packaging files for an Angular application served by Nginx.",
+  "additionalProperties": false,
+  "properties": {
+    "force": {
+      "type": "boolean",
+      "default": false,
+      "description": "Overwrite existing Docker packaging files."
+    },
+    "project": {
+      "type": "string",
+      "description": "The Angular project to package.",
+      "$default": { "$source": "projectName" }
+    }
+  }
+}

package/src/docker/schema.ts

@@ -0,0 +1,4 @@
+export interface Schema {
+  force?: boolean;
+  project?: string;
+}