@team-codeme/crud-forge 0.0.0-stage → 1.0.1

package/e2e/tests/iam-live.spec.js

@@ -0,0 +1,149 @@
+const { test, expect } = require('@playwright/test');
+const fs = require('fs');
+const path = require('path');
+const { loadEnvFile } = require('../../src/config/env-refs');
+
+const root = path.resolve(__dirname, '../..');
+const envFile = process.env.CRUDFORGE_ENV_FILE || path.join(root, '.env.qa');
+if (fs.existsSync(envFile)) {
+  loadEnvFile(envFile);
+}
+
+function requiredEnv(name) {
+  const value = process.env[name];
+  if (!value) {
+    throw new Error(`${name} is required for live Keycloak tests. Copy .env.qa.example to .env.qa.`);
+  }
+  return value;
+}
+
+const adminUser = process.env.CRUDFORGE_LIVE_ADMIN_USERNAME || 'crudforge-qa-admin';
+const adminPass = process.env.CRUDFORGE_QA_ADMIN_PASSWORD;
+const limitedUser = process.env.CRUDFORGE_LIVE_USER_USERNAME || 'crudforge-qa-user';
+const limitedPass = process.env.CRUDFORGE_QA_USER_PASSWORD;
+const realmAdminUser = process.env.KEYCLOAK_ADMIN_USERNAME;
+const realmAdminPass = process.env.KEYCLOAK_ADMIN_PASSWORD;
+
+async function fillControl(locator, value) {
+  await locator.click();
+  await locator.evaluate((el, next) => {
+    const descriptor = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value');
+    descriptor.set.call(el, next);
+    el.dispatchEvent(new InputEvent('input', { bubbles: true, composed: true, inputType: 'insertFromPaste', data: next }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  }, value);
+  await locator.fill(value);
+}
+
+async function signIn(page, username, password) {
+  await page.goto('/auth/sign-in');
+  const submit = page.getByRole('button', { name: 'Sign in' });
+  await expect(submit).toBeVisible();
+  await fillControl(page.locator('#email'), username);
+  await fillControl(page.locator('#password'), password);
+  await expect(page.locator('#email')).toHaveValue(username);
+  await expect(page.locator('#password')).toHaveValue(password);
+  await expect(submit).toBeEnabled({ timeout: 10000 });
+  await submit.click();
+}
+
+test.describe.configure({ mode: 'serial' });
+
+test.describe('IAM LIVE (real Keycloak)', () => {
+  test.beforeAll(() => {
+    requiredEnv('CRUDFORGE_KC_SERVER_URL');
+    if (!adminPass || !limitedPass) {
+      throw new Error('CRUDFORGE_QA_ADMIN_PASSWORD and CRUDFORGE_QA_USER_PASSWORD are required.');
+    }
+  });
+
+  test('LIVE-AUTH-01 Seeded admin can sign in', async ({ page }) => {
+    await signIn(page, adminUser, adminPass);
+    await page.waitForURL(/\/admin(\/|$)/, { timeout: 20000 });
+    await expect(page).toHaveURL(/\/admin\/welcome|\/admin\/no-access|\/admin\/?$/);
+  });
+
+  test('LIVE-AUTH-02 Bad password stays on sign-in', async ({ page }) => {
+    await signIn(page, 'crudforge-qa-unknown-user', 'definitely-wrong-password');
+    await expect(page).toHaveURL(/\/auth\/sign-in/);
+    await expect(page.getByText(/invalid username or password/i)).toBeVisible({ timeout: 15000 });
+  });
+
+  test('LIVE-AUTH-03 Anonymous users are redirected to sign-in', async ({ page }) => {
+    await page.goto('/admin/user-management');
+    await expect(page).toHaveURL(/\/auth\/sign-in/);
+  });
+
+  test('LIVE-AUTH-04 Logout ends the session', async ({ page }) => {
+    await signIn(page, adminUser, adminPass);
+    await page.waitForURL(/\/admin(\/|$)/, { timeout: 20000 });
+    await page.getByRole('img', { name: 'User avatar' }).first().click();
+    await page.getByRole('menuitem', { name: 'Sign out' }).click();
+    await expect(page).toHaveURL(/\/auth\/sign-in/, { timeout: 15000 });
+    await page.goto('/admin/user-management');
+    await expect(page).toHaveURL(/\/auth\/sign-in/);
+  });
+
+  test('LIVE-RBAC-01 Limited user is not an admin landing', async ({ page }) => {
+    await signIn(page, limitedUser, limitedPass);
+    await page.waitForURL(/\/admin(\/|$)/, { timeout: 20000 });
+    await expect(page).toHaveURL(/\/admin\/no-access/);
+  });
+
+  test('LIVE-API-01 Limited user is denied Keycloak admin users API', async ({ request }) => {
+    const tokenRes = await request.post('/realms/CRUD-FORDGE/protocol/openid-connect/token', {
+      form: {
+        grant_type: 'password',
+        client_id: process.env.CRUDFORGE_KC_CLIENT_ID || 'crudforge-client-QA',
+        username: limitedUser,
+        password: limitedPass,
+        scope: 'openid',
+      },
+    });
+    expect(tokenRes.ok(), `token HTTP ${tokenRes.status()}`).toBeTruthy();
+    const tokenJson = await tokenRes.json();
+    expect(tokenJson.access_token).toBeTruthy();
+    const usersRes = await request.get('/admin/realms/CRUD-FORDGE/users?max=1', {
+      headers: { Authorization: `Bearer ${tokenJson.access_token}` },
+    });
+    expect(usersRes.status()).toBeGreaterThanOrEqual(400);
+  });
+
+  test('LIVE-API-02 Realm admin can query users via proxied Admin REST', async ({ request }) => {
+    test.skip(!realmAdminUser || !realmAdminPass, 'KEYCLOAK_ADMIN_* not set');
+    const tokenRes = await request.post('/realms/CRUD-FORDGE/protocol/openid-connect/token', {
+      form: {
+        grant_type: 'password',
+        client_id: process.env.CRUDFORGE_KC_CLIENT_ID || 'crudforge-client-QA',
+        username: realmAdminUser,
+        password: realmAdminPass,
+        scope: 'openid',
+      },
+    });
+    expect(tokenRes.ok(), `admin token HTTP ${tokenRes.status()}`).toBeTruthy();
+    const tokenJson = await tokenRes.json();
+    const usersRes = await request.get('/admin/realms/CRUD-FORDGE/users?username=crudforge-qa-admin&exact=true', {
+      headers: { Authorization: `Bearer ${tokenJson.access_token}` },
+    });
+    expect(usersRes.ok(), `users HTTP ${usersRes.status()}`).toBeTruthy();
+    const users = await usersRes.json();
+    expect(Array.isArray(users)).toBeTruthy();
+    expect(users.some((user) => user.username === 'crudforge-qa-admin')).toBeTruthy();
+  });
+
+  test('LIVE-IAM-01 Seeded ROLE_ADMIN can open User Management UI', async ({ page }) => {
+    await signIn(page, adminUser, adminPass);
+    await page.waitForURL(/\/admin(\/|$)/, { timeout: 20000 });
+    await expect(page).not.toHaveURL(/\/admin\/no-access/);
+    await page.getByRole('treeitem', { name: 'Users' }).click();
+    await expect(page).toHaveURL(/\/admin\/user-management/, { timeout: 15000 });
+    await expect(page.getByRole('heading', { name: 'User Management' })).toBeVisible({ timeout: 20000 });
+  });
+
+  test('LIVE-IAM-02 Realm operator is denied Angular IAM screens without ROLE_ADMIN', async ({ page }) => {
+    test.skip(!realmAdminUser || !realmAdminPass, 'KEYCLOAK_ADMIN_* not set');
+    await signIn(page, realmAdminUser, realmAdminPass);
+    await page.waitForURL(/\/admin(\/|$)/, { timeout: 20000 });
+    await expect(page.getByText(/no screens assigned/i)).toBeVisible();
+  });
+});

package/e2e/tests/iam-pack.spec.js

@@ -0,0 +1,151 @@
+const { test, expect } = require('@playwright/test');
+
+async function signIn(page, username = 'demo@crudforge.com', password = 'admin') {
+  await page.goto('/auth/sign-in');
+  await expect(page.getByRole('button', { name: 'Sign in' })).toBeVisible();
+  const userField = page.locator('#email');
+  await userField.fill(username);
+  await page.locator('input[type="password"]').fill(password);
+  await page.getByRole('button', { name: 'Sign in' }).click();
+}
+
+async function signInAsAdmin(page) {
+  await signIn(page);
+  await page.waitForURL(/\/admin(\/|$)/);
+}
+
+test.describe('IAM AUTH', () => {
+  test('IAM-AUTH-01 Mock admin sign-in reaches welcome', async ({ page }) => {
+    await signInAsAdmin(page);
+    await expect(page).toHaveURL(/\/admin\/welcome|\/admin\/?$/);
+  });
+
+  test('IAM-AUTH-02 Bad password stays on sign-in', async ({ page }) => {
+    await signIn(page, 'demo@crudforge.com', 'wrong-password');
+    await expect(page).toHaveURL(/\/auth\/sign-in/);
+    await expect(page.getByText('Invalid username or password')).toBeVisible();
+  });
+
+  test('IAM-AUTH-03 Guard sends anonymous users to sign-in', async ({ page }) => {
+    await page.goto('/admin/user-management');
+    await expect(page).toHaveURL(/\/auth\/sign-in/);
+  });
+});
+
+test.describe('IAM NAV', () => {
+  test('IAM-NAV-01 User Management nav is visible after admin sign-in', async ({ page }) => {
+    await signInAsAdmin(page);
+    await expect(page.getByText('User Management', { exact: true }).first()).toBeVisible();
+    await expect(page.getByText('Users, roles, and access')).toHaveCount(0);
+    await expect(page.getByRole('treeitem', { name: 'Users' })).toBeVisible();
+    await expect(page.getByRole('treeitem', { name: 'Roles' })).toBeVisible();
+    await expect(page.getByRole('treeitem', { name: 'Role permissions' })).toBeVisible();
+  });
+
+  test('IAM-NAV-02 Admin landing stays on welcome', async ({ page }) => {
+    await signInAsAdmin(page);
+    await expect(page).toHaveURL(/\/admin\/welcome/);
+    await expect(page.getByText('Welcome to CRUDForge')).toBeVisible();
+    await expect(page.getByRole('treeitem', { name: /Books?/i })).toBeVisible();
+  });
+});
+
+test.describe('IAM USERS', () => {
+  test('IAM-USER-01 Users list shows mock admin', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management');
+    await expect(page.getByRole('heading', { name: 'User Management' })).toBeVisible();
+    await expect(page.getByRole('cell', { name: 'admin', exact: true })).toBeVisible();
+    await expect(page.getByRole('cell', { name: 'demo@crudforge.com' })).toBeVisible();
+  });
+
+  test('IAM-USER-02 Create user from dialog', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management');
+    await page.getByRole('button', { name: 'New' }).click();
+    await expect(page.getByRole('heading', { name: 'New User' })).toBeVisible();
+    await page.getByLabel('Username').fill('officer1');
+    await page.getByLabel('Email').fill('officer1@example.com');
+    await page.getByLabel('First name').fill('Office');
+    await page.getByLabel('Last name').fill('One');
+    await page.getByLabel('Temporary password').fill('Temp-123');
+    await page.getByRole('button', { name: 'Save' }).click();
+    await expect(page.getByRole('heading', { name: 'New User' })).toBeHidden();
+    await expect(page.getByRole('cell', { name: 'officer1', exact: true })).toBeVisible();
+  });
+
+  test('IAM-USER-03 View user details', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management');
+    await page.getByRole('button', { name: 'View', exact: true }).first().click();
+    await expect(page.getByRole('heading', { name: 'User Details' })).toBeVisible();
+    await expect(page.getByText('admin').first()).toBeVisible();
+  });
+
+  test('IAM-USER-04 Change password dialog', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management/mock-admin/view');
+    await page.getByRole('button', { name: 'Change password' }).click();
+    await expect(page.getByRole('heading', { name: 'Change password' })).toBeVisible();
+    await page.getByLabel('New password').fill('Next-Pass-1');
+    await page.getByRole('button', { name: 'Save' }).click();
+    await expect(page.getByRole('heading', { name: 'Change password' })).toBeHidden();
+  });
+});
+
+test.describe('IAM ROLES', () => {
+  test('IAM-ROLE-01 Roles list shows ROLE_ADMIN', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management/roles');
+    await expect(page.getByRole('heading', { name: 'Roles' })).toBeVisible();
+    await expect(page.getByRole('button', { name: /ROLE_ADMIN/ })).toBeVisible();
+  });
+
+  test('IAM-ROLE-02 Create role', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management/roles');
+    await page.getByRole('button', { name: 'Create Role' }).click();
+    await page.locator('#iam-role-name').fill('ROLE_OFFICER');
+    await page.locator('#iam-role-description').fill('Field officer');
+    await page.getByRole('button', { name: 'Create' }).click();
+    await expect(page.getByRole('heading', { name: 'ROLE_OFFICER' })).toBeVisible();
+  });
+});
+
+test.describe('IAM MATRICES', () => {
+  test('IAM-PERM-01 Role permission matrix lists screens', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management/role-permissions');
+    await expect(page.getByRole('heading', { name: 'Role permissions' })).toBeVisible();
+    await expect(page.getByRole('columnheader', { name: 'ROLE_ADMIN' })).toBeVisible();
+    await expect(page.getByText('user management', { exact: false }).first()).toBeVisible();
+  });
+
+  test('IAM-ACCESS-01 User roles matrix can assign a role', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management/roles');
+    await page.getByRole('button', { name: 'Create Role' }).click();
+    await page.locator('#iam-role-name').fill('ROLE_READER');
+    await page.getByRole('button', { name: 'Create' }).click();
+    await expect(page.getByRole('heading', { name: 'ROLE_READER' })).toBeVisible();
+
+    await page.goto('/admin/user-management/mock-admin/access');
+    await expect(page.getByRole('heading', { name: 'User roles' })).toBeVisible();
+    const readerRow = page.locator('label').filter({ hasText: 'ROLE_READER' });
+    await expect(readerRow).toBeVisible();
+    await readerRow.getByRole('switch').click();
+    await expect(readerRow.getByRole('switch')).toBeChecked();
+  });
+
+  test('IAM-UPERM-01 User screen grant persists on the matrix', async ({ page }) => {
+    await signInAsAdmin(page);
+    await page.goto('/admin/user-management/mock-admin/permissions');
+    await expect(page.getByRole('heading', { name: 'User screens' })).toBeVisible();
+    const row = page.locator('label').filter({ hasText: /book/i }).first();
+    await expect(row).toBeVisible();
+    const toggle = row.getByRole('switch');
+    const wasChecked = await toggle.isChecked();
+    await toggle.click();
+    await expect(toggle).toBeChecked({ checked: !wasChecked });
+  });
+});

