@mouryaamit/nx-polystack 0.0.0-stage → 1.0.0

package/dist/src/generators/lib/angular-lib.d.ts

@@ -0,0 +1,27 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import { NormalizedLibOptions } from './lib-utils';
+export declare const ANGULAR_LIB_VARIANTS: readonly ["internal", "buildable", "publishable"];
+export interface AngularLibOptions {
+    /** Template folder with the lib's own sources (src/…), rendered into the project root. */
+    srcTemplates: string;
+    /** Extra runtime packages the sources import, given the installed @angular/core version. */
+    dependencies?: (angularCore: string) => Record<string, string>;
+    /** Extra lib package.json peerDependencies, given the installed @angular/core version. */
+    peerDependencies?: (tree: Tree, angularCore: string) => Record<string, string>;
+    /** Build kind when --variant means something else for the type (e.g. state flavours). */
+    build?: AngularLibBuild;
+    /** Extra template substitutions. */
+    vars?: Record<string, unknown>;
+    /** Allowed component class suffixes for ESLint (default: the rule's own, "Component"). */
+    componentSuffixes?: string[];
+}
+/** ng-packagr releases don't follow Angular patch numbers, so pin the major only. */
+export declare function ngPackagrRange(angularCore: string | undefined): string;
+export type AngularLibBuild = (typeof ANGULAR_LIB_VARIANTS)[number];
+/**
+ * Writes an Angular library: tsconfigs, ESLint config, project.json (lint + build per variant),
+ * ng-package.json / package.json / tsconfig.lib.prod.json for buildable and publishable libs,
+ * and the sources from `srcTemplates`. Adds the Angular, lint and ng-packagr packages it needs.
+ * Shared by the angular and ionic types (and the Angular-based extras).
+ */
+export declare function writeAngularLib(tree: Tree, o: NormalizedLibOptions, opts: AngularLibOptions): GeneratorCallback | undefined;

