@fnd-platform/core 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 fnd-platform contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# @fnd-platform/core
+
+Core package for the fnd-platform toolkit, providing Projen project classes for scaffolding production-ready monorepo projects.
+
+## Installation
+
+```bash
+npm install -D @fnd-platform/core projen
+# or
+pnpm add -D @fnd-platform/core projen
+```
+
+## Quick Start
+
+Create a `.projenrc.ts` file in your project root:
+
+```typescript
+import { FndMonorepoProject } from '@fnd-platform/core';
+
+const project = new FndMonorepoProject({
+  name: 'my-app',
+  defaultReleaseBranch: 'main',
+});
+
+project.synth();
+```
+
+Run Projen to generate all configuration files:
+
+```bash
+npx projen
+```
+
+## What Gets Generated
+
+Running synthesis with `FndMonorepoProject` generates:
+
+- `package.json` - Root package with workspace scripts
+- `pnpm-workspace.yaml` - pnpm workspace configuration
+- `nx.json` - NX build orchestration with caching
+- `tsconfig.base.json` - Shared TypeScript configuration
+- `.eslintrc.js` - Shared ESLint configuration
+- `.prettierrc` - Shared Prettier configuration
+- `vitest.config.ts` - Vitest test configuration
+- `.gitignore` - Standard git ignores
+- `packages/` - Directory for workspace packages
+
+## Configuration Options
+
+```typescript
+interface FndMonorepoProjectOptions {
+  // Required
+  name: string; // Project name
+  defaultReleaseBranch: string; // Default branch for releases
+
+  // Optional
+  workspacePackages?: string[]; // Package directories (default: ['packages/*'])
+  nxCache?: boolean; // Enable NX caching (default: true)
+  nxCacheableOperations?: string[]; // Operations to cache (default: ['build', 'test', 'lint'])
+  description?: string; // Project description
+  repository?: string; // Git repository URL
+  authorName?: string; // Author name
+  authorEmail?: string; // Author email
+}
+```
+
+## Examples
+
+### Custom Workspace Layout
+
+```typescript
+const project = new FndMonorepoProject({
+  name: 'my-app',
+  defaultReleaseBranch: 'main',
+  workspacePackages: ['packages/*', 'apps/*', 'tools/*'],
+});
+```
+
+### Disable NX Caching
+
+```typescript
+const project = new FndMonorepoProject({
+  name: 'my-app',
+  defaultReleaseBranch: 'main',
+  nxCache: false,
+});
+```
+
+### Add Custom Cacheable Operations
+
+```typescript
+const project = new FndMonorepoProject({
+  name: 'my-app',
+  defaultReleaseBranch: 'main',
+  nxCacheableOperations: ['build', 'test', 'lint', 'e2e'],
+});
+```
+
+## API Reference
+
+See the [full API documentation](../../docs/api/modules/core_src.html) for detailed type definitions and examples.
+
+### Project Classes
+
+- `FndMonorepoProject` - Main project class for creating monorepos
+
+### Types
+
+```typescript
+import type { FndMonorepoProjectOptions, NxTargetConfig } from '@fnd-platform/core';
+```
+
+### Components
+
+The package also exports individual components for advanced usage:
+
+```typescript
+import {
+  PnpmWorkspace,
+  NxConfig,
+  SharedTypeScript,
+  SharedEslint,
+  SharedPrettier,
+  SharedVitest,
+} from '@fnd-platform/core';
+
+// Component options types
+import type {
+  PnpmWorkspaceOptions,
+  NxConfigOptions,
+  SharedTypescriptOptions,
+  SharedEslintOptions,
+  SharedPrettierOptions,
+  SharedVitestOptions,
+} from '@fnd-platform/core';
+```
+
+Each component can be used independently with any Projen project.
+
+## Generated Scripts
+
+The following npm scripts are added to the root `package.json`:
+
+| Script          | Description                      |
+| --------------- | -------------------------------- |
+| `build`         | Build all packages with NX       |
+| `test`          | Run tests across all packages    |
+| `test:coverage` | Run tests with coverage          |
+| `lint`          | Lint all packages                |
+| `format`        | Format all files with Prettier   |
+| `format:check`  | Check formatting without changes |
+
+## Requirements
+
+- Node.js 20+
+- pnpm 8+
+- Projen 0.80+
+
+## Related
+
+- [fnd-platform documentation](../../docs/README.md)
+- [Projen documentation](https://projen.io/docs/)
+
+## License
+
+MIT

package/lib/components/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Projen components for generating monorepo configuration files.
+ *
+ * Each component is responsible for generating a specific configuration file
+ * or set of files. Components can be used independently or through the
+ * FndMonorepoProject class.
+ *
+ * @packageDocumentation
+ */
+export { PnpmWorkspace } from './pnpm-workspace';
+export type { PnpmWorkspaceOptions } from './pnpm-workspace';
+export { NxConfig } from './nx-config';
+export type { NxConfigOptions } from './nx-config';
+export { SharedTypeScript } from './shared-typescript';
+export type { SharedTypescriptOptions } from './shared-typescript';
+export { SharedEslint } from './shared-eslint';
+export type { SharedEslintOptions } from './shared-eslint';
+export { SharedPrettier } from './shared-prettier';
+export type { SharedPrettierOptions } from './shared-prettier';
+export { SharedVitest } from './shared-vitest';
+export type { SharedVitestOptions } from './shared-vitest';
+//# sourceMappingURL=index.d.ts.map

package/lib/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/components/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Projen components for generating monorepo configuration files.
+ *
+ * Each component is responsible for generating a specific configuration file
+ * or set of files. Components can be used independently or through the
+ * FndMonorepoProject class.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedVitest = exports.SharedPrettier = exports.SharedEslint = exports.SharedTypeScript = exports.NxConfig = exports.PnpmWorkspace = void 0;
+var pnpm_workspace_1 = require("./pnpm-workspace");
+Object.defineProperty(exports, "PnpmWorkspace", { enumerable: true, get: function () { return pnpm_workspace_1.PnpmWorkspace; } });
+var nx_config_1 = require("./nx-config");
+Object.defineProperty(exports, "NxConfig", { enumerable: true, get: function () { return nx_config_1.NxConfig; } });
+var shared_typescript_1 = require("./shared-typescript");
+Object.defineProperty(exports, "SharedTypeScript", { enumerable: true, get: function () { return shared_typescript_1.SharedTypeScript; } });
+var shared_eslint_1 = require("./shared-eslint");
+Object.defineProperty(exports, "SharedEslint", { enumerable: true, get: function () { return shared_eslint_1.SharedEslint; } });
+var shared_prettier_1 = require("./shared-prettier");
+Object.defineProperty(exports, "SharedPrettier", { enumerable: true, get: function () { return shared_prettier_1.SharedPrettier; } });
+var shared_vitest_1 = require("./shared-vitest");
+Object.defineProperty(exports, "SharedVitest", { enumerable: true, get: function () { return shared_vitest_1.SharedVitest; } });
+//# sourceMappingURL=index.js.map

package/lib/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAGtB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAGjB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAGzB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAGrB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAGvB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA"}

package/lib/components/nx-config.d.ts

@@ -0,0 +1,67 @@
+import { Component, Project } from 'projen';
+import type { NxTargetConfig } from '../options';
+/**
+ * Options for the NxConfig component.
+ */
+export interface NxConfigOptions {
+    /**
+     * Enable caching for NX tasks.
+     *
+     * @default true
+     */
+    readonly cacheEnabled?: boolean;
+    /**
+     * Operations that should be cached by NX.
+     *
+     * @default ['build', 'test', 'lint']
+     */
+    readonly cacheableOperations?: string[];
+    /**
+     * Default configurations for NX targets.
+     *
+     * These settings apply to all projects unless overridden.
+     */
+    readonly targetDefaults?: Record<string, NxTargetConfig>;
+    /**
+     * Named inputs that can be referenced by targets.
+     *
+     * Define reusable sets of files that affect target execution.
+     */
+    readonly namedInputs?: Record<string, string[]>;
+}
+/**
+ * Generates an nx.json configuration file for build orchestration.
+ *
+ * This component creates the NX configuration that enables:
+ * - Intelligent caching for build, test, and lint operations
+ * - Dependency-based task ordering
+ * - Named inputs for cache computation
+ *
+ * @example
+ * ```typescript
+ * new NxConfig(project, {
+ *   cacheEnabled: true,
+ *   cacheableOperations: ['build', 'test', 'lint'],
+ * });
+ * ```
+ */
+export declare class NxConfig extends Component {
+    /**
+     * Whether caching is enabled.
+     */
+    readonly cacheEnabled: boolean;
+    /**
+     * Operations that are cached.
+     */
+    readonly cacheableOperations: string[];
+    /**
+     * Target default configurations.
+     */
+    readonly targetDefaults: Record<string, NxTargetConfig>;
+    /**
+     * Named inputs for cache computation.
+     */
+    readonly namedInputs: Record<string, string[]>;
+    constructor(project: Project, options?: NxConfigOptions);
+}
+//# sourceMappingURL=nx-config.d.ts.map

package/lib/components/nx-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nx-config.d.ts","sourceRoot":"","sources":["../../src/components/nx-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAY,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEzD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjD;AAoCD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,SAAQ,SAAS;IACrC;;OAEG;IACH,SAAgB,YAAY,EAAE,OAAO,CAAC;IAEtC;;OAEG;IACH,SAAgB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAE9C;;OAEG;IACH,SAAgB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE/D;;OAEG;IACH,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAE1C,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB;CAiC5D"}

package/lib/components/nx-config.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NxConfig = void 0;
+const projen_1 = require("projen");
+/**
+ * Default target configurations for a monorepo.
+ */
+const DEFAULT_TARGET_DEFAULTS = {
+    build: {
+        dependsOn: ['^build'],
+        cache: true,
+    },
+    test: {
+        cache: true,
+    },
+    lint: {
+        cache: true,
+    },
+};
+/**
+ * Default named inputs for NX cache computation.
+ */
+const DEFAULT_NAMED_INPUTS = {
+    default: ['{projectRoot}/**/*', 'sharedGlobals'],
+    production: [
+        'default',
+        '!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)',
+        '!{projectRoot}/tsconfig.spec.json',
+        '!{projectRoot}/.eslintrc.json',
+    ],
+    sharedGlobals: [
+        '{workspaceRoot}/tsconfig.base.json',
+        '{workspaceRoot}/.eslintrc.js',
+        '{workspaceRoot}/.prettierrc',
+    ],
+};
+/**
+ * Generates an nx.json configuration file for build orchestration.
+ *
+ * This component creates the NX configuration that enables:
+ * - Intelligent caching for build, test, and lint operations
+ * - Dependency-based task ordering
+ * - Named inputs for cache computation
+ *
+ * @example
+ * ```typescript
+ * new NxConfig(project, {
+ *   cacheEnabled: true,
+ *   cacheableOperations: ['build', 'test', 'lint'],
+ * });
+ * ```
+ */
+class NxConfig extends projen_1.Component {
+    /**
+     * Whether caching is enabled.
+     */
+    cacheEnabled;
+    /**
+     * Operations that are cached.
+     */
+    cacheableOperations;
+    /**
+     * Target default configurations.
+     */
+    targetDefaults;
+    /**
+     * Named inputs for cache computation.
+     */
+    namedInputs;
+    constructor(project, options = {}) {
+        super(project);
+        this.cacheEnabled = options.cacheEnabled ?? true;
+        this.cacheableOperations = options.cacheableOperations ?? ['build', 'test', 'lint'];
+        this.targetDefaults = {
+            ...DEFAULT_TARGET_DEFAULTS,
+            ...options.targetDefaults,
+        };
+        this.namedInputs = {
+            ...DEFAULT_NAMED_INPUTS,
+            ...options.namedInputs,
+        };
+        // Build the nx.json configuration
+        const nxConfig = {
+            $schema: './node_modules/nx/schemas/nx-schema.json',
+            tasksRunnerOptions: {
+                default: {
+                    runner: 'nx/tasks-runners/default',
+                    options: {
+                        cacheableOperations: this.cacheEnabled ? this.cacheableOperations : [],
+                    },
+                },
+            },
+            targetDefaults: this.targetDefaults,
+            namedInputs: this.namedInputs,
+        };
+        new projen_1.JsonFile(project, 'nx.json', {
+            obj: nxConfig,
+        });
+    }
+}
+exports.NxConfig = NxConfig;
+//# sourceMappingURL=nx-config.js.map

package/lib/components/nx-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nx-config.js","sourceRoot":"","sources":["../../src/components/nx-config.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAoCtD;;GAEG;AACH,MAAM,uBAAuB,GAAmC;IAC9D,KAAK,EAAE;QACL,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,KAAK,EAAE,IAAI;KACZ;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,IAAI;KACZ;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,IAAI;KACZ;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAA6B;IACrD,OAAO,EAAE,CAAC,oBAAoB,EAAE,eAAe,CAAC;IAChD,UAAU,EAAE;QACV,SAAS;QACT,uDAAuD;QACvD,mCAAmC;QACnC,+BAA+B;KAChC;IACD,aAAa,EAAE;QACb,oCAAoC;QACpC,8BAA8B;QAC9B,6BAA6B;KAC9B;CACF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAa,QAAS,SAAQ,kBAAS;IACrC;;OAEG;IACa,YAAY,CAAU;IAEtC;;OAEG;IACa,mBAAmB,CAAW;IAE9C;;OAEG;IACa,cAAc,CAAiC;IAE/D;;OAEG;IACa,WAAW,CAA2B;IAEtD,YAAY,OAAgB,EAAE,UAA2B,EAAE;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;QACjD,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpF,IAAI,CAAC,cAAc,GAAG;YACpB,GAAG,uBAAuB;YAC1B,GAAG,OAAO,CAAC,cAAc;SAC1B,CAAC;QACF,IAAI,CAAC,WAAW,GAAG;YACjB,GAAG,oBAAoB;YACvB,GAAG,OAAO,CAAC,WAAW;SACvB,CAAC;QAEF,kCAAkC;QAClC,MAAM,QAAQ,GAA4B;YACxC,OAAO,EAAE,0CAA0C;YACnD,kBAAkB,EAAE;gBAClB,OAAO,EAAE;oBACP,MAAM,EAAE,0BAA0B;oBAClC,OAAO,EAAE;wBACP,mBAAmB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE;qBACvE;iBACF;aACF;YACD,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,IAAI,iBAAQ,CAAC,OAAO,EAAE,SAAS,EAAE;YAC/B,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;IACL,CAAC;CACF;AAtDD,4BAsDC"}

package/lib/components/pnpm-workspace.d.ts

@@ -0,0 +1,34 @@
+import { Component, Project } from 'projen';
+/**
+ * Options for the PnpmWorkspace component.
+ */
+export interface PnpmWorkspaceOptions {
+    /**
+     * Glob patterns for workspace package directories.
+     *
+     * @example ['packages/*']
+     * @example ['packages/*', 'apps/*', 'tools/*']
+     */
+    readonly packages: string[];
+}
+/**
+ * Generates a pnpm-workspace.yaml file for configuring pnpm workspaces.
+ *
+ * This component creates the workspace configuration that tells pnpm
+ * which directories contain packages in the monorepo.
+ *
+ * @example
+ * ```typescript
+ * new PnpmWorkspace(project, {
+ *   packages: ['packages/*', 'apps/*'],
+ * });
+ * ```
+ */
+export declare class PnpmWorkspace extends Component {
+    /**
+     * The patterns for workspace packages.
+     */
+    readonly packages: string[];
+    constructor(project: Project, options: PnpmWorkspaceOptions);
+}
+//# sourceMappingURL=pnpm-workspace.d.ts.map

package/lib/components/pnpm-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-workspace.d.ts","sourceRoot":"","sources":["../../src/components/pnpm-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAY,MAAM,QAAQ,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAEvB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB;CAW5D"}

package/lib/components/pnpm-workspace.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PnpmWorkspace = void 0;
+const projen_1 = require("projen");
+/**
+ * Generates a pnpm-workspace.yaml file for configuring pnpm workspaces.
+ *
+ * This component creates the workspace configuration that tells pnpm
+ * which directories contain packages in the monorepo.
+ *
+ * @example
+ * ```typescript
+ * new PnpmWorkspace(project, {
+ *   packages: ['packages/*', 'apps/*'],
+ * });
+ * ```
+ */
+class PnpmWorkspace extends projen_1.Component {
+    /**
+     * The patterns for workspace packages.
+     */
+    packages;
+    constructor(project, options) {
+        super(project);
+        this.packages = options.packages;
+        new projen_1.YamlFile(project, 'pnpm-workspace.yaml', {
+            obj: {
+                packages: this.packages,
+            },
+        });
+    }
+}
+exports.PnpmWorkspace = PnpmWorkspace;
+//# sourceMappingURL=pnpm-workspace.js.map

package/lib/components/pnpm-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-workspace.js","sourceRoot":"","sources":["../../src/components/pnpm-workspace.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAetD;;;;;;;;;;;;GAYG;AACH,MAAa,aAAc,SAAQ,kBAAS;IAC1C;;OAEG;IACa,QAAQ,CAAW;IAEnC,YAAY,OAAgB,EAAE,OAA6B;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAEjC,IAAI,iBAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE;YAC3C,GAAG,EAAE;gBACH,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAjBD,sCAiBC"}

package/lib/components/shared-eslint.d.ts

@@ -0,0 +1,51 @@
+import { Component, Project } from 'projen';
+/**
+ * Options for the SharedEslint component.
+ */
+export interface SharedEslintOptions {
+    /**
+     * ECMAScript version for parsing.
+     *
+     * @default 2022
+     */
+    readonly ecmaVersion?: number;
+    /**
+     * Source type (module or script).
+     *
+     * @default 'module'
+     */
+    readonly sourceType?: 'module' | 'script';
+    /**
+     * Patterns to ignore.
+     *
+     * @default ['dist/', 'node_modules/', '*.js', '!.eslintrc.js', 'coverage/', '.nx/']
+     */
+    readonly ignorePatterns?: string[];
+    /**
+     * Warn on explicit any usage instead of error.
+     *
+     * @default true
+     */
+    readonly warnOnExplicitAny?: boolean;
+    /**
+     * Additional rules to include.
+     */
+    readonly additionalRules?: Record<string, unknown>;
+}
+/**
+ * Generates a .eslintrc.js configuration file for code linting.
+ *
+ * This component creates an ESLint configuration using TypeScript parser
+ * and recommended rules. It's designed for TypeScript-first monorepos.
+ *
+ * @example
+ * ```typescript
+ * new SharedEslint(project, {
+ *   warnOnExplicitAny: true,
+ * });
+ * ```
+ */
+export declare class SharedEslint extends Component {
+    constructor(project: Project, options?: SharedEslintOptions);
+}
+//# sourceMappingURL=shared-eslint.d.ts.map

package/lib/components/shared-eslint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-eslint.d.ts","sourceRoot":"","sources":["../../src/components/shared-eslint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAY,MAAM,QAAQ,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB;CAuDhE"}

package/lib/components/shared-eslint.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedEslint = void 0;
+const projen_1 = require("projen");
+/**
+ * Generates a .eslintrc.js configuration file for code linting.
+ *
+ * This component creates an ESLint configuration using TypeScript parser
+ * and recommended rules. It's designed for TypeScript-first monorepos.
+ *
+ * @example
+ * ```typescript
+ * new SharedEslint(project, {
+ *   warnOnExplicitAny: true,
+ * });
+ * ```
+ */
+class SharedEslint extends projen_1.Component {
+    constructor(project, options = {}) {
+        super(project);
+        const ecmaVersion = options.ecmaVersion ?? 2022;
+        const sourceType = options.sourceType ?? 'module';
+        const warnOnExplicitAny = options.warnOnExplicitAny ?? true;
+        const ignorePatterns = options.ignorePatterns ?? [
+            'dist/',
+            'node_modules/',
+            '*.js',
+            '!.eslintrc.js',
+            'coverage/',
+            '.nx/',
+        ];
+        // Build additional rules
+        const additionalRulesStr = options.additionalRules
+            ? Object.entries(options.additionalRules)
+                .map(([key, value]) => `    '${key}': ${JSON.stringify(value)},`)
+                .join('\n')
+            : '';
+        const configContent = `module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: ${ecmaVersion},
+    sourceType: '${sourceType}',
+  },
+  plugins: ['@typescript-eslint'],
+  extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended'],
+  rules: {
+    '@typescript-eslint/no-explicit-any': '${warnOnExplicitAny ? 'warn' : 'error'}',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-unused-vars': [
+      'error',
+      {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+      },
+    ],
+${additionalRulesStr}  },
+  ignorePatterns: ${JSON.stringify(ignorePatterns)},
+  env: {
+    node: true,
+    es2022: true,
+  },
+};
+`;
+        new projen_1.TextFile(project, '.eslintrc.js', {
+            lines: configContent.split('\n'),
+        });
+    }
+}
+exports.SharedEslint = SharedEslint;
+//# sourceMappingURL=shared-eslint.js.map

package/lib/components/shared-eslint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-eslint.js","sourceRoot":"","sources":["../../src/components/shared-eslint.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAwCtD;;;;;;;;;;;;GAYG;AACH,MAAa,YAAa,SAAQ,kBAAS;IACzC,YAAY,OAAgB,EAAE,UAA+B,EAAE;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC;QAClD,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;QAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI;YAC/C,OAAO;YACP,eAAe;YACf,MAAM;YACN,eAAe;YACf,WAAW;YACX,MAAM;SACP,CAAC;QAEF,yBAAyB;QACzB,MAAM,kBAAkB,GAAG,OAAO,CAAC,eAAe;YAChD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;iBACpC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;iBAChE,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,aAAa,GAAG;;;;mBAIP,WAAW;mBACX,UAAU;;;;;6CAKgB,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;;;;;;;;;EAU/E,kBAAkB;oBACA,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;;;;CAMjD,CAAC;QAEE,IAAI,iBAAQ,CAAC,OAAO,EAAE,cAAc,EAAE;YACpC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;CACF;AAxDD,oCAwDC"}