@myriadcodelabs/design-canvas-mcp 0.0.0-stage → 0.1.3-alpha.1

package/LICENSE

@@ -0,0 +1,23 @@
+Design Canvas Proprietary License
+
+Copyright (c) 2026 Muhammad Ismail Khan / MyriadCodeLabs. All rights reserved.
+
+Design Canvas MCP and its core application, runtime, orchestration, workspace implementation, and other proprietary components (the "Software") are proprietary software.
+
+Subject to any separate written agreement with the copyright holder, you are granted a limited, non-exclusive, non-transferable, revocable license to install and run official distributions of the Software solely for evaluation, beta testing, internal development, or other use expressly authorized by the copyright holder or an applicable subscription, entitlement, or commercial plan.
+
+You may not, except to the extent a restriction is prohibited by applicable law: (a) copy or redistribute the Software other than as necessary for authorized installation or backup; (b) modify, adapt, translate, create derivative works from, decompile, disassemble, reverse engineer, or otherwise attempt to derive the source code or internal implementation of the Software; (c) bypass, disable, tamper with, or circumvent licensing, entitlement, access-control, usage-limit, or technical-protection mechanisms; (d) sublicense, sell, rent, lease, host, or provide the Software to third parties as a competing or substitute product; or (e) remove proprietary notices.
+
+All title, ownership, intellectual-property rights, and rights not expressly granted remain with the copyright holder.
+
+Generated project output and separately licensed integration packages may be governed by additional permissions or separate licenses described in LICENSING.md and the LICENSES directory. Third-party software, libraries, assets, fonts, models, and other materials remain subject to their respective licenses.
+
+Beta, preview, and evaluation releases may be changed, limited, suspended, or discontinued at any time and may require a valid entitlement to continue operating. No license is granted to obtain source code merely because an executable or npm package is publicly downloadable.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT, TO THE MAXIMUM EXTENT PERMITTED BY LAW.
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE COPYRIGHT HOLDER SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR LOSS OF DATA, PROFITS, REVENUE, BUSINESS, OR GOODWILL, ARISING FROM OR RELATED TO THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+Any rights granted under this license terminate automatically upon material breach. Upon termination, you must cease use of the Software, except that user-owned project data and generated output remain subject to their applicable rights and licenses.
+
+Separate commercial or enterprise terms may supersede this license where expressly agreed in writing.

package/LICENSING.md

@@ -0,0 +1,29 @@
+# Licensing
+
+Design Canvas MCP uses a proprietary core with permissive boundaries for interoperability and generated output.
+
+## Proprietary core
+
+Except where a package or file says otherwise, the Design Canvas application, runtime, orchestration, workspace implementation, and other core code are proprietary and governed by the root `LICENSE`.
+
+Public npm distributions are executable/product distributions, not source-code grants. Beta, preview, commercial, and enterprise access may additionally depend on an entitlement, subscription, or separate written agreement.
+
+## Permissive integration boundary
+
+`packages/design-contract` remains licensed under **Apache-2.0**.
+
+Future packages whose primary purpose is third-party interoperability—such as public SDKs, protocol/contract packages, client libraries, and plugin API contracts—should default to Apache-2.0 unless there is a specific reason not to.
+
+Independent software may communicate with Design Canvas over MCP, HTTP/SSE, or another documented network or data boundary without acquiring rights in the proprietary core. See `LICENSES/Integration-Permission.txt`.
+
+## Generated project output
+
+Generated applications are intentionally usable in proprietary, commercial, open-source, and internal projects.
+
+To the extent the Design Canvas copyright holder owns copyright in Design Canvas-authored material included in generated project output, recipients may use that material under **MIT or Apache-2.0, at their option**, as described in `LICENSES/Generated-Output-Permission.txt`.
+
+Third-party code, dependencies, assets, fonts, models, libraries, and other materials remain governed by their own licenses.
+
+## Scope
+
+The integration and generated-output grants do not license, disclose, or permit copying, modification, redistribution, reverse engineering, or circumvention of the proprietary Design Canvas core except as expressly allowed by the root `LICENSE`, a separate package license, a written agreement, or applicable law.

package/README.md

