@od-oneapp/config 2026.2.2001-canary.1

package/eslint/utils/filter-ts-eslint-configs.mjs

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview Utility to filter TypeScript ESLint configs from config arrays
+ *
+ * Provides functions to filter out conflicting TypeScript ESLint configurations
+ * when combining configs with framework-specific configs (e.g., eslint-config-next).
+ * Prevents "Cannot redefine plugin" errors in ESLint flat config.
+ *
+ * @module filter-ts-eslint-configs
+ */
+
+/**
+ * Plugins that are commonly provided by framework configs (e.g., eslint-config-next).
+ *
+ * These plugins are provided by framework configs and should be filtered out
+ * when combining with React/base configs to avoid conflicts.
+ *
+ * @type {readonly string[]}
+ */
+const FRAMEWORK_PROVIDED_PLUGINS = ['import', 'jsx-a11y', '@typescript-eslint'];
+
+/**
+ * Filter out TypeScript ESLint configs from a config array.
+ *
+ * Removes configs that:
+ * - Have names starting with `typescript-eslint/` (e.g., `typescript-eslint/base`, `typescript-eslint/recommended`)
+ * - Define the `@typescript-eslint` plugin directly
+ *
+ * This is used when Next.js or other frameworks provide their own TypeScript ESLint setup.
+ *
+ * @param {Array<import('typescript-eslint').Config>} configs - Array of ESLint config objects
+ * @returns {Array<import('typescript-eslint').Config>} Filtered array without TypeScript ESLint configs
+ *
+ * @example
+ * ```javascript
+ * import { filterTypeScriptESLintConfigs } from './utils/filter-ts-eslint-configs.mjs';
+ * import reactConfig from './react.mjs';
+ *
+ * const filteredConfig = filterTypeScriptESLintConfigs(reactConfig);
+ * ```
+ */
+export function filterTypeScriptESLintConfigs(configs) {
+  return configs.filter(config => {
+    // Guard against undefined/null config
+    if (!config || typeof config !== 'object') {
+      return true; // Keep non-object configs (they might be important)
+    }
+
+    // Skip TypeScript ESLint configs by name - Next.js provides these
+    // These come from tseslint.configs.recommended in baseConfig
+    // Configs have names like "typescript-eslint/base", "typescript-eslint/recommended", etc.
+    if (
+      config.name &&
+      typeof config.name === 'string' &&
+      config.name.startsWith('typescript-eslint/')
+    ) {
+      return false; // Filter out TypeScript ESLint configs
+    }
+
+    // Also skip configs that define @typescript-eslint plugin directly
+    if (
+      config.plugins &&
+      typeof config.plugins === 'object' &&
+      '@typescript-eslint' in config.plugins
+    ) {
+      return false; // Filter out TypeScript ESLint plugin configs
+    }
+
+    return true; // Keep all other configs
+  });
+}
+
+/**
+ * Filter out conflicting plugins from a React config array for use with Next.js.
+ *
+ * This function:
+ * 1. Filters out TypeScript ESLint configs (via `filterTypeScriptESLintConfigs`)
+ * 2. Removes conflicting plugins from remaining configs (import, jsx-a11y, @typescript-eslint)
+ *
+ * These plugins are provided by `eslint-config-next` and should not be redefined.
+ * Creates new config objects (immutable operation) to avoid mutating the input.
+ *
+ * @param {Array<import('typescript-eslint').Config>} configs - Array of ESLint config objects (typically from react.mjs)
+ * @returns {Array<import('typescript-eslint').Config>} Filtered array with conflicting plugins removed
+ *
+ * @example
+ * ```javascript
+ * import { filterPluginsForNextJs } from './utils/filter-ts-eslint-configs.mjs';
+ * import reactConfig from './react.mjs';
+ *
+ * const nextCompatibleConfig = filterPluginsForNextJs(reactConfig);
+ * // Use with eslint-config-next without conflicts
+ * ```
+ */
+export function filterPluginsForNextJs(configs) {
+  // First filter out TypeScript ESLint configs
+  const withoutTSConfigs = filterTypeScriptESLintConfigs(configs);
+
+  // Then filter out conflicting plugins from remaining configs
+  return withoutTSConfigs.map(config => {
+    // If config has no plugins, return as-is
+    if (!config.plugins || typeof config.plugins !== 'object') {
+      return config;
+    }
+
+    // Check if config has any conflicting plugins
+    const hasConflictingPlugins = FRAMEWORK_PROVIDED_PLUGINS.some(
+      plugin => plugin in config.plugins,
+    );
+
+    if (!hasConflictingPlugins) {
+      return config; // No conflicts, return as-is
+    }
+
+    // Create new config with filtered plugins (immutable operation)
+    const filteredPlugins = Object.fromEntries(
+      Object.entries(config.plugins).filter(([key]) => !FRAMEWORK_PROVIDED_PLUGINS.includes(key)),
+    );
+
+    if (Object.keys(filteredPlugins).length > 0) {
+      // Return new config with filtered plugins
+      return { ...config, plugins: filteredPlugins };
+    } else {
+      // Return new config without plugins property
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars, unused-imports/no-unused-vars
+      const { plugins, ...rest } = config;
+      return rest;
+    }
+  });
+}