package/dist/src/generators/lib/angular-lib.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeAngularLib = exports.ngPackagrRange = exports.ANGULAR_LIB_VARIANTS = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const devkit_1 = require("@nx/devkit");
+const angular_deps_1 = require("../../lib/utils/angular-deps");
+const dependencies_1 = require("../../lib/utils/dependencies");
+const lib_utils_1 = require("./lib-utils");
+exports.ANGULAR_LIB_VARIANTS = ['internal', 'buildable', 'publishable'];
+/** ng-packagr releases don't follow Angular patch numbers, so pin the major only. */
+function ngPackagrRange(angularCore) {
+    return (0, angular_deps_1.ngPackagrDependencies)(angularCore)['ng-packagr'];
+}
+exports.ngPackagrRange = ngPackagrRange;
+/**
+ * Writes an Angular library: tsconfigs, ESLint config, project.json (lint + build per variant),
+ * ng-package.json / package.json / tsconfig.lib.prod.json for buildable and publishable libs,
+ * and the sources from `srcTemplates`. Adds the Angular, lint and ng-packagr packages it needs.
+ * Shared by the angular and ionic types (and the Angular-based extras).
+ */
+function writeAngularLib(tree, o, opts) {
+    const vars = {
+        ...(0, lib_utils_1.templateVars)(o),
+        prefixCamel: (0, devkit_1.names)(o.prefix).propertyName,
+        componentSuffixes: opts.componentSuffixes ?? null,
+        ...(opts.vars ?? {}),
+    };
+    const build = opts.build ?? o.variant;
+    (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files', 'angular', 'config'), o.projectRoot, vars);
+    (0, devkit_1.generateFiles)(tree, opts.srcTemplates, o.projectRoot, vars);
+    const depsTask = (0, lib_utils_1.combineTasks)((0, dependencies_1.ensureLintDependencies)(tree), (0, angular_deps_1.ensureAngularDependencies)(tree));
+    // ensureAngularDependencies adds Angular 15 when missing, so core is declared from here on
+    // (unless the workspace has no package.json at all).
+    const core = (0, dependencies_1.declaredVersion)(tree, '@angular/core') ?? angular_deps_1.ANGULAR_VERSION;
+    const packaged = build !== 'internal';
+    const extraTask = (0, dependencies_1.addMissingDependencies)(tree, { '@angular/common': core, ...(opts.dependencies?.(core) ?? {}) }, packaged ? (0, angular_deps_1.ngPackagrDependencies)(core) : {});
+    const targets = {};
+    if (packaged) {
+        targets['build'] = {
+            executor: build === 'publishable' ? '@nx/angular:package' : '@nx/angular:ng-packagr-lite',
+            outputs: ['{workspaceRoot}/dist/{projectRoot}'],
+            options: { project: `${o.projectRoot}/ng-package.json` },
+            configurations: {
+                production: { tsConfig: `${o.projectRoot}/tsconfig.lib.prod.json` },
+                development: { tsConfig: `${o.projectRoot}/tsconfig.lib.json` },
+            },
+            defaultConfiguration: 'production',
+        };
+    }
+    targets['lint'] = (0, lib_utils_1.lintTarget)(o, ['**/*.ts', '**/*.html']);
+    (0, lib_utils_1.writeLibProjectJson)(tree, o, {
+        sourceRoot: `${o.projectRoot}/src`,
+        prefix: o.prefix,
+        targets,
+    });
+    if (packaged) {
+        (0, devkit_1.writeJson)(tree, `${o.projectRoot}/ng-package.json`, {
+            $schema: `${o.offset}node_modules/ng-packagr/ng-package.schema.json`,
+            dest: `${o.offset}dist/${o.projectRoot}`,
+            lib: { entryFile: 'src/index.ts' },
+        });
+        (0, devkit_1.writeJson)(tree, `${o.projectRoot}/tsconfig.lib.prod.json`, {
+            extends: './tsconfig.lib.json',
+            compilerOptions: { declarationMap: false },
+            angularCompilerOptions: { compilationMode: 'partial' },
+        });
+        // ng-packagr reads the package name and peers from here, so buildable libs need it too.
+        const peer = (0, lib_utils_1.caretRange)(core, '^15.2.0');
+        (0, devkit_1.writeJson)(tree, `${o.projectRoot}/package.json`, {
+            name: o.importPath,
+            version: '0.0.1',
+            peerDependencies: {
+                '@angular/common': peer,
+                '@angular/core': peer,
+                ...(opts.peerDependencies?.(tree, core) ?? {}),
+            },
+            dependencies: { tslib: '^2.3.0' },
+            sideEffects: false,
+        });
+    }
+    return (0, lib_utils_1.combineTasks)(depsTask, extraTask);
+}
+exports.writeAngularLib = writeAngularLib;
+//# sourceMappingURL=angular-lib.js.map

package/dist/src/generators/lib/angular-lib.js.map

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

package/dist/src/generators/lib/files/angular/component/src/index.ts__template__

@@ -0,0 +1,2 @@
+export * from './lib/<%= fileName %>.module';
+export * from './lib/<%= fileName %>/<%= fileName %>.component';

package/dist/src/generators/lib/files/angular/component/src/lib/__fileName__/__fileName__.component.html__template__

@@ -0,0 +1 @@
+<p><%= fileName %> works!</p>

package/dist/src/generators/lib/files/angular/component/src/lib/__fileName__/__fileName__.component.scss__template__

@@ -0,0 +1,3 @@
+:host {
+  display: block;
+}

package/dist/src/generators/lib/files/angular/component/src/lib/__fileName__/__fileName__.component.ts__template__

@@ -0,0 +1,9 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+@Component({
+  selector: '<%= prefix %>-<%= fileName %>',
+  templateUrl: './<%= fileName %>.component.html',
+  styleUrls: ['./<%= fileName %>.component.scss'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class <%= className %>Component {}

package/dist/src/generators/lib/files/angular/component/src/lib/__fileName__.module.ts__template__

@@ -0,0 +1,11 @@
+import { CommonModule } from '@angular/common';
+import { NgModule } from '@angular/core';
+
+import { <%= className %>Component } from './<%= fileName %>/<%= fileName %>.component';
+
+@NgModule({
+  imports: [CommonModule],
+  declarations: [<%= className %>Component],
+  exports: [<%= className %>Component],
+})
+export class <%= className %>Module {}

package/dist/src/generators/lib/files/angular/config/.eslintrc.json__template__

@@ -0,0 +1,32 @@
+{
+  "extends": ["<%= offset %>.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts"],
+      "extends": [
+        "plugin:@nx/angular",
+        "plugin:@angular-eslint/template/process-inline-templates"
+      ],
+      "rules": {
+        "@angular-eslint/directive-selector": [
+          "error",
+          { "type": "attribute", "prefix": "<%= prefixCamel %>", "style": "camelCase" }
+        ],
+        "@angular-eslint/component-selector": [
+          "error",
+          { "type": "element", "prefix": "<%= prefix %>", "style": "kebab-case" }
+        ]<% if (componentSuffixes) { %>,
+        "@angular-eslint/component-class-suffix": [
+          "error",
+          { "suffixes": <%- JSON.stringify(componentSuffixes) %> }
+        ]<% } %>
+      }
+    },
+    {
+      "files": ["*.html"],
+      "extends": ["plugin:@nx/angular-template"],
+      "rules": {}
+    }
+  ]
+}

package/dist/src/generators/lib/files/angular/config/tsconfig.json__template__

@@ -0,0 +1,22 @@
+{
+  "extends": "<%= offset %>tsconfig.base.json",
+  "compilerOptions": {
+    "target": "es2022",
+    "useDefineForClassFields": false,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "files": [],
+  "include": [],
+  "references": [{ "path": "./tsconfig.lib.json" }],
+  "angularCompilerOptions": {
+    "enableI18nLegacyMessageIdFormat": false,
+    "strictInjectionParameters": true,
+    "strictInputAccessModifiers": true,
+    "strictTemplates": true
+  }
+}

package/dist/src/generators/lib/files/angular/config/tsconfig.lib.json__template__

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "<%= offset %>dist/out-tsc",
+    "declaration": true,
+    "declarationMap": true,
+    "inlineSources": true,
+    "types": []
+  },
+  "exclude": ["src/**/*.spec.ts", "src/test-setup.ts", "src/**/*.test.ts"],
+  "include": ["src/**/*.ts"]
+}

package/dist/src/generators/lib/files/assets/README.md__template__

@@ -0,0 +1,13 @@
+# <%= projectName %>
+
+Shared static files (images, icons, fonts, JSON). Put them under `assets/`.
+
+## Use it in an app
+
+Add this entry to the app's `project.json` → `targets.build.options.assets`:
+
+```json
+{ "glob": "**/*", "input": "<%= projectRoot %>/assets", "output": "assets/<%= dir %>" }
+```
+
+The files are then served from `assets/<%= dir %>/…`, e.g. `<img src="assets/<%= dir %>/logo.svg" />`.

package/dist/src/generators/lib/files/design-tokens/README.md__template__

@@ -0,0 +1,90 @@
+# <%= projectName %>
+
+Design tokens kept in [Style Dictionary v3](https://v3.styledictionary.com/) format and built for
+web (SCSS, CSS, TypeScript) and Flutter (Dart).
+
+```
+tokens/color.json        colors        (color.<type>.<item>)
+tokens/spacing.json      spacing       (size.spacing.<item>, rem)
+tokens/typography.json   font sizes (size.font.*), families (font.family.*),
+                         weights (fontWeight.*) and line heights (lineHeight.*)
+```
+
+Edit the JSON, then rebuild:
+
+```bash
+nx build <%= projectName %>
+# = npx style-dictionary build --config <%= projectRoot %>/style-dictionary.config.js
+```
+
+The outputs are committed, so apps work before the first build:
+
+| Output | Path                                       |
+| ------ | ------------------------------------------ |
+| SCSS   | `<%= projectRoot %>/<%= outputs.scss %>`   |
+| CSS    | `<%= projectRoot %>/<%= outputs.css %>`    |
+| TS     | `<%= projectRoot %>/<%= outputs.ts %>`     |
+| Dart   | `<%= projectRoot %>/<%= outputs.dart %>`   |
+
+They are listed in the workspace `.prettierignore` so formatting never fights the generator.
+
+## SCSS
+
+Add the folder to the app's `stylePreprocessorOptions` in `project.json`:
+
+```json
+"stylePreprocessorOptions": { "includePaths": ["<%= projectRoot %>/generated/scss"] }
+```
+
+```scss
+@use 'tokens' as t;
+
+.button {
+  background: t.$color-brand-primary;
+  padding: t.$size-spacing-sm t.$size-spacing-md;
+}
+```
+
+## CSS custom properties
+
+Add the file to the app's `styles` in `project.json` (before the app's own stylesheet):
+
+```json
+"styles": ["<%= projectRoot %>/<%= outputs.css %>", "apps/<app>/src/styles.scss"]
+```
+
+```css
+.card {
+  color: var(--color-neutral-dark);
+  gap: var(--size-spacing-md);
+}
+```
+
+## TypeScript
+
+```ts
+import { ColorBrandPrimary, SizeSpacingMd } from '<%= importPath %>';
+```
+
+## Flutter (Dart)
+
+`<%= projectRoot %>/generated/dart` is a Dart package (`<%= snakeName %>_tokens`). Depend on it by path
+from the app's `pubspec.yaml`:
+
+```yaml
+dependencies:
+  <%= snakeName %>_tokens:
+    path: ../../<%= projectRoot %>/generated/dart
+```
+
+```dart
+import 'package:<%= snakeName %>_tokens/tokens.dart';
+
+final color = <%= dartClassName %>.colorBrandPrimary;
+final padding = <%= dartClassName %>.sizeSpacingMd; // logical pixels (rem × 16)
+final family = <%= dartClassName %>.fontFamilyBase; // a String
+```
+
+Font families are strings; the font files themselves still go in the app's `pubspec.yaml`. Keep
+only families under `font` — Style Dictionary's Flutter transforms quote every `font` token, which
+is why weights and line heights have their own `fontWeight` and `lineHeight` categories.

package/dist/src/generators/lib/files/design-tokens/generated/dart/pubspec.yaml__template__

@@ -0,0 +1,11 @@
+name: <%= snakeName %>_tokens
+description: <%= title %> design tokens for Flutter, generated by Style Dictionary from <%= projectRoot %>/tokens.
+publish_to: none
+version: 0.0.1
+
+environment:
+  sdk: ">=3.0.0 <4.0.0"
+
+dependencies:
+  flutter:
+    sdk: flutter

package/dist/src/generators/lib/files/design-tokens/src/index.ts__template__

@@ -0,0 +1 @@
+export * from './lib/tokens';

package/dist/src/generators/lib/files/design-tokens/style-dictionary.config.js__template__

@@ -0,0 +1,41 @@
+// Style Dictionary v3 config for <%= projectName %>.
+// Run from the workspace root (`nx build <%= projectName %>` does), so paths start at the root.
+const LIB = '<%= projectRoot %>';
+
+// Fixed header without a timestamp, so the committed outputs only change when tokens do.
+const fileHeader = () => <%- fileHeader %>;
+
+// The flutter transform group quotes every `font` token (font/flutter/literal), so only font
+// families live under `font`; weights and line heights have their own categories.
+module.exports = {
+  source: [`${LIB}/tokens/**/*.json`],
+  platforms: {
+    scss: {
+      transformGroup: 'scss',
+      buildPath: `${LIB}/generated/scss/`,
+      files: [{ destination: '_tokens.scss', format: 'scss/variables', options: { fileHeader } }],
+    },
+    css: {
+      transformGroup: 'css',
+      buildPath: `${LIB}/generated/css/`,
+      files: [{ destination: 'tokens.css', format: 'css/variables', options: { fileHeader } }],
+    },
+    ts: {
+      transformGroup: 'js',
+      buildPath: `${LIB}/src/lib/`,
+      files: [{ destination: 'tokens.ts', format: 'javascript/es6', options: { fileHeader } }],
+    },
+    dart: {
+      transformGroup: 'flutter',
+      buildPath: `${LIB}/generated/dart/lib/`,
+      files: [
+        {
+          destination: 'tokens.dart',
+          format: 'flutter/class.dart',
+          className: '<%= dartClassName %>',
+          options: { fileHeader },
+        },
+      ],
+    },
+  },
+};

package/dist/src/generators/lib/files/flutter/.gitignore__template__

@@ -0,0 +1,7 @@
+.dart_tool/
+build/
+.packages
+.flutter-plugins
+.flutter-plugins-dependencies
+# Packages do not commit their lock file; apps do.
+pubspec.lock

package/dist/src/generators/lib/files/flutter/analysis_options.yaml__template__

@@ -0,0 +1,6 @@
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules:
+    avoid_print: true
+    prefer_const_constructors: true

package/dist/src/generators/lib/files/flutter/lib/__snakeName__.dart__template__

@@ -0,0 +1 @@
+export 'src/<%= snakeName %>.dart';

package/dist/src/generators/lib/files/flutter/lib/src/__snakeName__.dart__template__

@@ -0,0 +1,6 @@
+/// Placeholder API of the <%= snakeName %> package — replace with real code.
+class <%= className %> {
+  const <%= className %>();
+
+  String get name => '<%= snakeName %>';
+}

package/dist/src/generators/lib/files/flutter/pubspec.yaml__template__

@@ -0,0 +1,18 @@
+name: <%= snakeName %>
+description: <%= title %> — shared Flutter package.
+publish_to: none
+version: 0.0.1+1
+
+environment:
+  sdk: ">=3.0.0 <4.0.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^3.0.0
+
+flutter:

package/dist/src/generators/lib/files/flutter/test/__snakeName___test.dart__template__

@@ -0,0 +1,8 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:<%= snakeName %>/<%= snakeName %>.dart';
+
+void main() {
+  test('exposes its name', () {
+    expect(const <%= className %>().name, '<%= snakeName %>');
+  });
+}

package/dist/src/generators/lib/files/ionic/src/index.ts__template__

@@ -0,0 +1,2 @@
+export * from './lib/<%= fileName %>.module';
+export * from './lib/<%= fileName %>/<%= fileName %>.page';

package/dist/src/generators/lib/files/ionic/src/lib/__fileName__/__fileName__.page.html__template__

@@ -0,0 +1,9 @@
+<ion-header>
+  <ion-toolbar>
+    <ion-title><%= title %></ion-title>
+  </ion-toolbar>
+</ion-header>
+
+<ion-content class="ion-padding">
+  <p><%= fileName %> works!</p>
+</ion-content>

package/dist/src/generators/lib/files/ionic/src/lib/__fileName__/__fileName__.page.scss__template__

@@ -0,0 +1,3 @@
+:host {
+  display: block;
+}

package/dist/src/generators/lib/files/ionic/src/lib/__fileName__/__fileName__.page.ts__template__

@@ -0,0 +1,9 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+@Component({
+  selector: '<%= prefix %>-<%= fileName %>',
+  templateUrl: './<%= fileName %>.page.html',
+  styleUrls: ['./<%= fileName %>.page.scss'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class <%= className %>Page {}

package/dist/src/generators/lib/files/ionic/src/lib/__fileName__.module.ts__template__

@@ -0,0 +1,12 @@
+import { CommonModule } from '@angular/common';
+import { NgModule } from '@angular/core';
+import { IonicModule } from '@ionic/angular';
+
+import { <%= className %>Page } from './<%= fileName %>/<%= fileName %>.page';
+
+@NgModule({
+  imports: [CommonModule, IonicModule],
+  declarations: [<%= className %>Page],
+  exports: [<%= className %>Page],
+})
+export class <%= className %>Module {}

package/dist/src/generators/lib/files/pii/README.md__template__

@@ -0,0 +1,35 @@
+# <%= importPath %>
+
+Masks personal data for display. It changes what is shown, not what is stored or sent.
+
+```html
+{{ customer.pan | piiMask: 'pan' }}                              <!-- XXXXX1234F -->
+<span [<%= prefixCamel %>PiiMask]="customer.aadhaar" piiFormat="aadhaar"></span>  <!-- XXXX XXXX 9012 -->
+```
+
+| Format    | Example in → out                                   |
+| --------- | -------------------------------------------------- |
+| `pan`     | `ABCDE1234F` → `XXXXX1234F`                        |
+| `aadhaar` | `1234 5678 9012` → `XXXX XXXX 9012`                |
+| `mobile`  | `+91 98765 43210` → `+91 XXXXX X3210`              |
+| `mobile`  | `+919876543210` → `+91XXXXXX3210`                  |
+| `email`   | `asha.k@example.com` → `aXXX@example.com`          |
+| `account` | `00123456789` → `XXXXXXX6789`                      |
+| `card`    | `4111 1111 1111 1111` → `XXXX XXXX XXXX 1111`      |
+| `ifsc`    | `SBIN0001234` → shown as it is (not personal)      |
+
+A value that does not look like its format, or an unknown format, is masked completely, in any
+script (Devanagari digits, regional-script names, full-width characters). At most half of a
+value's letters and digits are ever shown. The directive replaces its element's content: use it on
+an empty element; `[piiReveal]="true"` shows the value.
+
+Custom formats and the mask character:
+
+```ts
+PiiMaskModule.forRoot({
+  maskChar: '•',
+  rules: { passport: { valid: /^[A-Z]\d{7}$/, visibleEnd: 3 } },
+});
+```
+
+`maskPii(value, format, options)` in `pii-mask.ts` is the same logic without Angular.

package/dist/src/generators/lib/files/pii/src/index.ts__template__

@@ -0,0 +1,5 @@
+export * from './lib/pii-mask';
+export * from './lib/pii-mask.options';
+export * from './lib/pii-mask.pipe';
+export * from './lib/pii-mask.directive';
+export * from './lib/pii-mask.module';

package/dist/src/generators/lib/files/pii/src/lib/pii-mask.directive.ts__template__

@@ -0,0 +1,30 @@
+import { Directive, ElementRef, Inject, Input, OnChanges, Optional } from '@angular/core';
+
+import { maskPii, PiiMaskOptions } from './pii-mask';
+import { PII_MASK_OPTIONS } from './pii-mask.options';
+
+/**
+ * <span [<%= prefixCamel %>PiiMask]="customer.aadhaar" piiFormat="aadhaar"></span>
+ * Writes the masked value as the element's text (never HTML), replacing its content: use it on
+ * an empty element. `[piiReveal]="true"` (a real boolean) shows the value unmasked.
+ */
+@Directive({ selector: '[<%= prefixCamel %>PiiMask]' })
+export class PiiMaskDirective implements OnChanges {
+  @Input('<%= prefixCamel %>PiiMask') value: unknown;
+  @Input() piiFormat = '';
+  @Input() piiReveal = false;
+
+  constructor(
+    private readonly element: ElementRef<HTMLElement>,
+    @Optional() @Inject(PII_MASK_OPTIONS) private readonly options: PiiMaskOptions | null,
+  ) {}
+
+  ngOnChanges(): void {
+    const plain = this.value === null || this.value === undefined ? '' : String(this.value);
+    // Only a real true reveals: a string attribute such as piiReveal="false" keeps it masked.
+    this.element.nativeElement.textContent =
+      this.piiReveal === true
+        ? plain
+      : maskPii(this.value, this.piiFormat, this.options ?? {});
+  }
+}

package/dist/src/generators/lib/files/pii/src/lib/pii-mask.module.ts__template__

@@ -0,0 +1,17 @@
+import { ModuleWithProviders, NgModule } from '@angular/core';
+
+import { PiiMaskOptions } from './pii-mask';
+import { PiiMaskDirective } from './pii-mask.directive';
+import { PII_MASK_OPTIONS } from './pii-mask.options';
+import { PiiMaskPipe } from './pii-mask.pipe';
+
+@NgModule({
+  declarations: [PiiMaskPipe, PiiMaskDirective],
+  exports: [PiiMaskPipe, PiiMaskDirective],
+})
+export class PiiMaskModule {
+  /** Once, in the root module, to set the mask character or add formats. */
+  static forRoot(options: PiiMaskOptions = {}): ModuleWithProviders<PiiMaskModule> {
+    return { ngModule: PiiMaskModule, providers: [{ provide: PII_MASK_OPTIONS, useValue: options }] };
+  }
+}

package/dist/src/generators/lib/files/pii/src/lib/pii-mask.options.ts__template__

@@ -0,0 +1,6 @@
+import { InjectionToken } from '@angular/core';
+
+import { PiiMaskOptions } from './pii-mask';
+
+/** Mask character and custom formats; provide it with PiiMaskModule.forRoot(…). */
+export const PII_MASK_OPTIONS = new InjectionToken<PiiMaskOptions>('PII_MASK_OPTIONS');

package/dist/src/generators/lib/files/pii/src/lib/pii-mask.pipe.ts__template__

@@ -0,0 +1,14 @@
+import { Inject, Optional, Pipe, PipeTransform } from '@angular/core';
+
+import { maskPii, PiiMaskOptions } from './pii-mask';
+import { PII_MASK_OPTIONS } from './pii-mask.options';
+
+/** {{ customer.pan | piiMask: 'pan' }} → XXXXX1234F */
+@Pipe({ name: 'piiMask' })
+export class PiiMaskPipe implements PipeTransform {
+  constructor(@Optional() @Inject(PII_MASK_OPTIONS) private readonly options: PiiMaskOptions | null) {}
+
+  transform(value: unknown, format: string): string {
+    return maskPii(value, format, this.options ?? {});
+  }
+}