@atomazing-org/design-system 2.0.2 → 3.7.3

package/dist/themePresets-CwgG5XEL.d.ts

@@ -0,0 +1,65 @@
+import { ThemeOptions, TypeBackground } from '@mui/material/styles';
+import { ReactNode } from 'react';
+
+/**
+ * Available options for dark mode configuration.
+ * - `system`: Follows the operating system preference.
+ * - `light`: Forces light mode.
+ * - `dark`: Forces dark mode.
+ */
+type DarkModeOptions = "system" | "light" | "dark";
+interface OptionItem {
+    label: string;
+    value: DarkModeOptions;
+    icon: ReactNode;
+}
+type ThemeModeBackground = Partial<Record<"light" | "dark", Partial<TypeBackground>>>;
+type NamedThemeOptions = ThemeOptions & {
+    name: string;
+    background?: ThemeModeBackground;
+};
+/**
+ * Represents user-specific theme preferences stored in the application.
+ */
+interface AppSettings {
+    /**
+     * The selected preset id from the available themes list.
+     * Invalid or missing values are normalized to the first available theme.
+     */
+    themeId: string;
+    /**
+     * Controls how dark mode is applied in the app.
+     */
+    darkMode: DarkModeOptions;
+}
+interface ThemeContextProps {
+    theme: string;
+    darkMode: DarkModeOptions;
+    setTheme: (theme: string) => void;
+    setDarkMode: (mode: DarkModeOptions) => void;
+    themes: NamedThemeOptions[];
+    selectedTheme: NamedThemeOptions;
+    defaultThemeName: string;
+}
+
+type ThemeId = string;
+type ThemeScheme = "light" | "dark";
+type DarkModeSetting = DarkModeOptions;
+interface ThemePreset {
+    id: ThemeId;
+    label: string;
+    colorSchemes: {
+        light: ThemeOptions;
+        dark: ThemeOptions;
+    };
+    description?: string;
+    tags?: string[];
+    version?: string;
+}
+type NormalizedPreset = ThemePreset & {
+    meta?: {
+        origin: "preset" | "legacy" | "custom";
+    };
+};
+
+export type { AppSettings as A, DarkModeOptions as D, NamedThemeOptions as N, OptionItem as O, ThemeContextProps as T, ThemePreset as a, ThemeModeBackground as b, NormalizedPreset as c, ThemeId as d, ThemeScheme as e, DarkModeSetting as f };

package/dist/themePresets-CwgG5XEL.js

@@ -0,0 +1 @@
+export {};

package/migrations/README.UPDATE.md

@@ -39,3 +39,5 @@ Use route-based migration instead of ad hoc edits when the target app has:
 - `migrations/scripts/*` is optional legacy automation.
 - The docs and skills are the source of truth for AI-driven migration work.
 - Migration closeout now requires a real app startup check, not only lint/test/build.
+- Run `pnpm run check:migration-readiness` before migration work to validate the
+  local migration pack contract (routes, specs, shared docs, and gitignore rules).

package/migrations/docs/migrations/design-system/routes/adopt-existing/migration.spec.json

