mlola-ui 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,72 @@
+# mlola-ui
+
+The Mlola UI source-copy CLI. It writes components, blocks, pages, and templates
+into your project, rewrites their imports to your aliases, and installs nothing
+else. Framework-free: the copied markup works in any language that can emit
+HTML, and React sources use only React.
+
+The library's contract is generated from its own stylesheet, so a model reading
+it cannot invent a class or attribute that does not exist.
+
+## Install
+
+```bash
+npx mlola-ui init
+npx mlola-ui add button sheet hero-split landing
+npx mlola-ui doctor
+```
+
+`init` writes `mlola.config.json` and the engine stylesheet. `add` resolves the
+dependency graph (a page pulls its blocks, a block pulls its components) and
+copies only what you asked for. `doctor` checks the project against the registry:
+missing engine imports, legacy attributes, modified generated files, and
+forbidden dependencies.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `init` | create `mlola.config.json` and the stylesheet entry |
+| `add <items…>` | copy items and their dependencies into the project |
+| `list [--json]` | print every installable item |
+| `doctor` | report project and registry problems |
+| `login <token>` | save a Mlola Pro token (from /account) for this user |
+| `logout` | forget the saved token |
+
+## Mlola Pro
+
+Pro components, blocks, pages and templates are not in this package. With a
+licence, create a token at https://ui.mlola.com/account, then:
+
+```sh
+npx mlola-ui login mlp_…
+npx mlola-ui add conversation bot
+```
+
+`add` fetches Pro items and their Pro dependencies from the service, checks
+every file against its integrity hash, and writes them like any other item.
+Free dependencies still come from this package. Pro stylesheets land in
+`styles/mlola-pro/`, gathered by `styles/mlola-pro.css`: import it once, after
+the engine stylesheet. `mlola-pro.agents.md` at the project root lists every
+Pro class and attribute for coding agents; point your `AGENTS.md` at it. In CI, set `MLOLA_PRO_TOKEN` instead of logging in. The
+token is stored in `~/.config/mlola-ui/credentials.json`, readable by you only.
+
+## Configuration
+
+Aliases and targets live in `mlola.config.json`:
+
+```json
+{
+  "aliases": {
+    "components": "@/components/ui",
+    "blocks": "@/components/blocks",
+    "pages": "@/app/pages",
+    "templates": "@/app/templates"
+  }
+}
+```
+
+The CLI works from an npm tarball with no repository checkout; the packed
+installation is tested in CI.
+
+MIT licensed. Part of [Mlola UI](https://ui.mlola.com).

package/bin/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from "../src/cli.js";
+
+process.exitCode = await run(process.argv.slice(2));

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "mlola-ui",
+  "version": "1.0.0",
+  "description": "Source-copy CLI that writes framework-free Mlola UI items into your project",
+  "type": "module",
+  "bin": {
+    "mlola-ui": "./bin/index.js"
+  },
+  "exports": {
+    ".": "./src/cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "registry"
+  ],
+  "scripts": {
+    "build": "node --check bin/index.js && node --check src/cli.js",
+    "test": "node --test test/*.test.js"
+  },
+  "keywords": [
+    "mlola",
+    "ui",
+    "components",
+    "design-system",
+    "cli",
+    "registry"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "author": "Mlola",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mlolahq/mlola-ui.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://ui.mlola.com",
+  "bugs": {
+    "url": "https://github.com/mlolahq/mlola-ui/issues"
+  }
+}

package/registry/catalog.json

@@ -0,0 +1,97 @@
+{
+  "components": [
+    "bot",
+    "citation",
+    "code-block",
+    "confidence-text",
+    "context-cards",
+    "context-meter",
+    "conversation",
+    "diff-view",
+    "file-changes",
+    "message",
+    "model-picker",
+    "orb",
+    "prompt-input",
+    "selection-actions",
+    "streaming-text",
+    "suggestions",
+    "task-list",
+    "thinking",
+    "tool-call",
+    "voice-wave",
+    "file-tree",
+    "terminal",
+    "source-control",
+    "commit-history",
+    "editor-tabs",
+    "canvas",
+    "canvas-toolbar",
+    "minimap",
+    "node-graph",
+    "whiteboard",
+    "rich-text-editor",
+    "block-editor",
+    "suggested-edit",
+    "property-picker",
+    "filter-bar",
+    "kanban",
+    "chart",
+    "line-chart",
+    "bar-chart",
+    "donut-chart",
+    "sparkline",
+    "gantt",
+    "data-grid",
+    "scheduler",
+    "funnel-chart",
+    "radar-chart",
+    "scatter-chart",
+    "treemap",
+    "trace-viewer",
+    "eval-grid",
+    "model-compare",
+    "prompt-playground",
+    "generative-ui",
+    "transcript"
+  ],
+  "blocks": [
+    "ai-chat",
+    "auth-split",
+    "cta-footer",
+    "data-table",
+    "faq-accordion",
+    "feature-grid",
+    "hero-split",
+    "navbar",
+    "newsletter",
+    "pricing-tiers",
+    "product-grid",
+    "stats-band",
+    "testimonials",
+    "thread-sidebar",
+    "voice-session"
+  ],
+  "pages": [
+    "auth",
+    "blog",
+    "chat-app",
+    "dashboard",
+    "landing",
+    "pricing"
+  ],
+  "templates": [
+    "code-agent",
+    "ecommerce",
+    "canvas-studio",
+    "notebook",
+    "tracker",
+    "analytics",
+    "settings",
+    "ai-console",
+    "crm",
+    "mail",
+    "scheduling",
+    "support"
+  ]
+}