@vireocodedev/ui 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vireocodedev
+
+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,83 @@
+# @vireocodedev/ui
+
+The **MUI-based Vireo component library** for the vireocodedev **starter** product,
+including TanStack-bound forms, responsive tables, overlays, page layout,
+typed integrations, foundational providers, hooks, and formatters.
+
+> This package takes `@mui/*` as **peer dependencies** — it is tied to the
+> starter design system, not a generic component kit.
+
+## Install
+
+```bash
+npm install @vireocodedev/ui
+```
+
+The package is published publicly on npm; installation requires no registry
+authentication.
+
+Peers: `react`, `react-dom`, `@mui/material`, `@mui/icons-material`,
+`@mui/x-date-pickers`, `@emotion/react`, `@emotion/styled`,
+`@tanstack/react-query`, `i18next`,
+`react-i18next`, `zod`, `sonner`, `dayjs`. Depends on
+`@vireocodedev/localization`, which owns the `platform` and `history`
+translation namespaces this package renders.
+
+The package ships unbundled: `dist` mirrors `src` file-for-file. Supported
+consumer entry points are nevertheless limited to the package root and the
+subpaths declared in `package.json`; undeclared implementation paths are not a
+compatibility contract.
+
+TypeScript declarations are verified from the packed artifact with TypeScript
+6, `moduleResolution: "Bundler"`, and `skipLibCheck: false`. This file-for-file
+package intentionally omits source maps; its public source remains available in
+the repository.
+
+## What's included
+
+- **Components** — Vireo form fields and layout primitives, responsive cards,
+  tables, overlays, navigation, feedback, and data-display components.
+- **Forms** — `useVireoForm`, its bound `form.*` and `field.*` APIs, and
+  `VireoResponsiveFormOverlay`.
+- **Tables** — `VireoResponsiveTable`, the typed container-aware desktop table
+  and mobile accordion contract with controlled sorting, pagination, loading,
+  filtering surfaces, incremental mobile loading, and scroll restoration.
+- **Providers** — `VireoConfirmationProvider`, `VireoIconRegistryProvider`,
+  `VireoProviderComposer`, and `VireoThemeColorMeta`.
+- **Localization integrations** — temporal picker localization under
+  `/localization` and namespace-bound React hooks under `/react-i18next`.
+- **Hooks** — `useVireoDebouncedCallback`, `useVireoFullscreen`,
+  `useVireoTransitionPresence`, `useAppPageContentLayout`,
+  `usePageOverlayModes`, and `useDelayedOverlayMount`.
+- **Overlays** — responsive side-panel/drawer frames, page-overlay controller,
+  delayed mounting, and guarded mode switching.
+- **Layout** — `AppPageContentLayoutContext`, layout utils + shell breakpoints,
+  `PageBody`, and measured page-content mode.
+- **Unsaved changes** — scoped registration, confirmation, and route-leave
+  guard primitives for app composition roots.
+- **Utils** — currency/date formatters, `downloadFile`.
+
+## Notes
+
+- Everything is a **named export** off the package root.
+- The app retains only composition roots that supply app-specific policy and
+  routing; the reusable form, overlay, table, and unsaved-change behavior lives
+  in this package.
+
+## Architecture and authoring
+
+The architecture guides describe the required destination for the ongoing
+source migration. Existing legacy paths are tracked explicitly; new and moved
+code must follow the target structure.
+
+- [Source structure](./docs/architecture/source-structure.md)
+- [Capability structure](./docs/architecture/capability-structure.md)
+- [Component folder categories](./docs/architecture/component-folder-categories.md)
+- [Migration and current-source inventory](./docs/architecture/migration.md)
+- [Vireo component authoring](./docs/component-authoring/component-files.md)
+- [Vireo story coverage rulebook](./docs/component-authoring/story-coverage-rulebook.md)
+- [Motion and interaction language](./docs/storybook/MotionGuide.mdx)
+
+## Versioning contract
+
+The exported surface is a contract (add = minor, remove/rename = major).

package/package.json