@@ -1,3 +1,157 @@
-# Temporary Holding Version
+# Design Canvas MCP
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**An MCP-native visual workspace for AI-generated application design.**
+
+Design Canvas lets coding agents generate and modify real frontend source code while you inspect, compare, and interact with the result on an infinite canvas.
+
+There is no traditional drag-and-drop editor. The **agent edits the source**; the canvas is the visual reasoning and evaluation surface.
+
+## What it does
+
+- Creates a framework-neutral project workspace with stable `src/ports` and `src/adapters/mock` integration seams.
+- Lets agents replace that source and configure a framework-neutral preview runtime.
+- Exposes project, design, and runtime-configuration operations through MCP.
+- Renders the real application in interactive browser frames.
+- Lets you organize screens as Pages.
+- Lets you explore project-wide alternative UI approaches as Design Directions.
+- Lets you inspect the same page at different viewports and mock scenarios.
+- Keeps the generated application source as the canonical source of truth.
+
+## The basic loop
+
+```text
+Coding agent
+    ↓ MCP
+Design Canvas
+    ↓
+real application source
+    ↓
+configured local preview runtime
+    ↓
+you compare, interact, and give feedback
+    ↓
+agent updates the source
+```
+
+## Current capabilities
+
+- Infinite canvas with pan, zoom, frame movement, and fit controls.
+- Real interactive iframe previews backed by a per-project command runtime configured in `.design/runtime.json`.
+- Pages with real application routes.
+- Project-wide Design Directions for alternative UI/UX implementations.
+- Responsive inspection through multiple viewports.
+- Mock scenarios for alternate data/UI states.
+- Interact mode for testing the generated application's real controls and navigation.
+- Undo/redo for canvas design mutations.
+- Persistent local project registry and `.design/project.json` state.
+- Project file read/write/delete operations through MCP.
+
+## Quick start
+
+Run the published package directly:
+
+```bash
+npx @myriadcodelabs/design-canvas-mcp
+```
+
+Or run from source. Requirements: Node.js 24+ and pnpm.
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Open:
+
+```text
+http://127.0.0.1:3000
+```
+
+The built-in MCP endpoint is:
+
+```text
+http://127.0.0.1:3000/api/mcp
+```
+
+## Use it with a coding agent
+
+1. Keep Design Canvas running with the `npx` command above.
+2. Open `http://127.0.0.1:3000` in your browser.
+3. Add this MCP server to your coding agent/client as an HTTP MCP endpoint:
+
+   ```text
+   http://127.0.0.1:3000/api/mcp
+   ```
+
+4. Ask the agent to build the UI through the Design Canvas MCP tools. You do not need to create the project structure manually; tell the agent what you want and which framework or runtime you prefer, if any.
+5. In Design Canvas, open the project created by the agent and press **Start preview** when you want to run the generated application.
+
+For example, after the MCP server is connected, you can tell your agent:
+
+> Use the Design Canvas MCP tools to create a modern SaaS dashboard in Svelte with a sidebar, analytics overview, customers page, and settings page. Configure the runtime so I can preview it in Design Canvas. Create useful mock data and the main application flows as well.
+
+The agent can create the project, write and modify its files, choose or follow the requested framework, configure the local preview runtime, and define the Design Canvas pages, views, directions, scenarios, and flows. The quality of the generated application depends primarily on how clearly you describe the product, UI, behavior, and constraints to the coding agent.
+
+You can continue iterating in the same way: describe the change you want and ask the agent to make it through the Design Canvas MCP tools, then inspect the result on the canvas.
+
+## MCP tools
+
+The built-in MCP is standalone for Design Canvas projects: agents can create projects, edit project-scoped source files, configure preview runtimes, and manage design metadata without a separate filesystem MCP.
+
+**Projects and runtime**
+- `create_project`, `list_projects`, `get_project`
+- `get_project_runtime_config`, `configure_project_runtime`
+
+**Project files**
+- `list_project_files`, `read_project_file`
+- `write_project_file`, `write_project_binary_file`, `delete_project_file`
+
+**Design model**
+- `get_design`
+- `create_design_page`, `update_design_page`
+- `create_design_direction`, `rename_design_direction`, `remove_design_direction`
+- `list_design_views`, `get_design_view`, `create_design_view`, `update_design_view`, `duplicate_design_view`, `remove_design_view`
+- `upsert_design_scenario`, `remove_design_scenario`
+- `upsert_design_port`, `remove_design_port`
+
+Runtime configuration is agent-accessible, but process start/stop is intentionally controlled by the canvas **Start preview** lifecycle rather than MCP tools.
+
+## Frameworks and preview runtime
+
+Design Canvas does not choose the frontend framework. New projects contain only the portable source seams declared by `sourceTopology` (`src/ports` and `src/adapters/mock` by default). The coding agent builds the framework-native UI around those seams and configures `.design/runtime.json` with `prepare` and `start` commands, using `{{host}}` and `{{port}}` supplied by Design Canvas. The runtime is only started when the user presses **Start preview** in the canvas.
+
+## How projects are modeled
+
+- **Page** — a real application destination/route.
+- **Design Direction** — a coherent alternative UI/UX approach across the project.
+- **Scenario** — a mock/data state.
+- **View** — one Page + Design Direction + Scenario + Viewport shown on the canvas.
+
+Design Directions are not themes. A direction may change layout, hierarchy, navigation presentation, component structure, responsive strategy, and interaction presentation while preserving the same product meaning and routes.
+
+## Repository structure
+
+```text
+apps/web                  Next.js UI, HTTP, SSE, and MCP
+packages/design-contract  portable framework-neutral contracts
+packages/project-system   project/design orchestration, source-architecture scaffolding, and preview runtime
+packages/project-workspace project-scoped filesystem implementation
+```
+
+## Licensing
+
+Design Canvas MCP uses a proprietary-core licensing model:
+
+- Core application/runtime/orchestration code: **proprietary** under the root `LICENSE`.
+- Public npm packages are product distributions and do **not** grant access to the source code.
+- `packages/design-contract`: **Apache-2.0**.
+- Independent MCP/HTTP clients remain independently licensable.
+- Design Canvas-authored generated output may be used under **MIT or Apache-2.0**, at the recipient's option.
+
+Generated applications can therefore remain proprietary, commercial, internal, or open source. Third-party dependencies and assets keep their own licenses.
+
+See [`LICENSING.md`](./LICENSING.md) for the exact boundaries.
+
+## Contributing
+
+Issues, UX feedback, architecture proposals, performance findings, and integration ideas are welcome. Core source-code contributions are not currently being accepted; see [`CONTRIBUTING.md`](./CONTRIBUTING.md).

