@mlola-ui/registry 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mlola
+
+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,38 @@
+# @mlola-ui/registry
+
+Validated Registry v2 metadata and the deterministic source snapshot that the
+Mlola CLI installs. This is the source of truth for component files, targets,
+dependencies, checksums, and preview loaders.
+
+This package ships the **open-source components only**. Blocks, pages, and
+templates are the commercial catalog and are not part of this tarball. Every
+manifest is generated and checked: dependency closure, checksums, and snapshot
+integrity are verified in CI, so the registry cannot describe an item the
+library does not ship.
+
+## Install
+
+```bash
+npm install @mlola-ui/registry
+```
+
+## Use
+
+```js
+import index from "@mlola-ui/registry/index.json" with { type: "json" };
+import button from "@mlola-ui/registry/items/components/button" with { type: "json" };
+
+console.log(index.components, button.files);
+```
+
+## Exports
+
+| Path | What it is |
+| --- | --- |
+| `@mlola-ui/registry` | the snapshot index |
+| `@mlola-ui/registry/index.json` | the v2 index: themes, components, items |
+| `@mlola-ui/registry/items/components/*` | one manifest per component |
+| `@mlola-ui/registry/schema/*` | JSON schemas for the index, items, and project config |
+| `@mlola-ui/registry/generated/catalog` | a flat TypeScript catalog for tools |
+
+MIT licensed. Part of [Mlola UI](https://ui.mlola.com).

package/components/accordion.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "accordion",
+  "type": "registry:ui",
+  "title": "Accordion",
+  "description": "A collapsible content panel supporting single and multiple open modes",
+  "category": "layout",
+  "variants": [
+    "single",
+    "multiple"
+  ],
+  "sizes": [],
+  "tags": [
+    "interactive",
+    "disclosure",
+    "layout"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/accordion",
+    "exportName": "Accordion",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/behavior": "^1.0.0",
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/accordion/accordion.tsx",
+      "target": "{{aliases.components}}/accordion.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-0ALaLJd1fvj8Vbx86HLBKm3qUItrtwbrGJTykVfNSMg="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/activity-heatmap.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "activity-heatmap",
+  "type": "registry:ui",
+  "title": "Activity Heatmap",
+  "description": "Activity by day in GitHub's calendar grid, with quantile shading, a keyboard grid and hover detail",
+  "category": "data",
+  "tags": [
+    "data",
+    "chart",
+    "calendar",
+    "usage",
+    "heatmap"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/activity-heatmap",
+    "exportName": "ActivityHeatmap",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {},
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/activity-heatmap/activity-heatmap.tsx",
+      "target": "{{aliases.components}}/activity-heatmap.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-fMGDlXKpOfIOy0hmbpR8hKrbbN3fC386tXK27A21ZwM="
+    },
+    {
+      "path": "packages/components/activity-heatmap/calendar.ts",
+      "target": "{{aliases.components}}/activity-heatmap/calendar.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-NB+AjXY5Xc+KzR8MMTRBgZxdzOeoHhkW0KQOW7WJPuQ="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/alert.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "category": "feedback",
+  "description": "A status banner with variants, dismiss action, and optional action slot",
+  "name": "alert",
+  "sizes": [],
+  "tags": [
+    "status",
+    "feedback",
+    "banner"
+  ],
+  "title": "Alert",
+  "type": "registry:ui",
+  "variants": [
+    "default",
+    "success",
+    "warning",
+    "danger",
+    "info"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/alert",
+    "exportName": "Alert",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/alert/alert.tsx",
+      "target": "{{aliases.components}}/alert.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-kg//PTcUW7j7AEnhfO/pZFddm++RIo8yKur46OeoeNo="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/app-shell.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "app-shell",
+  "type": "registry:ui",
+  "title": "App Shell",
+  "description": "A resizable, foldable sidebar with sections and items that becomes a drawer on small screens",
+  "category": "layout",
+  "tags": [
+    "app shell",
+    "sidebar",
+    "navigation",
+    "layout",
+    "drawer"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/app-shell",
+    "exportName": "AppShell",
+    "isDefault": false
+  },
+  "registryDependencies": [
+    "resizable",
+    "sheet"
+  ],
+  "engineDependencies": {
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/app-shell/app-shell.tsx",
+      "target": "{{aliases.components}}/app-shell.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-XAq82XOTH3ZR+hxTkYFu8P7Ih2aI6ERy/TpXc2VMUwM="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/avatar.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "avatar",
+  "type": "registry:ui",
+  "title": "Avatar",
+  "description": "User avatar with image, initials fallback, and status indicator",
+  "category": "data",
+  "variants": [],
+  "sizes": [
+    "xs",
+    "sm",
+    "md",
+    "lg",
+    "xl"
+  ],
+  "tags": [
+    "media",
+    "user",
+    "identity"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/avatar",
+    "exportName": "Avatar",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {},
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/avatar/avatar.tsx",
+      "target": "{{aliases.components}}/avatar.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-hvZUGhatN95ZyX6p6NBhTRf6h1/rrJ+bJrqBMtIspq0="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/badge.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "badge",
+  "type": "registry:ui",
+  "title": "Badge",
+  "description": "A small status or label badge with color variants, dot indicator, and removal",
+  "category": "data",
+  "variants": [
+    "default",
+    "primary",
+    "secondary",
+    "success",
+    "warning",
+    "danger",
+    "outline"
+  ],
+  "sizes": [
+    "sm",
+    "md",
+    "lg"
+  ],
+  "tags": [
+    "status",
+    "label",
+    "indicator"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/badge",
+    "exportName": "Badge",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/badge/badge.tsx",
+      "target": "{{aliases.components}}/badge.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-+mgudoxlPn+mjpQycUfQmv8sC/e/K5FXfXm2+wnH7bI="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/breadcrumb.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "breadcrumb",
+  "type": "registry:ui",
+  "title": "Breadcrumb",
+  "description": "Navigation breadcrumb trail with custom separators and responsive collapse",
+  "category": "navigation",
+  "variants": [],
+  "sizes": [],
+  "tags": [
+    "navigation",
+    "wayfinding"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/breadcrumb",
+    "exportName": "Breadcrumb",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/breadcrumb/breadcrumb.tsx",
+      "target": "{{aliases.components}}/breadcrumb.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-SiIpg0oAieyoZbMlBwwQDZhR/KVIFLFCLCQJ6vwv7Fs="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/button.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "button",
+  "type": "registry:ui",
+  "title": "Button",
+  "description": "A versatile button component with multiple variants, sizes, and states",
+  "category": "actions",
+  "variants": [
+    "primary",
+    "secondary",
+    "subtle",
+    "danger",
+    "outline",
+    "link"
+  ],
+  "sizes": [
+    "sm",
+    "md",
+    "lg",
+    "icon"
+  ],
+  "tags": [
+    "interactive",
+    "form",
+    "navigation"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/button",
+    "exportName": "Button",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/motion": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/button/button.tsx",
+      "target": "{{aliases.components}}/button.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-khqYxcV3hlZ+Q+cYNTRXEpAfIijDFSvkuDJXMPtlk7g="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/calendar.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "calendar",
+  "type": "registry:ui",
+  "title": "Calendar",
+  "description": "A month grid for one date, a range or several, with min and max, blocked days, two-month view and full keyboard paging",
+  "category": "forms",
+  "tags": [
+    "date",
+    "calendar",
+    "range",
+    "picker"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/calendar",
+    "exportName": "Calendar",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/calendar/calendar.tsx",
+      "target": "{{aliases.components}}/calendar.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-uE22LI4jpU8ErR/oBmAkeKiu+Rp0bz3IXZVCurycpwc="
+    },
+    {
+      "path": "packages/components/calendar/dates.ts",
+      "target": "{{aliases.components}}/calendar/dates.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-mygYkoC70av2ZQ0vkxf885trwW97Wd10I4dptYQe+4A="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/card.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "card",
+  "type": "registry:ui",
+  "title": "Card",
+  "description": "A compound card with header, content, and footer slots in four surface variants",
+  "category": "data",
+  "variants": [
+    "default",
+    "elevated",
+    "outline",
+    "subtle"
+  ],
+  "sizes": [],
+  "tags": [
+    "layout",
+    "container",
+    "surface"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/card",
+    "exportName": "Card",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {},
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/card/card.tsx",
+      "target": "{{aliases.components}}/card.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-aMKbv5DWYYWq7GZAFR9O1fuYE0H61WCjkvEbRMOd894="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}

package/components/carousel.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "../schema/registry-item.schema.json",
+  "schemaVersion": 2,
+  "name": "carousel",
+  "type": "registry:ui",
+  "title": "Carousel",
+  "description": "One slide at a time with previous/next controls and a roving dot group",
+  "category": "data",
+  "variants": [],
+  "sizes": [],
+  "tags": [
+    "component",
+    "carousel",
+    "navigation",
+    "collection"
+  ],
+  "usage": {
+    "importPath": "{{aliases.components}}/carousel",
+    "exportName": "Carousel",
+    "isDefault": false
+  },
+  "registryDependencies": [],
+  "engineDependencies": {
+    "@mlola-ui/behavior": "^1.0.0",
+    "@mlola-ui/icons": "^1.0.0"
+  },
+  "files": [
+    {
+      "path": "packages/components/_internal/react.ts",
+      "target": "{{aliases.components}}/_internal/react.ts",
+      "type": "registry:ui",
+      "integrity": "sha256-SH63/haiB4Q93uFjMIMe5xZbaxENu3VI+GcidV8HELM="
+    },
+    {
+      "path": "packages/components/carousel/carousel.tsx",
+      "target": "{{aliases.components}}/carousel.tsx",
+      "type": "registry:ui",
+      "integrity": "sha256-LAPKz9DG9vEBv/8jKjqgH7XiSEERkWWLr4n/Kve1omQ="
+    }
+  ],
+  "themeContract": {
+    "attribute": "data-theme",
+    "modeAttribute": "data-mode",
+    "compatibleThemes": [
+      "graphite",
+      "atelier",
+      "machined",
+      "aerogel",
+      "nordic"
+    ]
+  }
+}