create-cordisx-plugin 0.1.0-beta.0 → 0.1.0-beta.1

package/README.md

@@ -11,10 +11,20 @@ npx create-cordisx-plugin@beta my-plugin
 The `@beta` qualifier is required while npm `latest` remains the non-functional
 `0.0.0` package-name reservation.
 
-The generated project includes a version-1 manifest exported from its entry,
-structured UI contribution, TypeScript build, manifest test, and
-`cordisx dev --dry-run` script. It does not install to a marketplace, sign the
-plugin, provide a permission sandbox, or promise hot reload.
+The generated project includes a version-1 manifest, a structured toolbar
+route, a React page body, TypeScript build, manifest test, and
+`cordisx dev --dry-run` script. The plugin installs only `cordisx`: React,
+React DOM, their types, JSX runtimes, and the initial CordisX component set are
+provided by the Host through `cordisx/react` and `cordisx/ui`. Plugin artifacts
+that bundle a private React copy are rejected.
+
+The generated route and page use closed route-v2/page-v3 documents with real
+localized title and description dictionaries. Canonical ids, path, outlet,
+params, and chrome remain untranslated machine fields. CordisX owns route and
+page chrome, the React root, theme, error boundary, and lifecycle cleanup; the
+plugin owns only the controlled body component. The generator does not install
+to a marketplace, sign the plugin, provide a permission sandbox, or promise
+hot reload.
 
 The `create-cordisx-plugin` tool itself is licensed under
 `AGPL-3.0-or-later`. Files under its marked `template` directory and projects

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-cordisx-plugin",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.1",
   "description": "Create a minimal CordisX plugin project",
   "type": "module",
   "files": [

package/template/README.md

@@ -1,7 +1,7 @@
 # {{packageName}}
 
-A minimal trusted-local CordisX plugin. Its manifest is exported from
-`src/{{pluginId}}.ts`, which is also the runtime entry used by CordisX.
+A minimal trusted-local CordisX React plugin. Its manifest is exported from
+`src/{{pluginId}}.tsx`, which is also the runtime entry used by CordisX.
 
 ```bash
 npm install
@@ -13,9 +13,17 @@ npm run dev
 `npm run dev:dry-run` bundles the plugin without launching Codex Desktop.
 `npm run dev` launches the separate CordisX development host.
 
-The template intentionally requests no platform capabilities. It contributes
-structured data to a host-owned toolbar surface and does not depend on a
-marketplace, signing, a permission sandbox, or hot module replacement.
+The template intentionally requests no platform capabilities. It contributes a
+structured toolbar route and a React page body. Import React from
+`cordisx/react` and components from `cordisx/ui`; do not install `react`,
+`react-dom`, React type packages, or a component library. CordisX supplies one
+Host React singleton and rejects a plugin artifact that bundles another copy.
+
+The route and page use closed route-v2/page-v3 documents with separate retained
+localized `title` and `description` messages. Path, outlet, page id, route id,
+params, and chrome remain untranslated. CordisX owns the route, page header,
+theme, error boundary, and React root cleanup; the plugin owns only the page
+body component. Plugins remain trusted local code, not sandboxed code.
 
 This generated project is Marked Template Material under the
 [CordisX Independent Plugin Exception](https://github.com/cordisx/cordisx/blob/main/CORDISX-INDEPENDENT-PLUGIN-EXCEPTION.md).

package/template/package.json

@@ -10,8 +10,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "npm run typecheck && npm run build && npm test",
-    "dev": "cordisx dev ./src/{{pluginId}}.ts",
-    "dev:dry-run": "cordisx dev ./src/{{pluginId}}.ts --dry-run",
+    "dev": "cordisx dev ./src/{{pluginId}}.tsx",
+    "dev:dry-run": "cordisx dev ./src/{{pluginId}}.tsx --dry-run",
     "test": "node --test test/manifest.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },

package/template/src/{{packageName}}.tsx

@@ -0,0 +1,107 @@
+import type { Context } from '@deepseek-ai/cordis'
+import { defineReactPage, useState } from 'cordisx/react'
+import { Button, Card, Heading, Stack, Text } from 'cordisx/ui'
+import {
+  CORDISX_PAGE_SCHEMA_V3,
+  CORDISX_PLUGIN_MANIFEST_SCHEMA_V1,
+  CORDISX_ROUTE_SCHEMA_V2,
+  type CordisXPluginManifestV1,
+} from 'cordisx/contracts'
+import type {} from 'cordisx/contracts'
+
+type Messages = {
+  'command.open': undefined
+  'page.title': undefined
+  'page.description': undefined
+  'route.title': undefined
+  'route.description': undefined
+  'counter.label': { count: number }
+}
+
+export const manifest = {
+  $schema: CORDISX_PLUGIN_MANIFEST_SCHEMA_V1,
+  schemaVersion: 1,
+  id: '{{pluginId}}',
+  name: '{{packageName}}',
+  capabilities: [],
+} as const satisfies CordisXPluginManifestV1
+
+export const inject = ['i18n', 'pages', 'routes', 'slots']
+
+const page = {
+  $schema: CORDISX_PAGE_SCHEMA_V3,
+  schemaVersion: 3,
+  id: 'overview',
+  title: { key: 'page.title', fallback: '{{packageName}}' },
+  description: { key: 'page.description', fallback: 'A React page rendered by the shared CordisX Host runtime.' },
+  icon: 'host:info',
+} as const
+
+const route = {
+  $schema: CORDISX_ROUTE_SCHEMA_V2,
+  schemaVersion: 2,
+  id: 'overview',
+  path: '/app/{{pluginId}}',
+  outlet: 'app',
+  page: 'overview',
+  title: { key: 'route.title', fallback: '{{packageName}}' },
+  description: { key: 'route.description', fallback: 'Open the plugin React example.' },
+} as const
+
+const mountOverview = defineReactPage<Messages>(({ t }) => {
+  const [count, setCount] = useState(0)
+  return (
+    <Stack gap="large">
+      <Heading>{t('page.title')}</Heading>
+      <Card>
+        <Stack gap="medium" align="flex-start">
+          <Text tone="muted">{t('page.description')}</Text>
+          <Button variant="primary" onClick={() => setCount(value => value + 1)}>
+            {t('counter.label', { count })}
+          </Button>
+        </Stack>
+      </Card>
+    </Stack>
+  )
+})
+
+export function apply(ctx: Context): void {
+  ctx.i18n.define<Messages>({
+    namespace: '{{pluginId}}',
+    locale: 'en',
+    default: true,
+    messages: {
+      'command.open': 'Open {{packageName}}',
+      'page.title': '{{packageName}}',
+      'page.description': 'This page uses the React singleton and components provided by CordisX.',
+      'route.title': '{{packageName}}',
+      'route.description': 'Open the plugin React example.',
+      'counter.label': 'Clicked {count, number} times',
+    },
+  })
+  ctx.i18n.define<Messages>({
+    namespace: '{{pluginId}}',
+    locale: 'zh-CN',
+    messages: {
+      'command.open': '打开 {{packageName}}',
+      'page.title': '{{packageName}}',
+      'page.description': '此页面复用 CordisX 提供的 React 单例与组件。',
+      'route.title': '{{packageName}}',
+      'route.description': '打开插件的 React 示例。',
+      'counter.label': '已点击 {count, number} 次',
+    },
+  })
+  ctx.pages.register<Messages>(page, mountOverview)
+  ctx.routes.register(route)
+  ctx.slots.register({
+    name: 'workspace.toolbar.items',
+    id: 'open',
+    order: 10,
+  }, {
+    anchor: 'workspace.primary',
+    placement: 'after',
+    label: { key: 'command.open', fallback: 'Open {{packageName}}' },
+    icon: 'host:open',
+    route: { id: 'overview' },
+  })
+}

package/template/test/manifest.mjs

@@ -6,6 +6,6 @@ test('exports a minimal CordisX plugin module', () => {
   assert.equal(manifest.schemaVersion, 1)
   assert.equal(manifest.id, '{{pluginId}}')
   assert.deepEqual(manifest.capabilities, [])
-  assert.deepEqual(inject, ['i18n', 'commands', 'slots'])
+  assert.deepEqual(inject, ['i18n', 'pages', 'routes', 'slots'])
   assert.equal(typeof apply, 'function')
 })

package/template/tsconfig.json

@@ -3,6 +3,8 @@
     "target": "ES2022",
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
+    "jsx": "react-jsx",
+    "jsxImportSource": "cordisx/react",
     "lib": ["ES2023", "DOM"],
     "rootDir": "src",
     "outDir": "dist",
@@ -11,6 +13,6 @@
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true
   },
-  "include": ["src/**/*.ts"],
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
   "exclude": ["dist", "node_modules"]
 }

package/template/src/{{packageName}}.ts

@@ -1,48 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis'
-import {
-  CORDISX_PLUGIN_MANIFEST_SCHEMA_V1,
-  type CordisXPluginManifestV1,
-} from 'cordisx/contracts'
-import type {} from 'cordisx/contracts'
-
-export const manifest = {
-  $schema: CORDISX_PLUGIN_MANIFEST_SCHEMA_V1,
-  schemaVersion: 1,
-  id: '{{pluginId}}',
-  name: '{{packageName}}',
-  capabilities: [],
-} as const satisfies CordisXPluginManifestV1
-
-export const inject = ['i18n', 'commands', 'slots']
-
-export function apply(ctx: Context): void {
-  ctx.i18n.define({
-    namespace: '{{pluginId}}',
-    locale: 'en',
-    default: true,
-    messages: { 'command.hello': 'Say hello from {{packageName}}' },
-  })
-  ctx.commands.register({
-    id: 'hello',
-    title: {
-      namespace: '{{pluginId}}',
-      key: 'command.hello',
-      fallback: 'Say hello from {{packageName}}',
-    },
-  }, () => console.info('[{{pluginId}}] hello'))
-  ctx.slots.register({
-    name: 'workspace.toolbar.items',
-    id: 'hello',
-    order: 10,
-  }, {
-    anchor: 'workspace.primary',
-    placement: 'after',
-    label: {
-      namespace: '{{pluginId}}',
-      key: 'command.hello',
-      fallback: 'Say hello from {{packageName}}',
-    },
-    icon: 'host:open',
-    command: { id: 'hello' },
-  })
-}