package/app/apps/web/.next/BUILD_ID

@@ -0,0 +1 @@
+7RgON_D47WE7YuQtrx8tq

package/app/apps/web/.next/app-path-routes-manifest.json

@@ -0,0 +1,13 @@
+{
+  "/_global-error/page": "/_global-error",
+  "/_not-found/page": "/_not-found",
+  "/api/mcp/route": "/api/mcp",
+  "/api/projects/[projectId]/design/route": "/api/projects/[projectId]/design",
+  "/api/projects/[projectId]/events/route": "/api/projects/[projectId]/events",
+  "/api/projects/[projectId]/files/route": "/api/projects/[projectId]/files",
+  "/api/projects/[projectId]/route": "/api/projects/[projectId]",
+  "/api/projects/[projectId]/runtime/route": "/api/projects/[projectId]/runtime",
+  "/api/projects/route": "/api/projects",
+  "/page": "/",
+  "/projects/[projectId]/page": "/projects/[projectId]"
+}

package/app/apps/web/.next/build-manifest.json

@@ -0,0 +1,24 @@
+{
+  "pages": {
+    "/_app": []
+  },
+  "devFiles": [],
+  "polyfillFiles": [
+    "static/chunks/0cz1d0mv5g_q7.js"
+  ],
+  "lowPriorityFiles": [
+    "static/7RgON_D47WE7YuQtrx8tq/_buildManifest.js",
+    "static/7RgON_D47WE7YuQtrx8tq/_ssgManifest.js",
+    "static/7RgON_D47WE7YuQtrx8tq/_clientMiddlewareManifest.js"
+  ],
+  "rootMainFiles": [
+    "static/chunks/05jnod8ocrwe7.js",
+    "static/chunks/2-aahqpvgdov9.js",
+    "static/chunks/0vozrnahdfgbf.js",
+    "static/chunks/31zxjy4pob2oc.js",
+    "static/chunks/turbopack-14atkd0jptfjs.js"
+  ],
+  "rootMainFilesTree": {},
+  "pagesChunkGroupBootstrapParams": {},
+  "chunkLoadingGlobal": "TURBOPACK"
+}

package/app/apps/web/.next/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/app/apps/web/.next/prerender-manifest.json

@@ -0,0 +1,97 @@
+{
+  "version": 4,
+  "routes": {
+    "/": {
+      "routeType": "page",
+      "response": "complete",
+      "compute": "static",
+      "htmlSize": 5814,
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/",
+      "dataRoute": "/index.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/_global-error": {
+      "routeType": "page",
+      "response": "complete",
+      "compute": "static",
+      "htmlSize": 8745,
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_global-error",
+      "dataRoute": "/_global-error.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/_not-found": {
+      "initialStatus": 404,
+      "routeType": "page",
+      "response": "complete",
+      "compute": "static",
+      "htmlSize": 7667,
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_not-found",
+      "dataRoute": "/_not-found.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    }
+  },
+  "dynamicRoutes": {},
+  "notFoundRoutes": [],
+  "preview": {
+    "previewModeId": "68b23e1e60b78a201b9f335f6a5d0a4d",
+    "previewModeSigningKey": "508758035c25c43ca45b0afe95a679dffeb257f5f97208a84b2c7a5c8f1f5b48",
+    "previewModeEncryptionKey": "c36ffd0d5d7bad2c41b1822c73cff6d74b64c7ee72da5d9ddbb806b5d57016c1"
+  }
+}