package/e2e/tests/list-state.spec.js

@@ -0,0 +1,73 @@
+const { test, expect } = require('@playwright/test');
+
+async function openBooks(page) {
+  await page.goto('/auth/sign-in');
+  await page.getByRole('button', { name: 'Sign in', exact: true }).click();
+  await page.waitForURL(/\/admin(\/|$)/);
+  await page.goto('/admin/book');
+  await expect(page.getByRole('cell', { name: 'Mock title 1', exact: true })).toBeVisible();
+}
+
+async function editRow(page, index) {
+  await page.locator('button[matTooltip="Edit Book"]').nth(index).click();
+  await page.getByRole('button', { name: 'Confirm', exact: true }).click();
+  const form = page.locator('mat-drawer.cforge-form-drawer');
+  await expect(form.getByRole('heading', { name: 'Edit Book' })).toBeVisible();
+  return form;
+}
+
+test('Edit → close → New resets values, then Edit A → Edit B loads the right record', async ({ page }) => {
+  const errors = [];
+  page.on('pageerror', error => errors.push(error.message));
+  await openBooks(page);
+  const form = await editRow(page, 0);
+  await expect(form.locator('[formControlName="title"]')).toHaveValue('Mock title 1');
+  await form.getByRole('button', { name: 'Cancel' }).click();
+  await page.getByRole('button', { name: 'New', exact: true }).click();
+  await expect(form.getByRole('heading', { name: 'New Book' })).toBeVisible();
+  await expect(form.locator('[formControlName="title"]')).toHaveValue('');
+  await expect(form.locator('[formControlName="pages"]')).toHaveValue('');
+  await expect(form.getByRole('button', { name: 'Save', exact: true })).toBeDisabled();
+  await form.getByRole('button', { name: 'Cancel' }).click();
+  await editRow(page, 0);
+  await expect(form.locator('[formControlName="title"]')).toHaveValue('Mock title 1');
+  await form.getByRole('button', { name: 'Cancel' }).click();
+  await editRow(page, 1);
+  await expect(form.locator('[formControlName="title"]')).toHaveValue('Mock title 2');
+  expect(errors).toEqual([]);
+});
+
+test('list responds to available width and restores the saved view across reloads', async ({ page }) => {
+  await openBooks(page);
+  await page.getByRole('button', { name: 'Switch to Card View' }).click();
+  await expect.poll(() => page.evaluate(() => localStorage.getItem('book-view-mode'))).toBe('card');
+  await page.reload();
+  await expect(page.locator('app-book-card').first()).toBeVisible();
+  await page.getByRole('button', { name: 'Switch to Table View' }).click();
+  await expect(page.locator('table')).toBeVisible();
+  // Change the container alone, as happens with side navigation or an embedded list.
+  const viewport = page.locator('app-book-list .absolute.inset-0').first();
+  await viewport.evaluate(el => { el.style.width = '500px'; });
+  await expect(page.locator('app-book-card').first()).toBeVisible();
+  await expect.poll(() => page.evaluate(() => localStorage.getItem('book-view-mode'))).toBe('table');
+  await viewport.evaluate(el => { el.style.width = ''; });
+  await expect(page.locator('table')).toBeVisible();
+  await page.reload();
+  await expect(page.locator('table')).toBeVisible();
+});
+
+test('audit columns start hidden, can be selected, and Reset hides them again', async ({ page }) => {
+  await openBooks(page);
+  await expect(page.locator('th.mat-column-createdBy')).toHaveCount(0);
+  await page.locator('app-book-actions button').filter({ has: page.locator('mat-icon[svgIcon="menu"]') }).click();
+  const row = page.locator('mat-slide-toggle').locator('..').filter({ hasText: 'Created By' });
+  await row.getByRole('switch').click();
+  await page.keyboard.press('Escape');
+  await expect(page.locator('th.mat-column-createdBy')).toBeVisible();
+  await page.reload();
+  await expect(page.locator('th.mat-column-createdBy')).toBeVisible();
+  await page.locator('app-book-actions button').filter({ has: page.locator('mat-icon[svgIcon="menu"]') }).click();
+  await page.getByRole('button', { name: 'Reset', exact: true }).click();
+  await page.keyboard.press('Escape');
+  await expect(page.locator('th.mat-column-createdBy')).toHaveCount(0);
+});