package/eslint/utils/validate-config.mjs

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview ESLint configuration validation utilities
+ *
+ * Provides lightweight validation for ESLint flat config structure.
+ * Catches common configuration errors early during development.
+ */
+
+/**
+ * Validates that an ESLint config object has the correct structure.
+ *
+ * This is a lightweight validation to catch common configuration errors early.
+ * Validates:
+ * - Config is an object or array
+ * - Plugins are objects
+ * - Rules are objects
+ * - languageOptions are objects
+ *
+ * @param {unknown} config - The config object to validate
+ * @param {string} configName - Name of the config for error messages (e.g., 'react', 'node')
+ * @returns {boolean} True if config is valid
+ * @throws {Error} If config is invalid
+ *
+ * @example
+ * ```javascript
+ * import { validateESLintConfig } from './validate-config.mjs';
+ *
+ * const config = { rules: { 'no-console': 'warn' } };
+ * validateESLintConfig(config, 'my-config'); // Returns true or throws
+ * ```
+ */
+export function validateESLintConfig(config, configName = 'config') {
+  // Config must be an object or array (reject null, primitives)
+  // Note: arrays are objects in JS (typeof [] === 'object'), null is caught by !config
+  if (!config || typeof config !== 'object') {
+    throw new Error(`[${configName}] Config must be an object or array`);
+  }
+
+  // If it's an array, validate each item
+  if (Array.isArray(config)) {
+    return config.every((item, index) => validateESLintConfig(item, `${configName}[${index}]`));
+  }
+
+  // Empty objects are valid (might be used for merging)
+  // Configs with no valid keys might still be valid (e.g., shared configs)
+
+  // Validate plugins if present
+  if (config.plugins && typeof config.plugins !== 'object') {
+    throw new Error(`[${configName}] plugins must be an object`);
+  }
+
+  // Validate rules if present
+  if (config.rules && typeof config.rules !== 'object') {
+    throw new Error(`[${configName}] rules must be an object`);
+  }
+
+  // Validate languageOptions if present
+  if (config.languageOptions && typeof config.languageOptions !== 'object') {
+    throw new Error(`[${configName}] languageOptions must be an object`);
+  }
+
+  return true;
+}
+
+/**
+ * Validates all exported ESLint configs to ensure they have correct structure.
+ *
+ * Useful for batch validation of multiple configs during development or testing.
+ * Stops on first error and throws with the name of the failing config.
+ *
+ * @param {Record<string, unknown>} configs - Object mapping config names to config objects
+ * @returns {boolean} True if all configs are valid
+ * @throws {Error} If any config is invalid (includes config name in error)
+ *
+ * @example
+ * ```javascript
+ * import { validateAllConfigs } from './validate-config.mjs';
+ *
+ * const allConfigs = {
+ *   react: reactConfig,
+ *   node: nodeConfig,
+ *   next: nextConfig,
+ * };
+ * validateAllConfigs(allConfigs); // Validates all at once
+ * ```
+ */
+export function validateAllConfigs(configs) {
+  return Object.entries(configs).every(([name, config]) => validateESLintConfig(config, name));
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@od-oneapp/config",
+  "version": "2026.2.2001-canary.1",
+  "description": "Shared configuration for ESLint, Prettier, and TypeScript",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./eslint/node": "./eslint/node.mjs",
+    "./eslint/react": "./eslint/react.mjs",
+    "./eslint/next": "./eslint/next.mjs",
+    "./eslint/next-test": "./eslint/next-test.mjs",
+    "./eslint/expo": "./eslint/expo.mjs",
+    "./eslint/storybook": "./eslint/storybook.mjs",
+    "./eslint/test": "./eslint/test.mjs",
+    "./eslint/utils/filter-ts-eslint-configs": "./eslint/utils/filter-ts-eslint-configs.mjs",
+    "./stylelint": "./stylelint/index.mjs",
+    "./prettier": "./prettier/index.mjs",
+    "./typescript/node.json": "./typescript/node.json",
+    "./typescript/nextjs.json": "./typescript/nextjs.json",
+    "./typescript/react.json": "./typescript/react.json",
+    "./typescript/react-native.json": "./typescript/react-native.json",
+    "./tsdown": "./tsdown/index.mjs",
+    "./tsdown/base": "./tsdown/base.mjs",
+    "./tsdown/presets": "./tsdown/presets.mjs"
+  },
+  "peerDependenciesMeta": {},
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OneDigital-Product/monorepo.git",
+    "directory": "platform/packages/config"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/prettier/index.mjs

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Prettier configuration re-exported from root
+ *
+ * This file re-exports the root `.prettierrc.mjs` to maintain a single source of truth.
+ * All Prettier configuration changes should be made in `/.prettierrc.mjs` at the monorepo root.
+ *
+ * **Usage**:
+ * ```javascript
+ * import prettierConfig from '@od-oneapp/config/prettier';
+ * export default prettierConfig;
+ * ```
+ *
+ * @type {import("prettier").Config}
+ */
+export { default } from '../../../../.prettierrc.mjs';