@@ -21,11 +21,11 @@
   "steps": [
     {
       "name": "Inventory and baseline",
-      "run": ["npm test", "npm run build"],
       "manualReview": [
         "Map current design-system usage, theme entrypoints, local token modules, shared shell code, shared overlays, and protected routes.",
         "Record pre-existing failing checks separately from migration defects.",
-        "Split the repo into shared-infrastructure scope and domain migration waves before broad edits begin."
+        "Split the repo into shared-infrastructure scope and domain migration waves before broad edits begin.",
+        "Run the target repository baseline checks with its package manager (for example lint, tests, and build when available)."
       ]
     },
     {
@@ -38,13 +38,16 @@
     },
     {
       "name": "Add design-system deps",
-      "run": [
-        "node migrations/scripts/migrations/design-system/actions/update-package-json.mjs --add @atomazing-org/design-system:<SET_VERSION>"
+      "manualReview": [
+        "Edit package.json directly and add or upgrade @atomazing-org/design-system to <SET_VERSION>.",
+        "Align peer runtime package versions as needed and keep the repository package manager conventions intact."
       ]
     },
     {
       "name": "Install deps",
-      "run": ["npm install"]
+      "manualReview": [
+        "Install dependencies with the target repository package manager (npm, pnpm, yarn, or bun)."
+      ]
     },
     {
       "name": "Root theme unification",
@@ -80,14 +83,21 @@
     {
       "name": "Token and primitive cleanup",
       "manualReview": [
-        "Fill token-gate.config.json for the target project.",
-        "Prepare CSV or targeted replacements for legacy tokens and review the diff file by file.",
+        "Prepare targeted replacements for legacy tokens and review the diff file by file.",
         "Normalize visible text to Typography with explicit semantic variants.",
         "Remove zero-value wrapper components and zero-value surface wrappers.",
         "Replace palette alpha suffix hacks with alpha() and simplify decorative consumer surface chrome.",
         "If bulk replacements or file rewrites touched localized copy, scan for mojibake or replacement characters and verify non-Latin UI text still renders readable strings."
       ]
     },
+    {
+      "name": "Shared workflow extraction and bundler hygiene",
+      "manualReview": [
+        "If multiple pages share the same workflow shell, extract one shared layout contract and keep role-specific behavior in headers and sections.",
+        "If local barrels introduce circular chunk warnings for app internals, switch to direct local imports for those modules.",
+        "Fix consumer-owned build warnings such as stale PWA asset globs or oversized local chunks through config and chunking changes, not warning suppression."
+      ]
+    },
     {
       "name": "Domain migration waves",
       "manualReview": [
@@ -98,11 +108,10 @@
     },
     {
       "name": "Quality gates",
-      "run": [
-        "node migrations/scripts/migrations/design-system/gates/no-hardcoded-tokens.mjs --root src --config migrations/scripts/migrations/design-system/shared/token-gate.config.json",
-        "npm run lint",
-        "npm test",
-        "npm run build"
+      "manualReview": [
+        "Re-run the target repository closeout gates with its package manager: lint, tests, and build (when available).",
+        "Run repo-local token and design-contract checks when they exist (for example lint:design-contract).",
+        "Manually verify no forbidden hardcoded token modules or identifiers remain for the target app (for example with rg searches)."
       ]
     }
   ]

package/migrations/docs/migrations/design-system/routes/greenfield/migration.spec.json

@@ -2,11 +2,6 @@
   "$schema": "../../schema/migration.spec.schema.json",
   "id": "greenfield",
   "title": "Greenfield install of @atomazing-org/design-system",
-  "detect": {
-    "packageJson": {
-      "allDependencies": []
-    }
-  },
   "entryConditions": ["package.json exists"],
   "exitConditions": [
     "ThemeProviderWrapper is connected at the app root",
@@ -23,13 +18,16 @@
     },
     {
       "name": "Add deps",
-      "run": [
-        "node migrations/scripts/migrations/design-system/actions/update-package-json.mjs --add @atomazing-org/design-system:<SET_VERSION> --add @mui/material:^7 --add @mui/icons-material:^7 --add @emotion/react:^11 --add @emotion/styled:^11"
+      "manualReview": [
+        "Edit package.json directly and add @atomazing-org/design-system:<SET_VERSION>, @mui/material:^7, @mui/icons-material:^7, @emotion/react:^11, and @emotion/styled:^11.",
+        "Preserve the target repository package manager conventions and lockfile strategy."
       ]
     },
     {
       "name": "Install deps",
-      "run": ["npm install"]
+      "manualReview": [
+        "Install dependencies with the target repository package manager (npm, pnpm, yarn, or bun)."
+      ]
     },
     {
       "name": "Manual integration",
@@ -51,7 +49,10 @@
     },
     {
       "name": "Quality",
-      "run": ["npm run lint", "npm test", "npm run build"]
+      "manualReview": [
+        "Run the target repository quality gates with its package manager: lint, tests, and build (when available).",
+        "If the repository provides smoke, style-contract, design-contract, or typography-contract checks, include them in closeout."
+      ]
     }
   ],
   "gates": ["lint", "tests", "build"]

package/migrations/docs/migrations/design-system/routes/mui4-to-latest/migration.spec.json

@@ -25,11 +25,11 @@
   "steps": [
     {
       "name": "Inventory and baseline",
-      "run": ["npm ci", "npm test", "npm run build"],
       "manualReview": [
         "Map @material-ui/* imports and dependencies plus legacy styling APIs such as makeStyles, withStyles, createMuiTheme, StylesProvider, and ServerStyleSheets.",
         "Record pre-existing failing checks separately from migration defects.",
-        "Split the repo into shared-infrastructure scope and domain migration waves before broad edits begin."
+        "Split the repo into shared-infrastructure scope and domain migration waves before broad edits begin.",
+        "Run baseline checks with the target repository package manager (for example install/ci, tests, and build as available)."
       ]
     },
     {
@@ -42,22 +42,22 @@
     },
     {
       "name": "Update package.json deps (v4 to modern MUI plus design-system)",
-      "run": [
-        "node migrations/scripts/migrations/design-system/actions/update-package-json.mjs --remove @material-ui/core --remove @material-ui/styles --remove @material-ui/icons --add @mui/material:^7 --add @mui/icons-material:^7 --add @emotion/react:^11 --add @emotion/styled:^11 --add @atomazing-org/design-system:<SET_VERSION>"
-      ],
       "manualReview": [
+        "Edit package.json directly: remove @material-ui/core, @material-ui/styles, and @material-ui/icons; add @mui/material:^7, @mui/icons-material:^7, @emotion/react:^11, @emotion/styled:^11, and @atomazing-org/design-system:<SET_VERSION>.",
         "Check for adjacent ecosystem packages such as mui lab, x packages, date-pickers, or data-grid and align them separately.",
         "Treat this as a dependency landing step only; do not mix in broad visual cleanup."
       ]
     },
     {
       "name": "Install deps",
-      "run": ["npm install"]
+      "manualReview": [
+        "Install dependencies with the target repository package manager (npm, pnpm, yarn, or bun)."
+      ]
     },
     {
       "name": "Run official codemod (v4 to v5)",
-      "run": ["npx @mui/codemod@latest v5.0.0/preset-safe src"],
       "manualReview": [
+        "Run the official MUI codemod with a package-manager-appropriate executor (for example pnpm dlx, npm exec, yarn dlx, or bunx): @mui/codemod@latest v5.0.0/preset-safe src.",
         "Review TODO markers and compile errors left by the codemod.",
         "Treat the codemod output as a mechanical landing step, not as a finished migration."
       ]
@@ -110,10 +110,8 @@
     },
     {
       "name": "Apply token remap (project-specific)",
-      "run": [
-        "node migrations/scripts/migrations/design-system/shared/apply-replacements-from-csv.mjs --csv migrations/docs/migrations/design-system/routes/mui4-to-latest/token-map.csv --root src"
-      ],
       "manualReview": [
+        "Use token-map.csv as a reference for targeted replacements and apply changes in controlled batches.",
         "Enable only the rows needed in token-map.csv and review the diff in controlled batches.",
         "For large repos, apply token replacement after shared infrastructure is stable instead of doing a blind repo-wide rewrite first.",
         "For complex replacements, add dedicated rules or perform manual edits.",
@@ -130,14 +128,18 @@
     },
     {
       "name": "Quality gates",
-      "run": [
-        "node migrations/scripts/migrations/design-system/gates/no-legacy-material-ui.mjs --root src",
-        "node migrations/scripts/migrations/design-system/gates/no-hardcoded-tokens.mjs --root src --config migrations/scripts/migrations/design-system/shared/token-gate.config.json",
-        "npm run lint",
-        "npm test",
-        "npm run build"
+      "manualReview": [
+        "Re-run the target repository closeout gates with its package manager: lint, tests, and build (when available).",
+        "Verify package.json and source contain no @material-ui/* dependencies or imports (for example with rg).",
+        "Run repo-local token/design-contract gates when available and manually verify forbidden legacy token usage is removed."
       ]
     }
   ],
-  "gates": ["no-legacy-material-ui", "no-hardcoded-tokens", "lint", "tests", "build"]
+  "gates": [
+    "no-legacy-material-ui",
+    "no-hardcoded-tokens",
+    "lint",
+    "tests",
+    "build"
+  ]
 }