package/features.csv

@@ -0,0 +1,27 @@
+"Feature Name","Description","How It Works","How To Test It Out"
+"Responsibility-Based Components","Structures entity templates into logical folders based on UI responsibility: card, detail, list under presentation; form, form-page, update under forms; actions, filter under interaction.","Maps template definitions and relative file generation outputs inside the engine to separate UI roles.","Run CLI generation and verify that output components are organized inside presentation/, forms/, and interaction/ subfolders."
+"ASCII Branding Banner","Displays a customizable ASCII banner showing 'CRUDForge' and 'Developed by TeamCodeMe' during npm install and CLI completions. Supports customization of color and suppression.","Prints ASCII banner using formatting helpers, checking config.branding.banner and config.branding.bannerColor configuration settings.","Configure branding: { banner: false } or branding: { bannerColor: 'red' } in config.yml, run cli.js, and verify banner behavior."
+"Smart Terminal Colors","Terminal colors formatting that fallbacks to plain text in environments where colors are not supported or disabled.","Detects TTY status, CI flags, and process.env.NO_COLOR. If present, disables ANSI escape sequences.","Run process.env.NO_COLOR=1 node cli.js and check that terminal logs contain no color escape characters."
+"Execution Metrics & Stats","Calculates and returns execution metrics (file write counts, processed entities, elapsed time) in programmatic runs and CLI summaries.","Increments file counters during template processing and measures time duration using Date.now().","Execute node cli.js and check the detailed run summary section printed at the end of output."
+"JDL/GDL Blueprint Validation","Analyzes schemas before executing generation to catch brace mismatches, duplicate structures, and type-incompatible validations.","Scans file contents line-by-line, runs syntactic and semantic validation checks, and formats error carets (^) pointing to the offending tokens.","Create a JDL with invalid validation rules (e.g. Integer minlength(5)) and run generation to check line-level console errors."
+"Dry-Run & Diff Preview","Runs generation in-memory without making filesystem changes and displays proposed additions and unified diff previews.","Intercepts filesystem ensureDir/write calls when config.dryRun is active and computes line-level additions/deletions using a custom LCS diff algorithm.","Run node cli.js with the --dry-run or -d flag and inspect the proposed new files list and modification diffs."
+"Overwrite Protection & Safe Merging","Protects custom code edits from being overwritten when regenerating schemas. Supports skip, fail, merge, and interactive ask policies.","Scans files on disk for custom code delimiter comments (cforge-custom-code-start / cforge-custom-code-end) and patches them into the new templates.","Seed a generated model file with custom zones, run generation using --overwrite-policy merge, and verify changes are preserved."
+"Relationship Generation","Enables bidirectional entity linking and bindings across generated forms, details, and lists.","Injects related services, loads options arrays in OnInit, renders select/multi-select picker dropdowns, and generates active detail routerLink anchors.","Inspect generated forms for mat-select pickers and detail views for active routerLink navigation tags."
+"Fuse Project Scaffolding","Scaffolds projects from a Fuse Angular starter pack, placing entities, enums, routes, and navigation items inside the Fuse directory layout.","Copies the starter pack, resolves subfolders dynamically, registers routes lazy loading, and adds menu items to navigation.ts with configurable labels, icons, orders, and permissions.","Run the CLI with --fuse flag, verify copied project files, check routes.ts and navigation.ts for registrations, and compile using npx tsc -p tsconfig.app.json --noEmit."
+"Strict Angular Compiler Warning Fixes","Eliminates all NG8107 and NG8113 warnings when generating Angular code.","Uses safe optional chaining with @if directives and conditionally imports ES modules only when actually utilized within templates.","Run the CLI generation with --clean-layout flag, navigate to the output, run 'npm run build', and verify there are zero Angular compiler warnings in the terminal."
+"Fuse Clean Layout Engine","Removes unneeded pre-built UI components like banners, trial alerts, and language switchers to provide a minimal dashboard.","String replaces specific HTML blocks and their backing ES module imports based on the cleanLayout boolean flag.","Run the CLI with --clean-layout flag, serve the Angular project, and verify the top banner and trial cards are gone."
+"Dynamic Module Folder Typings","Allows structuring generation output paths under either 'microservice' or 'micro-functions' folder architectures.","Uses the --folder-type argument to dynamically map the base URL paths when scaffolding the entities into the admin module.","Run the CLI with --folder-type micro-functions, check the src/app/domains/admin/modules/apps directory structure."
+"Automated Project Rebranding","Automatically strips Fuse logos, placeholder text, and demo emails and replaces them with CRUDForge specific branding across login and layouts.","Applies Regex and string replacements across signIn, layout, and sidebar templates during generation to substitute image sources and text copy.","Run the CLI generation, launch the app, and inspect the login screen and sidebar for the CRUDForge logo and copy."
+"Environment & Deployment Setup","Generates dev and prod Angular environments mapped to ports 4200 and 4300, complete with NGINX routing and Docker push scripts.","Modifies angular.json, injects environment.ts files, sets up proxy.conf.json configs, and drops nginx/Docker assets into the output directory.","Run 'npm run dev' to serve on 4200, 'npm start' to serve on 4300, or execute push.sh to build the Docker image."
+"Generic Fallback Error Handler","Implements a universal, reusable error-page fallback component mapped to both global and admin wildcard route handlers.","Generates a single error-page component and registers it as the '**' catch-all route, passing custom status codes and messages via route data instead of using redundant hardcoded templates.","Navigate to a non-existent route like /invalid in the running app and verify the generic error page gracefully catches the request."
+"Sidebar Theming Configuration","Allows toggling the sidebar navigation visual style between light and dark themes.","Injects the scheme-dark class into the layout component if the --sidebar-theme flag is set to 'dark'.","Run the CLI with --sidebar-theme dark and inspect the generated sidebar."
+"Microservice Routing","Supports prefixing generated API routes with a specific microservice name.","Uses the --microservice or -m flag to prepend the microservice name to service endpoint paths.","Run the CLI with -m auth and check the generated Angular service HTTP calls."
+"Configuration Initialization","Generates a default crudforge.config.yml and example schema files to bootstrap new projects.","The init-config command creates standard template files in the current working directory.","Run 'crudforge init-config' and verify the creation of crudforge.config.yml and sample schemas."
+"Custom Configuration Overrides","Allows overriding default generator behaviors via custom YAML/JSON configuration files.","Reads the file specified by the --preferences or -p flag and deep merges it with default internal settings.","Create a custom.yml with specific settings, run CLI with -p custom.yml, and verify the customized output."
+"UI & Form Preferences","Configurable UI parameters such as default view mode (table vs grid), responsive grid columns, and form behaviors (uppercase inputs, error messages).","Parses the 'ui' and 'formBehavior' blocks from the configuration file and injects them as constants into the generated components.","Set formBehavior.uppercaseInputs: true in config, generate a form, and check if the generated inputs have uppercase directives."
+"Mock Data Generation","Generates mock values for CRUD testing when a backend isn't ready.","Uses the 'mock' block to seed generated components with preset string prefixes and randomized numbers/booleans.","Set mock.enabled: true in config, generate a component, and inspect the mock records populated in lists."
+"Audit Fields Handling","Automatically detects common audit fields (e.g. createdBy, createdDate) and handles them according to convention (hiding in forms, showing in details).","Uses the 'fields.audit' configuration block to match property names and adjust template generation visibility logic.","Add a 'createdBy' field to your schema, run generation, and observe that it doesn't appear in the creation form."
+"Naming Conventions Override","Provides deep customization for generated code file prefixes, suffixes, interface prefixes, and enum casing.","Applies the 'namingConventions' configuration block globally to formatting functions used across EJS templates.","Set namingConventions.modelInterfacePrefix to 'Base' in config and check the generated TypeScript model definitions."
+"API Endpoint Customization","Allows configuring REST API bases, microservice names, endpoint styles (like kebab-plural), and date payload libraries (like dayjs).","Injects the 'api' block settings into the generated services HTTP paths and date mapping interceptors.","Set api.endpointStyle to 'kebab-plural' and verify that service endpoints resolve to pluralized kebab-case strings."
+"Dynamic Runtime Configuration","Provides a settings.config.ts pattern to allow runtime overriding of view modes (table vs card), form display modes (sidebar vs page route), snackbar positions, and UI colors without needing to recompile or regenerate the code.","Generates a settings module per entity that gets imported by the list, form, and form-page components. The components dynamically inject these variables into the CSS and component logic during initialization (ngOnInit) or interaction.","Run generation, edit the output settings.config.ts file in the settings directory, change the viewMode to 'card', the formMode to 'page', or the snackbar colors, and observe changes applied dynamically."
+"Base Class Component Architecture","Extracts common Angular boilerplate for forms, lists, and filters into centralized generic base classes.","Moves redundant EJS logic for pagination, sorting, form saving, error handling, and reactive filtering into abstract BaseListComponent, BaseFormComponent, BaseFilterComponent, and filter-types.ts.","Run CLI generation and verify the shared/base folder is populated. Check generated component files to see they extend the base classes and are drastically reduced in size."

