@judo/app-shell 0.1.0

package/dist/runtime/types.d.ts

@@ -0,0 +1,308 @@
+import { CustomizationsConfig, MenuLayout } from '@judo/model-api';
+import { ReactNode } from 'react';
+/**
+ * Model loading configuration.
+ */
+export interface ModelConfig {
+    /**
+     * Model source - URL path, full URL, or async loader function.
+     * @example '/models/app.model'
+     * @example 'https://api.example.com/model'
+     * @example () => fetch('/api/model').then(r => r.text())
+     */
+    source?: string | (() => Promise<string>);
+    /**
+     * Initial application to activate (by name).
+     * Defaults to first application in model.
+     */
+    initialApplication?: string;
+}
+/**
+ * Authentication configuration.
+ */
+export interface AuthConfig {
+    /**
+     * Skip authentication entirely.
+     * Useful for development without OIDC server.
+     * @default false
+     */
+    skip?: boolean;
+    /**
+     * OIDC provider configuration.
+     * Only `issuerUrl` is required — all other fields have sensible defaults.
+     */
+    oidc?: {
+        /**
+         * OIDC issuer URL (e.g., Keycloak base URL).
+         * The realm path is appended automatically from the model's Authentication.realm.
+         * The client ID is derived from the active actor's Application.name.
+         *
+         * @example 'https://sso.example.com'
+         * @example 'http://localhost:8080'
+         */
+        issuerUrl: string;
+        /** OAuth scopes. @default 'openid profile email' */
+        scope?: string;
+        /** Redirect URI after login. @default window.location.origin */
+        redirectUri?: string;
+        /** Redirect URI after logout. @default window.location.origin */
+        postLogoutRedirectUri?: string;
+    };
+}
+/**
+ * Backend API configuration.
+ */
+export interface ApiConfig {
+    /** Base URL for REST API calls */
+    baseUrl?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Custom headers to include in all requests */
+    headers?: Record<string, string>;
+}
+/**
+ * Theme configuration.
+ */
+export interface ThemeConfig {
+    /**
+     * Default color mode.
+     * @default 'system'
+     */
+    defaultMode?: "light" | "dark" | "system";
+    /**
+     * LocalStorage key for persisting theme preference.
+     * Set to null to disable persistence.
+     * @default 'judo-theme-mode'
+     */
+    persistKey?: string | null;
+    /**
+     * Primary color override.
+     * @deprecated Use muiThemeOptions.palette.primary instead
+     */
+    primaryColor?: string;
+    /**
+     * Secondary color override.
+     * @deprecated Use muiThemeOptions.palette.secondary instead
+     */
+    secondaryColor?: string;
+    /**
+     * MUI theme options to merge with defaults.
+     * Provides full access to MUI's createTheme() API including typography,
+     * components, spacing, shape, transitions, and more.
+     *
+     * @see https://mui.com/material-ui/customization/theming/
+     */
+    muiThemeOptions?: Record<string, unknown>;
+    /**
+     * UI density preset controlling spacing, font sizes, and component sizes.
+     *
+     * - `compact`     — tight spacing, smaller controls; ideal for data-heavy views.
+     * - `comfortable` — default MUI sizing (no density overrides applied).
+     * - `standard`    — generous spacing, larger touch targets.
+     *
+     * Density options are applied as a base layer; `muiThemeOptions` can still
+     * override individual values.
+     *
+     * @default 'comfortable'
+     */
+    density?: "compact" | "comfortable" | "standard";
+    /**
+     * Named theme preset providing curated primary/secondary color pairs and
+     * background tints for a polished, modern look.
+     *
+     * Built-in presets: `'corporate'`, `'ocean'`, `'slate'`, `'indigo'`, `'forest'`, `'royal'`.
+     *
+     * Explicit `primaryColor`/`secondaryColor` override the preset values.
+     *
+     * @example
+     * ```ts
+     * { preset: 'corporate' }
+     * { preset: 'ocean', primaryColor: '#custom' } // keeps ocean secondary
+     * ```
+     */
+    preset?: "corporate" | "ocean" | "slate" | "indigo" | "forest" | "royal" | (string & {});
+}
+/**
+ * Feature toggles.
+ */
+export interface FeaturesConfig {
+    /**
+     * Enable navigation guards (unsaved changes, session timeout).
+     * @default true
+     */
+    guards?: boolean;
+    /**
+     * Force showTotalCount for all lazy (non-eager) tables.
+     * When enabled, all lazy tables will request total row count from backend,
+     * overriding individual table's showTotalCount setting.
+     * @default false
+     */
+    forceShowTotalCountForLazyTables?: boolean;
+    /**
+     * Enable inline header filters in DataGrid tables.
+     * Requires MUI X Pro license (`muiProLicenseKey` must be set).
+     * When enabled, each column header shows an inline filter input,
+     * replacing the standalone filter panel for a more streamlined UX.
+     * @default false
+     */
+    headerFilters?: boolean;
+}
+/**
+ * Internationalization configuration.
+ */
+export interface I18nConfig {
+    /**
+     * Supported locales. Keys are ISO locale codes, values are display labels.
+     * If not provided, a single "en-US" locale is assumed.
+     *
+     * @example { "en-US": "English", "hu-HU": "Magyar" }
+     */
+    locales?: Record<string, string>;
+    /**
+     * Async locale loader function.
+     * Called with the active locale code; must return a flat key→value translation map
+     * compatible with i18next resource format.
+     *
+     * If not provided, translations are skipped and model labels are used as-is.
+     *
+     * @example
+     * ```ts
+     * localeLoader: (locale) =>
+     *   fetch(`/locales/${locale}.json`).then(r => r.json())
+     * ```
+     */
+    localeLoader?: (locale: string) => Promise<Record<string, string>>;
+    /**
+     * Translation key map: maps element sourceId (xmi:id) to human-readable
+     * translation key path.
+     *
+     * Generated by `@judo/codegen` as `TRANSLATION_KEY_MAP` in
+     * `_translation-key-map.ts`. When provided, `useModelLabel()` uses
+     * these tree-path keys (e.g., `"PageName.container.input"`) instead
+     * of the legacy `"elementType.sourceId.property"` format.
+     */
+    translationKeyMap?: Record<string, string>;
+    /**
+     * When true, the selected locale is persisted to localStorage and
+     * restored automatically on subsequent visits.
+     *
+     * @default false
+     */
+    persistLocale?: boolean;
+}
+/**
+ * Router configuration.
+ */
+export interface RouterConfig {
+    /**
+     * Router type to use.
+     * @default 'browser'
+     */
+    type?: "browser" | "hash" | "memory";
+    /**
+     * Base path for all routes.
+     * @default '/'
+     */
+    basePath?: string;
+}
+/**
+ * Complete runtime configuration.
+ * All properties are optional with sensible defaults.
+ */
+export interface JudoRuntimeConfig {
+    /** Model loading configuration */
+    model?: ModelConfig;
+    /** Authentication configuration */
+    auth?: AuthConfig;
+    /** Backend API configuration */
+    api?: ApiConfig;
+    /** Theme configuration */
+    theme?: ThemeConfig;
+    /** Feature toggles */
+    features?: FeaturesConfig;
+    /** Internationalization configuration */
+    i18n?: I18nConfig;
+    /** Router configuration */
+    router?: RouterConfig;
+    /**
+     * MUI X Pro license key.
+     * When set, the runtime will activate MUI Pro and automatically provide
+     * Pro variants of MUI X components (DataGridPro, DatePickerPro, etc.).
+     * Requires `@mui/x-data-grid-pro` and `@mui/x-license` packages to be installed.
+     */
+    muiProLicenseKey?: string;
+    /**
+     * Menu layout override.
+     * When set, overrides the Application model's `defaultMenuLayout`.
+     * @default undefined (uses model value, falling back to VERTICAL)
+     */
+    menuLayout?: MenuLayout;
+}
+/**
+ * JudoRuntime component props.
+ */
+export interface JudoRuntimeProps {
+    /**
+     * Runtime configuration object.
+     * Can also pass modelSource directly as shorthand.
+     */
+    config?: JudoRuntimeConfig;
+    /**
+     * Shorthand for config.model.source.
+     * Use this for minimal setup.
+     */
+    modelSource?: string | (() => Promise<string>);
+    /**
+     * Custom logo component for app bar.
+     */
+    logo?: ReactNode;
+    /**
+     * Additional content for app bar (right side).
+     */
+    appBarExtra?: ReactNode;
+    /**
+     * Loading component shown during model load.
+     * @default Built-in loading screen
+     */
+    loadingComponent?: ReactNode;
+    /**
+     * Error component shown on load failure.
+     * @default Built-in error screen with retry
+     */
+    errorComponent?: ReactNode | ((error: Error, retry: () => void) => ReactNode);
+    /**
+     * Children to render instead of default routes.
+     * Advanced: only use if you need custom routing.
+     */
+    children?: ReactNode;
+    /**
+     * Customizations configuration for extensibility.
+     * Provides custom component implementations, action lifecycle overrides,
+     * and visual property overrides.
+     *
+     * Use the generated createCustomizations() factory for type-safe bindings,
+     * or build CustomizationsConfig manually.
+     *
+     * @example
+     * ```tsx
+     * import { createCustomizations } from './generated';
+     *
+     * <JudoRuntime
+     *   modelSource="/models/app.model"
+     *   customizations={createCustomizations({
+     *     pages: { UserListPage: useUserListPageActions },
+     *     components: { OrderSummary: OrderSummaryWidget },
+     *   })}
+     * />
+     * ```
+     */
+    customizations?: CustomizationsConfig;
+}
+/**
+ * Internal state for JudoRuntime.
+ */
+export interface JudoRuntimeState {
+    phase: "initializing" | "loading" | "ready" | "error";
+    error: Error | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

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

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from 'react';
+export interface ThemeProviderProps {
+    children: ReactNode;
+}
+/**
+ * Theme provider that creates MUI theme from service configuration.
+ *
+ * Theme merge order (each layer overrides the previous):
+ * 1. JUDO theme factory — modern component overrides based on primary/secondary colors
+ * 2. Density options — spacing/sizing adjustments for compact/comfortable/standard
+ * 3. User-supplied muiThemeOptions — final overrides for full customization
+ *
+ * All layers are merged as raw ThemeOptions **before** calling `createTheme()`
+ * once. This is critical because `createTheme` converts primitive values like
+ * `spacing: 8` into functions (`theme.spacing()`). Passing multiple args to
+ * `createTheme()` deep-merges subsequent args into the *processed* theme,
+ * which can replace those functions with plain primitives and break MUI
+ * components that call e.g. `theme.spacing(2)`.
+ */
+export declare function ThemeProvider({ children }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/theme/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,kBAAkB,2CAkD7D"}

package/dist/theme/ThemeToggle.d.ts

@@ -0,0 +1,11 @@
+export interface ThemeToggleProps {
+    className?: string;
+}
+/**
+ * Theme toggle button cycling through light/dark/system modes.
+ * - Light: Forces light mode
+ * - Dark: Forces dark mode
+ * - System: Follows OS/browser preference
+ */
+export declare function ThemeToggle({ className }: ThemeToggleProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ThemeToggle.d.ts.map

package/dist/theme/ThemeToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeToggle.tsx"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,gBAAgB,2CA6C1D"}

package/dist/theme/density.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Density levels for semantic spacing/sizing.
+ *
+ * - `compact`     — Tight spacing, smaller font sizes; optimized for data-heavy views.
+ * - `comfortable` — Default MUI sizing; balanced between readability and density.
+ * - `standard`    — Generous spacing, slightly larger touch targets; relaxed feel.
+ */
+export type DensityLevel = "compact" | "comfortable" | "standard";
+/**
+ * Returns MUI `ThemeOptions` that implement the requested density level.
+ *
+ * The returned options cover spacing factor, default component props (size/margin),
+ * and typography scaling so that a single `density` knob adjusts the whole UI.
+ *
+ * Merge the result as a **base** layer — caller-supplied `muiThemeOptions` should
+ * be applied on top so they can override individual values.
+ */
+export declare function createDensityThemeOptions(density: DensityLevel): Record<string, unknown>;
+//# sourceMappingURL=density.d.ts.map

package/dist/theme/density.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.d.ts","sourceRoot":"","sources":["../../src/theme/density.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkGxF"}

package/dist/theme/judo-theme-factory.d.ts

@@ -0,0 +1,29 @@
+/**
+ * JUDO Theme Factory
+ *
+ * Creates polished MUI `ThemeOptions` from primary + secondary colors.
+ * The result is designed for enterprise/ERP UIs: information-dense, modern,
+ * and driven by the two supplied brand colors.
+ *
+ * This function does NOT call `createTheme()` — it returns a plain options
+ * object that the ThemeProvider merges with density and user overrides.
+ */
+export interface JudoThemeFactoryOptions {
+    primaryColor: string;
+    secondaryColor: string;
+    mode: "light" | "dark";
+    lightBackground?: string;
+    darkBackground?: string;
+}
+/**
+ * Build modern MUI ThemeOptions driven by primary & secondary colors.
+ *
+ * Design goals:
+ * - Compact but not cramped — enterprise users need information density
+ * - Modern aesthetic: subtle shadows, refined border-radius, crisp typography
+ * - Primary color drives AppBar, buttons, active states
+ * - Secondary color provides accent on FABs, toggles, highlights
+ * - Clean separation of surfaces with subtle elevation
+ */
+export declare function createJudoThemeOptions(options: JudoThemeFactoryOptions): Record<string, unknown>;
+//# sourceMappingURL=judo-theme-factory.d.ts.map

package/dist/theme/judo-theme-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judo-theme-factory.d.ts","sourceRoot":"","sources":["../../src/theme/judo-theme-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkdhG"}

package/dist/theme/presets.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Theme presets for JUDO UI applications.
+ *
+ * Each preset defines a primary and secondary color pair that drives the
+ * entire visual identity. Presets can be used as-is or as starting points
+ * for further customization via `muiThemeOptions`.
+ *
+ * @example
+ * ```ts
+ * import { themePresets } from '@judo/app-shell';
+ *
+ * <JudoRuntime config={{
+ *   theme: {
+ *     preset: 'corporate',
+ *     // or override specific colors:
+ *     // primaryColor: '#custom',
+ *   }
+ * }} />
+ * ```
+ */
+export interface ThemePreset {
+    /** Human-readable preset name */
+    name: string;
+    /** Primary brand color (hex) */
+    primaryColor: string;
+    /** Secondary accent color (hex) */
+    secondaryColor: string;
+    /** Optional background tint for light mode */
+    lightBackground?: string;
+    /** Optional background tint for dark mode */
+    darkBackground?: string;
+}
+/**
+ * Built-in theme presets.
+ *
+ * All presets are designed for enterprise/ERP contexts:
+ * - High contrast for readability
+ * - Professional color combinations
+ * - Suitable for both light and dark modes
+ */
+/**
+ * Built-in theme preset names.
+ * The `(string & {})` allows custom preset names while preserving autocomplete for built-ins.
+ */
+export type ThemePresetName = "corporate" | "ocean" | "slate" | "indigo" | "forest" | "royal";
+export declare const themePresets: Record<ThemePresetName, ThemePreset>;
+/**
+ * Resolve a preset by name. Returns `undefined` if not found.
+ */
+export declare function resolvePreset(presetName: string): ThemePreset | undefined;
+//# sourceMappingURL=presets.d.ts.map

package/dist/theme/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/theme/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,WAAW;IAC3B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9F,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,eAAe,EAAE,WAAW,CAwEpD,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEzE"}

package/dist/user/DefaultHeroComponent.d.ts

@@ -0,0 +1,11 @@
+import { HeroComponentProps } from '@judo/model-api';
+/**
+ * Default hero component rendered in the AppBar for authenticated actors.
+ *
+ * Displays the principal's avatar button that opens a dropdown with
+ * profile info and sign-out.
+ *
+ * Can be replaced via `CustomizationsConfig.heroComponent`.
+ */
+export declare function DefaultHeroComponent({ principal, actorName: _actorName, signOut, onNavigateToProfile, onNavigateToSettings, profilePictureUrl, }: HeroComponentProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DefaultHeroComponent.d.ts.map

package/dist/user/DefaultHeroComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultHeroComponent.d.ts","sourceRoot":"","sources":["../../src/user/DefaultHeroComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAmB1D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EACpC,SAAS,EACT,SAAS,EAAE,UAAU,EACrB,OAAO,EACP,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GACjB,EAAE,kBAAkB,2CA+EpB"}

package/dist/user/UserMenu.d.ts

@@ -0,0 +1,8 @@
+export interface UserMenuProps {
+    className?: string;
+}
+/**
+ * User menu with profile info and logout action.
+ */
+export declare function UserMenu({ className }: UserMenuProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=UserMenu.d.ts.map

package/dist/user/UserMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserMenu.d.ts","sourceRoot":"","sources":["../../src/user/UserMenu.tsx"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,SAAS,EAAE,EAAE,aAAa,kDAyEpD"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@judo/app-shell",
+  "version": "0.1.0",
+  "license": "EPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BlackBeltTechnology/judo-frontend-runtime.git",
+    "directory": "packages/app-shell"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@judo/actions": "0.1.0",
+    "@judo/auth": "0.1.0",
+    "@judo/components": "0.1.0",
+    "@judo/core": "0.1.0",
+    "@judo/feedback": "0.1.0",
+    "@judo/guards": "0.1.0",
+    "@judo/expressions": "0.1.0",
+    "@judo/i18n": "0.1.0",
+    "@judo/model-api": "0.1.0",
+    "@judo/model-loader": "0.1.0",
+    "@judo/test-ids": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.2.14",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router": "^7.13.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "@judo/actions": "0.1.0",
+    "@judo/auth": "0.1.0",
+    "@judo/components": "0.1.0",
+    "@judo/core": "0.1.0",
+    "@judo/feedback": "0.1.0",
+    "@judo/guards": "0.1.0",
+    "@judo/expressions": "0.1.0",
+    "@judo/model-api": "0.1.0",
+    "@judo/model-loader": "0.1.0",
+    "@judo/i18n": "0.1.0",
+    "@judo/test-ids": "0.1.0",
+    "@judo/testing": "0.1.0"
+  },
+  "peerDependencies": {
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.0",
+    "@mui/icons-material": "^7.0.0",
+    "@mui/material": "^7.0.0",
+    "@mui/utils": "^7.0.0",
+    "@mui/x-data-grid-pro": "^8.0.0",
+    "@mui/x-license": "^8.0.0",
+    "react": "^19.0.0",
+    "react-router": "^7.0.0",
+    "@judo/actions": "0.1.0",
+    "@judo/auth": "0.1.0",
+    "@judo/core": "0.1.0",
+    "@judo/feedback": "0.1.0",
+    "@judo/i18n": "0.1.0",
+    "@judo/guards": "0.1.0",
+    "@judo/model-api": "0.1.0",
+    "@judo/test-ids": "0.1.0",
+    "@judo/model-loader": "0.1.0",
+    "@judo/components": "0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@mui/x-data-grid-pro": {
+      "optional": true
+    },
+    "@mui/x-license": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage"
+  }
+}