package/stylelint/index.mjs

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview Enhanced Stylelint configuration for monorepo
+ *
+ * Comprehensive CSS linting configuration with:
+ * - Standard CSS rules (stylelint-config-standard)
+ * - Performance optimizations (animation properties)
+ * - Accessibility checks (indistinguishable colors)
+ * - Tailwind CSS compatibility
+ * - CSS Modules support
+ *
+ * Uses shared ignore patterns from ESLint config for consistency across all linting tools.
+ *
+ * @example
+ * ```javascript
+ * // stylelint.config.mjs
+ * import stylelintConfig from '@od-oneapp/config/stylelint';
+ * export default stylelintConfig;
+ * ```
+ */
+
+import { GLOBAL_IGNORES } from '../eslint/shared/common-ignores.mjs';
+
+/**
+ * Stylelint configuration object
+ *
+ * @type {import('stylelint').Config}
+ */
+const stylelintConfig = {
+  extends: ['stylelint-config-standard'],
+  plugins: ['stylelint-high-performance-animation', 'stylelint-no-indistinguishable-colors'],
+  // Use shared ignores from ESLint config (single source of truth)
+  ignoreFiles: GLOBAL_IGNORES,
+  rules: {
+    // ============================================================================
+    // Performance Rules
+    // ============================================================================
+    'plugin/no-low-performance-animation-properties': true,
+
+    // ============================================================================
+    // Accessibility Rules
+    // ============================================================================
+    'plugin/stylelint-no-indistinguishable-colors': true,
+
+    // ============================================================================
+    // Color Rules
+    // ============================================================================
+    'color-hex-length': 'short',
+    'color-named': 'never',
+
+    // ============================================================================
+    // Property Rules
+    // ============================================================================
+    'declaration-block-no-redundant-longhand-properties': true,
+    'shorthand-property-no-redundant-values': true,
+
+    // ============================================================================
+    // Vendor Prefix Rules
+    // ============================================================================
+    'value-no-vendor-prefix': true,
+    'property-no-vendor-prefix': true,
+    'selector-no-vendor-prefix': true,
+    'media-feature-name-no-vendor-prefix': true,
+    'at-rule-no-vendor-prefix': true,
+
+    // ============================================================================
+    // Modern CSS Best Practices
+    // ============================================================================
+    'declaration-no-important': null, // Allow !important (needed for utility-first CSS like Tailwind)
+    'selector-class-pattern': null, // Allow any class naming (Tailwind uses various patterns)
+    'custom-property-pattern': null, // Allow any CSS variable naming
+    'keyframes-name-pattern': null, // Allow any keyframe naming
+    'selector-id-pattern': null, // Allow any ID naming
+
+    // ============================================================================
+    // Tailwind CSS Compatibility
+    // ============================================================================
+    'at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: [
+          'tailwind',
+          'apply',
+          'variants',
+          'responsive',
+          'screen',
+          'layer',
+          'config',
+          'utility',
+        ],
+      },
+    ],
+    'function-no-unknown': [
+      true,
+      {
+        ignoreFunctions: ['theme', 'screen'],
+      },
+    ],
+
+    // ============================================================================
+    // CSS-in-JS Compatibility
+    // ============================================================================
+    'value-keyword-case': [
+      'lower',
+      {
+        ignoreProperties: ['/^\\$/'], // Ignore Sass variables
+        camelCaseSvgKeywords: true,
+      },
+    ],
+  },
+  overrides: [
+    {
+      // Theme files - allow similar colors and named colors
+      files: ['**/tailwind-theme.css', '**/theme.css', '**/tokens.css', '**/styles.css'],
+      rules: {
+        'plugin/stylelint-no-indistinguishable-colors': null,
+        'color-named': null, // Allow named colors in theme files
+      },
+    },
+    {
+      // CSS Modules - allow camelCase class names
+      files: ['**/*.module.css', '**/*.module.scss'],
+      rules: {
+        'selector-class-pattern': '^[a-z][a-zA-Z0-9]+$', // camelCase
+      },
+    },
+  ],
+};
+
+export default stylelintConfig;