package/fuse-starter-pack/fuse-v21.1/Dockerfile

@@ -0,0 +1,14 @@
+# Stage 1: Build the Angular application
+FROM node:24-alpine AS build
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+# Stage 2: Serve the application with Nginx
+FROM nginx:alpine
+COPY --from=build /app/dist/fuse/browser /usr/share/nginx/html
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]

package/fuse-starter-pack/fuse-v21.1/LICENSE.md

@@ -0,0 +1,6 @@
+Envato Standard License
+
+Copyright (c) Sercan Yemen <hi@srcn.dev>
+
+This project is protected by Envato's Standard License. For more information,
+check the official license page at [https://themeforest.net/licenses/standard](https://themeforest.net/licenses/standard)

package/fuse-starter-pack/fuse-v21.1/README.md

@@ -0,0 +1,59 @@
+# Fuse - Angular Starter Kit & Admin Template
+
+This project was generated using [Angular CLI](https://github.com/angular/angular-cli).
+
+## Development server
+
+To start a local development server, run:
+
+```bash
+ng serve
+```
+
+Once the server is running, open your browser and navigate to `http://localhost:4200/`. The application will automatically reload whenever you modify any of the source files.
+
+## Code scaffolding
+
+Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+
+```bash
+ng generate component component-name
+```
+
+For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+
+```bash
+ng generate --help
+```
+
+## Building
+
+To build the project run:
+
+```bash
+ng build
+```
+
+This will compile your project and store the build artifacts in the `dist/` directory. By default, the production build optimizes your application for performance and speed.
+
+## Running unit tests
+
+To execute unit tests with the Vitest, use the following command:
+
+```bash
+ng test
+```
+
+## Running end-to-end tests
+
+For end-to-end (e2e) testing, run:
+
+```bash
+ng e2e
+```
+
+Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+
+## Additional Resources
+
+For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/fuse-starter-pack/fuse-v21.1/angular.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "cli": {
+    "schematicCollections": [
+      "angular-eslint"
+    ],
+    "analytics": false,
+    "cache": {
+      "enabled": true,
+      "environment": "local"
+    }
+  },
+  "newProjectRoot": "projects",
+  "projects": {
+    "fuse": {
+      "projectType": "application",
+      "schematics": {},
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular/build:application",
+          "options": {
+            "browser": "src/main.ts",
+            "tsConfig": "tsconfig.app.json",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "public"
+              }
+            ],
+            "styles": [
+              "src/styles/styles.css"
+            ]
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "1Mb"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "4kB"
+                }
+              ],
+              "outputHashing": "all",
+              "fileReplacements": [
+                {
+                  "replace": "src/environments/environment.ts",
+                  "with": "src/environments/environment.prod.ts"
+                }
+              ]
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            },
+            "mock": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true,
+              "fileReplacements": [
+                {
+                  "replace": "src/environments/environment.ts",
+                  "with": "src/environments/environment.mock.ts"
+                }
+              ]
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular/build:dev-server",
+          "configurations": {
+            "production": {
+              "buildTarget": "fuse:build:production",
+              "port": 4300,
+              "proxyConfig": "proxy.conf.json"
+            },
+            "development": {
+              "buildTarget": "fuse:build:development",
+              "port": 4200,
+              "proxyConfig": "proxy.dev.conf.json"
+            },
+            "mock": {
+              "buildTarget": "fuse:build:mock",
+              "port": 4200,
+              "proxyConfig": "proxy.dev.conf.json"
+            }
+          },
+          "defaultConfiguration": "development"
+        },
+        "test": {
+          "builder": "@angular/build:unit-test"
+        },
+        "lint": {
+          "builder": "@angular-eslint/builder:lint",
+          "options": {
+            "lintFilePatterns": [
+              "src/**/*.ts",
+              "src/**/*.html"
+            ]
+          }
+        }
+      }
+    }
+  }
+}