@@ -0,0 +1,197 @@
+{
+  "name": "@vireocodedev/ui",
+  "version": "0.2.0",
+  "description": "MUI-based UI component library (responsive cards, mobile tables, overlays, providers, hooks, formatters) for the vireocodedev starter product.",
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vireocodedev/starter.git",
+    "directory": "packages/ui"
+  },
+  "keywords": [
+    "ui",
+    "mui",
+    "react",
+    "components",
+    "starter"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./country": {
+      "types": "./dist/capabilities/country/public.d.ts",
+      "import": "./dist/capabilities/country/public.js",
+      "default": "./dist/capabilities/country/public.js"
+    },
+    "./event-source": {
+      "types": "./dist/integrations/event-source/public.d.ts",
+      "import": "./dist/integrations/event-source/public.js",
+      "default": "./dist/integrations/event-source/public.js"
+    },
+    "./forms": {
+      "types": "./dist/capabilities/forms/public.d.ts",
+      "import": "./dist/capabilities/forms/public.js",
+      "default": "./dist/capabilities/forms/public.js"
+    },
+    "./hello-pangea-dnd": {
+      "types": "./dist/integrations/hello-pangea-dnd/public.d.ts",
+      "import": "./dist/integrations/hello-pangea-dnd/public.js",
+      "default": "./dist/integrations/hello-pangea-dnd/public.js"
+    },
+    "./localization": {
+      "types": "./dist/integrations/localization/public.d.ts",
+      "import": "./dist/integrations/localization/public.js",
+      "default": "./dist/integrations/localization/public.js"
+    },
+    "./react-i18next": {
+      "types": "./dist/integrations/react-i18next/public.d.ts",
+      "import": "./dist/integrations/react-i18next/public.js",
+      "default": "./dist/integrations/react-i18next/public.js"
+    },
+    "./sonner": {
+      "types": "./dist/integrations/sonner/public.d.ts",
+      "import": "./dist/integrations/sonner/public.js",
+      "default": "./dist/integrations/sonner/public.js"
+    },
+    "./tanstack-query": {
+      "types": "./dist/integrations/tanstack-query/public.d.ts",
+      "import": "./dist/integrations/tanstack-query/public.js",
+      "default": "./dist/integrations/tanstack-query/public.js"
+    },
+    "./storybook": {
+      "types": "./dist/storybook/index.d.ts",
+      "import": "./dist/storybook/index.js",
+      "default": "./dist/storybook/index.js"
+    },
+    "./storybook/VireoIconContainer": {
+      "types": "./dist/storybook/VireoIconContainer/index.d.ts",
+      "import": "./dist/storybook/VireoIconContainer/index.js",
+      "default": "./dist/storybook/VireoIconContainer/index.js"
+    },
+    "./storybook/VireoDockedSidePanel": {
+      "types": "./dist/storybook/VireoDockedSidePanel/index.d.ts",
+      "import": "./dist/storybook/VireoDockedSidePanel/index.js",
+      "default": "./dist/storybook/VireoDockedSidePanel/index.js"
+    },
+    "./storybook/VireoResponsiveOverlayFrame": {
+      "types": "./dist/storybook/VireoResponsiveOverlayFrame/index.d.ts",
+      "import": "./dist/storybook/VireoResponsiveOverlayFrame/index.js",
+      "default": "./dist/storybook/VireoResponsiveOverlayFrame/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build:css": "copyfiles -u 1 \"src/**/*.css\" dist",
+    "build": "corepack npm run clean && corepack npm run build:types && concurrently --kill-others-on-fail -n storybook,css \"corepack npm run build:storybook-types:emit\" \"corepack npm run build:css\" && tsc-alias -p tsconfig.build.json && tsc-alias -p tsconfig.storybook.build.json",
+    "build:types": "tsc -p tsconfig.build.json --noCheck",
+    "build:storybook-types": "corepack npm run build:types && corepack npm run build:storybook-types:emit",
+    "build:storybook-types:emit": "tsc -p tsconfig.storybook.build.json --noCheck",
+    "build:storybook-exports": "corepack npm run build:storybook-types && tsc-alias -p tsconfig.storybook.build.json",
+    "dev": "concurrently -k -n tsc,aliases,css \"npm run dev:tsc\" \"npm run dev:aliases\" \"npm run dev:css\"",
+    "dev:tsc": "tsc -w -p tsconfig.build.json",
+    "dev:aliases": "tsc-alias -w -p tsconfig.build.json",
+    "dev:css": "chokidar \"src/**/*.css\" -c \"npm run build:css\" --initial",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "storybook": "storybook dev -p 6006 -c .storybook-vireo",
+    "build-storybook": "storybook build -c .storybook-vireo"
+  },
+  "dependencies": {
+    "@vireocodedev/history": "^0.2.0",
+    "@vireocodedev/infrastructure": "^0.2.0",
+    "@vireocodedev/localization": "^0.2.0",
+    "@vireocodedev/query": "^0.2.0",
+    "country-flag-icons": "1.6.20",
+    "react-error-boundary": "^6.1.3"
+  },
+  "peerDependencies": {
+    "@hello-pangea/dnd": ">=18 <19",
+    "@emotion/react": ">=11.14 <12",
+    "@emotion/styled": ">=11.14 <12",
+    "@mui/icons-material": ">=9 <10",
+    "@mui/material": ">=9 <10",
+    "@mui/x-date-pickers": ">=9 <10",
+    "@tanstack/react-form": ">=1.33 <2",
+    "@tanstack/react-query": ">=5.80 <6",
+    "dayjs": ">=1.11",
+    "i18next": ">=26 <27",
+    "react": ">=19.2 <20",
+    "react-dom": ">=19.2 <20",
+    "react-i18next": ">=17 <18",
+    "sonner": ">=2",
+    "zod": ">=4.4 <5"
+  },
+  "peerDependenciesMeta": {
+    "@hello-pangea/dnd": {
+      "optional": true
+    },
+    "@tanstack/react-form": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "i18next": {
+      "optional": true
+    },
+    "react-i18next": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@hello-pangea/dnd": "^18.0.1",
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.0",
+    "@mui/icons-material": "^9.3.1",
+    "@mui/material": "^9.3.1",
+    "@mui/x-date-pickers": "^9.12.0",
+    "@storybook/addon-docs": "^10.5.10",
+    "@storybook/icons": "^2.1.0",
+    "@storybook/react-vite": "^10.5.10",
+    "@tanstack/react-form": "1.33.5",
+    "@tanstack/react-query": "^5.102.1",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.13.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "chokidar-cli": "^3.0.0",
+    "concurrently": "^10.0.5",
+    "copyfiles": "^2.4.1",
+    "dayjs": "^1.11.23",
+    "i18next": "^26.4.0",
+    "jsdom": "^30.0.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-i18next": "^17.0.12",
+    "rimraf": "^6.0.1",
+    "sonner": "^2.0.8",
+    "storybook": "^10.5.10",
+    "tsc-alias": "^1.9.2",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vite": "^8.2.2",
+    "vitest": "^4.1.11",
+    "zod": "^4.4.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org"
+  }
+}