package/tsdown/README.md

@@ -0,0 +1,287 @@
+# tsdown Configuration
+
+TypeScript bundler configurations for the OneApp monorepo.
+
+## Overview
+
+This package provides tsdown configuration presets for building and publishing packages in the monorepo. tsdown is a
+fast, modern TypeScript bundler that generates ESM modules with type definitions.
+
+## Configuration Presets
+
+### Platform Presets
+
+Platform-based presets mirror the tsconfig pattern and provide sensible defaults for different runtime environments:
+
+- **`base`** - Core settings (format, dts, sourcemap, clean)
+- **`node`** - Node.js packages (target: node22)
+- **`browser`** - Browser libraries (target: es2022)
+- **`react`** - React libraries (browser + react externals)
+- **`client`** - Client components (react + 'use client' banner)
+
+### Distribution Builds
+
+For packages that need to be published to npmjs:
+
+- **`createDistConfig`** - Bundles `@repo/*` dependencies, externalizes frameworks
+- **`distExternals`** - Common externals for distribution builds
+- **`internalPackages`** - Internal workspace packages to bundle
+
+## Usage
+
+### Internal Package (Typical Usage)
+
+For packages used only within the monorepo:
+
+```javascript
+// tsdown.config.mjs
+import { node } from "@od-oneapp/config/tsdown";
+
+export default {
+  ...node,
+  entry: ["src/index.ts"],
+  external: [...node.external, "vitest"]
+};
+```
+
+### Distribution Package (@od-oneapp/\*)
+
+For packages published to npmjs:
+
+```javascript
+// tsdown.config.mjs
+import { createDistConfig } from "@od-oneapp/config/tsdown";
+
+export default createDistConfig(
+  "node",
+  {
+    index: "src/index.ts",
+    client: "src/client.ts",
+    server: "src/server.ts"
+  },
+  {
+    external: ["better-auth", "zod"]
+  }
+);
+```
+
+The `createDistConfig` helper:
+
+1. Bundles internal `@repo/*` dependencies into the output
+2. Externalizes framework dependencies (Next.js, React, Prisma)
+3. Rewrites remaining `@repo/*` imports to `@od-oneapp/*` for consumers
+4. Generates proper type definitions
+
+## Package Structure
+
+### Development (`exports`)
+
+During development, packages export source TypeScript files:
+
+```json
+{
+  "exports": {
+    ".": "./src/index.ts",
+    "./client": "./src/client.ts"
+  }
+}
+```
+
+### Production (`publishConfig.exports`)
+
+After building with tsdown, published packages export built artifacts:
+
+```json
+{
+  "publishConfig": {
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.mts",
+        "import": "./dist/index.mjs",
+        "default": "./dist/index.mjs"
+      }
+    }
+  }
+}
+```
+
+## Building Packages
+
+```bash
+# Build a single package
+pnpm --filter @od-oneapp/package-name build
+
+# Build all packages
+pnpm --filter "@od-oneapp/*" build
+
+# Build from package directory
+cd platform/packages/package-name
+pnpm build
+```
+
+## Publishing Packages
+
+For detailed instructions on publishing packages to npmjs, see:
+
+**[DEPLOYMENT.md](./DEPLOYMENT.md)** - Complete guide to deploying tsdown packages
+
+Quick reference:
+
+```bash
+# 1. Build the package
+pnpm --filter @od-oneapp/package-name build
+
+# 2. Navigate to package
+cd platform/packages/package-name
+
+# 3. Publish
+npm publish
+```
+
+## Files
+
+- **`base.mjs`** - Core tsdown settings
+- **`node.mjs`** - Node.js preset
+- **`browser.mjs`** - Browser preset
+- **`react.mjs`** - React preset
+- **`client.mjs`** - Client component preset
+- **`dist.mjs`** - Distribution build helper with import rewriting
+- **`index.mjs`** - Main entry point exporting all presets
+- **`DEPLOYMENT.md`** - Deployment guide for publishing packages
+
+## Configuration Options
+
+### Common Options
+
+All presets support these options:
+
+```javascript
+{
+  entry: ['src/index.ts'],           // Entry points
+  format: 'esm',                      // Output format
+  dts: true,                          // Generate .d.ts files
+  sourcemap: true,                    // Generate source maps
+  clean: true,                        // Clean dist before build
+  external: [],                       // External dependencies
+  target: 'node22',                   // Target runtime
+  plugins: [],                        // Rolldown plugins
+}
+```
+
+### Platform-Specific Options
+
+#### Node.js (`node`)
+
+- Target: Node.js 22+
+- Includes Node built-ins as external
+
+#### Browser (`browser`)
+
+- Target: ES2022
+- Optimized for modern browsers
+
+#### React (`react`)
+
+- Extends browser preset
+- Externalizes React and React DOM
+
+#### Client (`client`)
+
+- Extends react preset
+- Adds `'use client'` banner for React Server Components
+
+## Examples
+
+### Basic Node Package
+
+```javascript
+import { node } from "@od-oneapp/config/tsdown";
+
+export default {
+  ...node,
+  entry: ["src/index.ts"]
+};
+```
+
+### React Component Library
+
+```javascript
+import { react } from "@od-oneapp/config/tsdown";
+
+export default {
+  ...react,
+  entry: {
+    index: "src/index.tsx",
+    components: "src/components/index.tsx"
+  },
+  external: [...react.external, "@mantine/core"]
+};
+```
+
+### Multi-Export Distribution Package
+
+```javascript
+import { createDistConfig } from "@od-oneapp/config/tsdown";
+
+export default createDistConfig(
+  "react",
+  {
+    index: "src/index.ts",
+    client: "src/client/index.ts",
+    server: "src/server/index.ts",
+    "client-next": "src/client/next.ts",
+    "server-next": "src/server/next.ts",
+    hooks: "src/hooks/index.ts"
+  },
+  {
+    external: ["@mantine/core", "@mantine/hooks", "zod"]
+  }
+);
+```
+
+## Troubleshooting
+
+### Build Errors
+
+**"Cannot find module"** - Ensure all dependencies are installed:
+
+```bash
+pnpm install
+```
+
+**Type errors** - Run typecheck before building:
+
+```bash
+pnpm typecheck
+```
+
+### Circular Dependencies
+
+Check for circular imports:
+
+```bash
+pnpm circular
+```
+
+### Import Resolution
+
+If consumers can't resolve imports:
+
+1. Verify `publishConfig.exports` matches your entry points
+2. Check that `files` field includes `dist` and `src`
+3. Ensure external dependencies are properly declared
+
+## Related Documentation
+
+- [tsdown Official Docs](https://tsdown.dev)
+- [DEPLOYMENT.md](./DEPLOYMENT.md) - Publishing to npmjs
+- [Rolldown Docs](https://rolldown.rs) - Underlying bundler
+
+## Support
+
+For issues or questions:
+
+1. Check package-specific `tsdown.config.mjs`
+2. Review this README
+3. See [DEPLOYMENT.md](./DEPLOYMENT.md) for publishing issues
+4. Consult tsdown documentation