@jchat/create-addon 1.0.0-alpha.3 → 1.0.0-alpha.31

package/CHANGELOG.md

@@ -1,5 +1,198 @@
 # @jchat/create-addon
 
+## 1.0.0-alpha.31
+
+### Patch Changes
+
+- Update addon test template for mandatory English and optional host translations
+
+- Update addon scaffolding templates to import UI and icons from @jchat/addon-sdk/ui
+
+- Upgrade package type-checking to native bun check for faster validation
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.31`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.31)
+
+## 1.0.0-alpha.30
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.30`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.30)
+
+## 1.0.0-alpha.29
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.29`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.29)
+
+## 1.0.0-alpha.28
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.28`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.28)
+
+## 1.0.0-alpha.27
+
+### Patch Changes
+
+- Standardize runtime environment access to Bun.env
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.27`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.27)
+
+## 1.0.0-alpha.26
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.26`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.26)
+
+## 1.0.0-alpha.25
+
+### Patch Changes
+
+- Update addon sandbox docker compose template
+
+- Update package metadata, documentation, and license links
+
+- Update sandbox development environment templates
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.25`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.25)
+
+## 1.0.0-alpha.24
+
+### Minor Changes
+
+- Add addon logo validation, database schema, scaffolding, and UI card rendering
+
+### Patch Changes
+
+- Update default service and documentation domains to jchatcloud.com
+
+- Update package repository URLs to jarvistack organization
+
+- Improve code formatting and style consistency
+
+- Refactor add-on scaffolder into modular template providers and orchestrator
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.24`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.24)
+
+## 1.0.0-alpha.23
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.23`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.23)
+
+## 1.0.0-alpha.22
+
+### Patch Changes
+
+- Update addon scaffolding templates to snake_case database conventions
+
+  - Update default database migration templates to snake_case naming conventions
+  - Update default service and documentation domains to jchatplatform.com
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.22`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.22)
+
+## 1.0.0-alpha.21
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.21`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.21)
+
+## 1.0.0-alpha.20
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.20`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.20)
+
+## 1.0.0-alpha.19
+
+### Patch Changes
+
+- Bumped `@jchat/*` dependencies:
+  - [`addon-sdk@1.0.0-alpha.19`](https://github.com/jchatcloud/jchat/releases/tag/addon-sdk@v1.0.0-alpha.19)
+
+## 1.0.0-alpha.17
+
+### Patch Changes
+
+- Updated dependency `@jchat/addon-sdk` to `v1.0.0-alpha.17`
+
+## 1.0.0-alpha.16
+
+No changes in this release.
+
+## 1.0.0-alpha.15
+
+### Patch Changes
+
+- adba4c7: Remove redundant `prepack` build lifecycle scripts across addon development and runtime packages to eliminate concurrent build race conditions during publication.
+
+## 1.0.0-alpha.14
+
+No changes in this release.
+
+## 1.0.0-alpha.13
+
+No changes in this release.
+
+## 1.0.0-alpha.12
+
+### Patch Changes
+
+- 3d4d0ad: - Add interactive terminal UI powered by `@clack/prompts` with automatic TTY detection and positional argument support
+  - Add full-stack addon template scaffolding with Elysia API router, Kysely database schema, SQL migrations, and custom permission definitions
+  - Add multi-mountpoint support with dynamic UI rendering and directional RTL/LTR styles
+  - Expand locale scaffolding to all 20 host languages with 100% key parity and automated synchronization testing
+  - Strongly type `MountPoint` and `MOUNT_POINTS` contracts across generator and CLI interfaces
+  - Bundle contracts inline in `@jchat/create-addon` for standalone, zero-dependency CLI execution
+  - Export `./contracts` subpath from `@jchat/addon-sdk` for lightweight, framework-agnostic contract imports
+- 7b86222: Add official customer-facing Agent Skills for JChat addon development and creation. Bundles `@jchat/addon-sdk` skills (`jchat-addon-development` and `create-jchat-addon`) for AI coding assistants and automatically scaffolds in-workspace skills when creating new addon projects.
+
+## 1.0.0-alpha.11
+
+## 1.0.0-alpha.10
+
+## 1.0.0-alpha.9
+
+## 1.0.0-alpha.8
+
+## 1.0.0-alpha.7
+
+### Minor Changes
+
+- 7cef24c: - Enhance addon package diagnostics with semantic version compatibility validation for JChat host and Addon SDK
+  - Add support for local workspace development, sandbox test harnesses, and distribution packaging
+  - Improve runtime license verification and multi-environment path resolution
+  - Update addon generator templates with 20-language i18n support, standard scripts, and type definitions
+
+## 1.0.0-alpha.6
+
+## 1.0.0-alpha.5
+
+### Patch Changes
+
+- 9755c28: Export curated UI components, types, and Tailwind styles from `@jchat/addon-sdk/ui` (`@jchat/addon-sdk/ui/tailwind.css`) for sandbox and third-party addon developers.
+- 8b8297f: Rename package from `create-jchat-addon` to `@jchat/create-addon` and update binary script to `create-addon`.
+- 5bbb2b6: Inherit jchatVersion and addonSdkVersion directly from @jchat/create-addon package version when generating standalone devkit.
+
+## 1.0.0-alpha.4
+
+### Patch Changes
+
+- 8b8297f: Rename package from `create-jchat-addon` to `@jchat/create-addon` and update binary script to `create-addon`.
+- 5bbb2b6: Inherit jchatVersion and addonSdkVersion directly from @jchat/create-addon package version when generating standalone devkit.
+
 ## 1.0.0-alpha.3
 
 ## 1.0.0-alpha.2

package/LICENSE

@@ -1,201 +1,23 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
+CUSTOM COMMERCIAL END USER LICENSE AGREEMENT (EULA)
 
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+Copyright (c) 2026 Jchat Cloud. All rights reserved.
 
-   1. Definitions.
+1. DEFINITIONS
+"Software" refers to this npm package and its source code.
+"Authorized Application" refers strictly to the application known as "JChat".
 
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
+2. LICENSE GRANT
+Subject to the terms of this Agreement and payment of any applicable fees, the 
+Licensor grants you a non-exclusive, non-transferable, revocable license to 
+download, install, and use the Software.
 
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
+3. RESTRICTIONS ON USE
+You are expressly prohibited from using this Software, in whole or in part, 
+in any application, product, or service other than the Authorized Application (JChat). 
+Any deployment, linking, execution, or inclusion of this Software into an 
+application that is not JChat constitutes a breach of this contract and 
+an infringement of copyright law.
 
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright 2026 Md. Jabarullah
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+4. NO REDISTRIBUTION
+You may not sub-license, rent, lease, or publicly redistribute this Software 
+to any third party without explicit written consent from the Licensor.

package/README.md

@@ -1,39 +1,210 @@
 # @jchat/create-addon
 
-A CLI tool for generating a self-contained JChat addon development workspace.
+Official CLI scaffolding tool for generating self-contained [JChat](https://jchatcloud.com) addon development workspaces and interactive sandbox environments.
 
-## Usage
+---
 
-Generate a new addon workspace:
+## Quick Start
+
+### 1. Interactive Scaffolding (Recommended)
+
+Run without flags in a terminal for an interactive, guided setup powered by `@clack/prompts`:
+
+```bash
+bunx @jchat/create-addon
+```
+
+The interactive wizard will guide you through:
+
+1. **Addon ID**: URL-friendly slug (e.g., `poll-manager`).
+2. **Display Name**: Human-readable name (e.g., `Poll Manager`).
+3. **Template**: Full-Stack (UI + Backend API + DB) or Frontend Only.
+4. **Mount Points**: Where the addon attaches in the host UI.
+5. **Target Environment**: Standalone DevKit (Docker Sandbox) or Monorepo Workspace.
+
+---
+
+### 2. Non-Interactive / Scripted
+
+Scaffold immediately by providing flags:
+
+```bash
+# Standalone DevKit with full-stack template
+bunx @jchat/create-addon poll-manager --template=fullstack --name="Poll Manager"
+
+# Inside the JChat monorepo (outputs to addons/poll-manager)
+bunx @jchat/create-addon poll-manager --workspace --template=fullstack
+```
+
+---
+
+## Development Workflows
+
+### Standalone DevKit (Independent Repository)
+
+When building an addon outside the JChat core monorepo, `@jchat/create-addon` scaffolds a complete DevKit featuring an isolated containerized sandbox (PostgreSQL 18, Redis 8, HTTP Mock server, and JChat sandbox runtime):
 
 ```bash
-bunx @jchat/create-addon <addon-id>
+cd poll-manager
+
+# 1. Initialize environment config
+cp .env.example .env
+
+# 2. Install dependencies
+bun install
+
+# 3. Start the local sandbox container environment
+bun sandbox
 ```
 
-### Options
+#### Standalone DevKit Automation Scripts
+
+| Command               | Description                                                                 |
+| :-------------------- | :-------------------------------------------------------------------------- |
+| `bun sandbox`         | Boots Docker/Podman sandbox with live reload, database, and HTTP mock proxy |
+| `bun sandbox:test`    | Executes integration and unit tests within the sandbox container            |
+| `bun sandbox:package` | Builds and packages the addon into a redistributable `.zip` archive         |
+| `bun sandbox:reset`   | Resets database fixtures and clears sandbox upload storage                  |
+| `bun sandbox:cleanup` | Stops and removes all sandbox containers and networks                       |
+
+---
 
-- `<addon-id>`: (Required) The unique ID for your addon, typically hyphenated (e.g., `weather-addon`).
-- `--target=<directory>`: (Optional) The directory to generate the workspace in. Defaults to `../<addon-id>` relative to the current working directory.
-- `--image=<image>`: (Optional) A specific Docker image to use for the sandbox environment. Defaults to `ghcr.io/mjjabarullah/addon-developer-sandbox`.
+### Monorepo Workspace (`--workspace`)
 
-### Example
+When developing locally inside the JChat monorepo:
 
 ```bash
-bunx @jchat/create-addon my-addon
-cd my-addon
+# Scaffold into addons/<addon-id>
+bunx @jchat/create-addon my-addon --workspace
+
+# Start live development with hot reload
+cd addons/my-addon
+bun dev
+```
+
+#### Addon Workspace Scripts
+
+| Command         | Description                                                         |
+| :-------------- | :------------------------------------------------------------------ |
+| `bun dev`       | Starts `jchat-addon dev` with fast HMR                              |
+| `bun build`     | Runs typechecking (`tsc --noEmit`) and compiles `jchat-addon build` |
+| `bun test`      | Runs Bun unit tests and verifies 20-language translation parity     |
+| `bun typecheck` | Validates TypeScript contracts without emitting output              |
+
+---
+
+## Workspace Structure
+
+### Full-Stack Addon Template (`--template=fullstack`)
+
+```text
+my-addon/
+├── addon/
+│   ├── migrations/
+│   │   └── 001_initial.sql          # Kysely/SQL database schema migrations
+│   ├── src/
+│   │   ├── locales/                 # All 20 host languages
+│   │   │   ├── en.json
+│   │   │   ├── ... (20 languages)
+│   │   │   └── index.ts
+│   │   ├── locales.test.ts          # Key-parity tests across all 20 languages
+│   │   ├── api.ts                   # Backend ElysiaJS routes & business logic
+│   │   ├── db.ts                    # Kysely database helper & typed tables
+│   │   ├── manifest.ts              # Addon permissions, metadata & mount points
+│   │   ├── tailwind.css             # Scoped Tailwind CSS v4 styling
+│   │   └── ui.tsx                   # Frontend React UI component
+│   ├── package.json
+│   └── tsconfig.json
+├── .agents/
+│   └── skills/
+│       └── jchat-addon-development/ # AI pair-programming skill for the addon
+├── .env.example                     # Sandbox configuration & ports
+├── docker-compose.yml               # Containerized PostgreSQL 18, Redis 8 & sandbox
+├── package.json                     # DevKit root lifecycle scripts
+├── README.md                        # Project documentation
+└── scripts/
+    └── devkit.ts                    # Standalone sandbox orchestrator
 ```
 
-## Requirements
+### Frontend-Only Addon Template (`--template=ui`)
+
+Lightweight UI-only extension without server routes or database tables:
+
+```text
+my-addon/
+├── addon/
+│   ├── src/
+│   │   ├── locales/                 # 20 host language translations
+│   │   ├── locales.test.ts          # Key parity test
+│   │   ├── manifest.ts              # Client mount points & metadata
+│   │   ├── tailwind.css             # Scoped Tailwind CSS
+│   │   └── ui.tsx                   # React UI component
+│   ├── package.json
+│   └── tsconfig.json
+├── docker-compose.yml
+└── package.json
+```
+
+---
+
+## CLI Flags & Options
+
+| Option                   | Description                                                                                | Default                            |
+| :----------------------- | :----------------------------------------------------------------------------------------- | :--------------------------------- |
+| `<addon-id>`             | Addon identifier (lowercase letters, numbers, hyphens). Prompted interactively if omitted. | —                                  |
+| `--target=<dir>`         | Output directory for the scaffolded project.                                               | `./<addon-id>`                     |
+| `--template=<type>`      | Addon template type: `fullstack` (UI + API + DB) or `ui` (Frontend only).                  | `fullstack`                        |
+| `--mount-points=<p1,p2>` | Comma-separated list of UI mount points (see below).                                       | `chat:toolbar,chat:plus-menu`      |
+| `--name=<displayName>`   | Human-readable display name for the addon (e.g. `--name="Poll Manager"`).                  | Auto-derived from `<addon-id>`     |
+| `--workspace`            | Target monorepo workspace mode (scaffolds to `addons/<addon-id>`).                         | `false`                            |
+| `--image=<image>`        | Custom container image for the JChat sandbox runtime.                                      | `ghcr.io/jchatcloud/jchat-sandbox` |
+| `--help`, `-h`           | Display CLI usage and options.                                                             | —                                  |
+
+---
+
+## Supported Mount Points
+
+Addons mount into specific extension slots across the host application:
+
+| Mount Point                | Description                                                 |
+| :------------------------- | :---------------------------------------------------------- |
+| `chat:toolbar`             | Header toolbar button in the active room                    |
+| `chat:plus-menu`           | Action item inside the message composer plus (`+`) menu     |
+| `chat:sidebar`             | Right-hand widget panel in chat                             |
+| `addon:settings`           | Addon configuration panel in site administration dashboard  |
+| `owner:settings`           | Addon configuration panel in owner administration dashboard |
+| `emoji-picker:gif-tab`     | Custom tab inside the chat emoji / GIF picker panel         |
+| `emoji-picker:sticker-tab` | Custom tab inside the chat sticker picker panel             |
+
+---
+
+## Addon SDK Subpath Architecture
+
+Generated addons import exclusively from `@jchat/addon-sdk` subpaths:
+
+- **`@jchat/addon-sdk`**: Manifest definitions, backend Elysia server utilities, permissions, contracts, and lifecycle types.
+- **`@jchat/addon-sdk/ui`**: Base UI component library, design tokens, unified `toast` notifications, and icons (`import { Button, Icons, toast } from "@jchat/addon-sdk/ui"`).
+- **`@jchat/addon-sdk/state`**: Shared atomic state powered by Jotai (`import { atom, useAtom } from "@jchat/addon-sdk/state"`).
+
+---
+
+## 20-Language Localization Out of the Box
+
+All scaffolded addons automatically include string definitions for all 20 host languages supported by JChat:
+
+`ar`, `bg`, `de`, `el`, `en`, `es`, `fr`, `he`, `hi`, `hr`, `kn`, `ml`, `nl`, `pt`, `ro`, `ru`, `ta`, `te`, `tr`, `ur`
+
+A built-in test (`src/locales.test.ts`) verifies 100% key parity across all languages on every `bun test`.
+
+---
+
+## Prerequisites
 
-- Bun 1.3+
-- Docker
+- **Bun**: 1.4.0+
+- **Docker** or **Podman**: Required for running the local standalone sandbox environment (`bun sandbox`).
 
-## Licensing
+---
 
-The creator package and JChat-authored template material are licensed under Apache License 2.0.
-You retain ownership of the original code and content you add to a generated project and may choose
-the license for that original work. Any JChat-authored template portions and third-party components
-remain subject to their respective licenses and notices.
+## License
 
-The generated developer sandbox does not grant a production JChat license. Production use remains
-subject to the applicable JChat and addon marketplace terms.
+Proprietary — All rights reserved. See the [Commercial EULA & Licensing Terms](https://jchatcloud.com/terms) for full details.

package/dist/cli.d.mts

@@ -1,10 +1,17 @@
+import { r as MountPoint } from "./contracts2.mjs";
+import { t as AddonTemplateType } from "./generator.mjs";
 //#region src/cli.d.ts
-interface CreatorArguments {
+export interface CreatorArguments {
   addonId: string;
   targetDir: string;
   sandboxImage?: string;
+  workspace?: boolean;
+  template?: AddonTemplateType;
+  mountPoints?: MountPoint[];
+  displayName?: string;
 }
-declare function parseCreatorArguments(arguments_: readonly string[]): CreatorArguments;
-declare function runCreator(arguments_: readonly string[]): Promise<string>;
-//#endregion
-export { CreatorArguments, parseCreatorArguments, runCreator };
+export declare function parseCreatorArguments(arguments_: readonly string[]): CreatorArguments;
+export declare function isInsideJChatMonorepo(): boolean;
+export declare function promptInteractiveOptions(initialAddonId?: string): Promise<CreatorArguments>;
+export declare function runCreator(arguments_: readonly string[]): Promise<string>;
+//#endregion