@rinova/playground 0.1.4 → 0.5.0

package/dist/types/components/PwDemoGrid.vue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 场景内 Demo 栅格。两种排法：
+ * - `columns` 固定列数（1–4），窄屏折成单列；
+ * - `min` 给每列最小宽度，放不下自动折行（优先于 columns）。
+ */
+type __VLS_Props = {
+    /** 固定列数，默认 1 */
+    columns?: 1 | 2 | 3 | 4;
+    /** 每列最小宽度（px）；大于 0 时改用 auto-fit，忽略 columns */
+    min?: number;
+    /** 间距，默认 md */
+    gap?: 'sm' | 'md' | 'lg';
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    columns: 1 | 2 | 3 | 4;
+    min: number;
+    gap: "md" | "sm" | "lg";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/PwInput.vue.d.ts

@@ -17,21 +17,21 @@ type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     focus: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string) => any;
-    keydown: (event: KeyboardEvent) => any;
-    focus: (event: FocusEvent) => any;
     blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
+    keydown: (event: KeyboardEvent) => any;
+    "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
-    onFocus?: ((event: FocusEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
     type: "number" | "text";
-    size: "sm" | "md";
+    autofocus: boolean;
+    size: "md" | "sm";
     modelValue: string;
     clearable: boolean;
-    autofocus: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/types/components/PwSceneBoundary.vue.d.ts

@@ -0,0 +1,20 @@
+/** 场景错误边界：一个场景抛错只替换这一块，整页与其它场景继续可用 */
+type __VLS_Props = {
+    title?: string;
+    file?: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/PwSceneNote.vue.d.ts

@@ -0,0 +1,19 @@
+/** 场景内说明块（引用样式） */
+type __VLS_Props = {
+    text?: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/PwTooltip.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/prose/PwCallout.vue.d.ts

@@ -0,0 +1,24 @@
+type __VLS_Props = {
+    /** 语义：info 说明 / tip 建议 / warn 警告 / danger 危险 */
+    tone?: 'info' | 'tip' | 'warn' | 'danger';
+    /** 小标题，留空则只有正文 */
+    title?: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    title: string;
+    tone: "info" | "tip" | "warn" | "danger";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/prose/PwMarkdown.vue.d.ts

@@ -0,0 +1,11 @@
+type __VLS_Props = {
+    /** Markdown 原文 */
+    source: string;
+    /** 正文宽度，默认 720px */
+    width?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    width: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/prose/PwProse.vue.d.ts

@@ -0,0 +1,27 @@
+type __VLS_Props = {
+    /** 大标题（可选，通常是页标题或场景标题） */
+    title?: string;
+    /** 标题下的一行引导语 */
+    lead?: string;
+    /** 正文宽度，默认 720px */
+    width?: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    title: string;
+    lead: string;
+    width: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/prose/PwStep.vue.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 单条步骤，放在 `PwSteps` 里使用；标题可选，正文走默认插槽。
+ */
+type __VLS_Props = {
+    /** 加粗的步骤标题 */
+    title?: string;
+    /** 步骤下的一句说明 */
+    description?: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    title: string;
+    description: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/prose/PwSteps.vue.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 步骤列表：按顺序讲一件事时用，序号由 CSS 计数器生成，增删条目不用改编号。
+ *
+ * Markdown 里写 `::: steps` + 有序列表，渲染出来是同一个组件。
+ */
+type __VLS_Props = {
+    /** 起始序号，默认 1 */
+    start?: number;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    start: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/prose/enhance.d.ts

@@ -0,0 +1,4 @@
+/** 增强 root 下所有还没处理过的代码块 */
+export declare const enhanceCodeBlocks: (root: HTMLElement | null) => Promise<void>;
+/** 复制按钮的点击：由容器统一代理（`v-html` 里的节点绑不了 Vue 事件） */
+export declare const handleCopyClick: (event: MouseEvent) => Promise<void>;

package/dist/types/components/prose/index.d.ts

@@ -0,0 +1,7 @@
+/** 文档排版能力：内容页（介绍 / 指南）里直接用，Markdown 场景内部也走同一套 */
+export { default as PwProse } from './PwProse.vue';
+export { default as PwCallout } from './PwCallout.vue';
+export { default as PwSteps } from './PwSteps.vue';
+export { default as PwStep } from './PwStep.vue';
+export { default as PwMarkdown } from './PwMarkdown.vue';
+export type { CalloutTone, MarkdownBlock } from './render';

package/dist/types/components/prose/markdown-scene.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 把一个 Markdown 场景包成组件：插件扫描到 `.md` 文件时调用。
+ *
+ * ```ts
+ * load: () => import('./guide.md?raw').then((mod) => ({ default: defineMarkdownScene(mod.default) }))
+ * ```
+ */
+export declare const defineMarkdownScene: (source: string) => import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/types/components/prose/parse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Markdown 解析（不依赖任何渲染库，会被 verify 直接单测）。
+ *
+ * 产物是「区块列表」：普通 Markdown、提示块、步骤块。
+ * 真正的 Markdown → HTML 交给 marked，见 `render.ts`。
+ */
+export type CalloutTone = 'info' | 'tip' | 'warn' | 'danger';
+export declare const TONE_LABEL: Record<CalloutTone, string>;
+export interface MarkdownBlockRaw {
+    kind: 'md' | 'callout' | 'steps';
+    tone?: CalloutTone;
+    title?: string;
+    text: string;
+}
+/** 去掉 `---` 头（内容由插件解析成 pageMeta / sceneMeta，渲染时不该出现） */
+export declare const stripFrontmatter: (source: string) => string;
+/** 极简 frontmatter 解析：`key: value` 与 `key: [a, b]`，够声明标题 / 排序 / 标签用 */
+export declare const parseFrontmatter: (source: string) => Record<string, string | string[]>;
+/** 把正文切成「普通 Markdown / 提示块 / 步骤块」，容器不支持嵌套 */
+export declare const splitBlocks: (body: string) => MarkdownBlockRaw[];

package/dist/types/components/prose/render.d.ts

@@ -0,0 +1,22 @@
+import { parseFrontmatter, type CalloutTone } from './parse';
+export type { CalloutTone } from './parse';
+export type MarkdownBlock = {
+    kind: 'html';
+    html: string;
+} | {
+    kind: 'callout';
+    tone: CalloutTone;
+    title: string;
+    html: string;
+} | {
+    kind: 'steps';
+    items: string[];
+};
+/**
+ * 把 Markdown 原文渲染成区块列表。
+ *
+ * 这里只做 Markdown → HTML；语法高亮、语言角标与复制按钮统一交给 `enhance.ts`
+ * （和手写内容页 `PwProse` 走同一段逻辑）。marked 按需加载，页面里没有 `.md` 场景时不会下载。
+ */
+export declare const renderMarkdown: (source: string) => Promise<MarkdownBlock[]>;
+export { parseFrontmatter };

package/dist/types/components/scene.d.ts

@@ -0,0 +1,5 @@
+/** 场景布局原语：一场景多 Demo 时用，未使用时场景就是普通 SFC */
+export { default as PwDemoGrid } from './PwDemoGrid.vue';
+export { default as PwDemo } from './PwDemo.vue';
+export { default as PwSceneNote } from './PwSceneNote.vue';
+export { default as PwApiBrief } from './PwApiBrief.vue';

package/dist/types/config.d.ts

@@ -1,6 +1,5 @@
 /** playground 的唯一配置入口。 */
 export type PlaygroundUiTheme = 'light' | 'dark' | 'auto';
-export type PlaygroundCodeViewer = 'monaco' | 'shiki';
 export interface PlaygroundConfig {
     /** 品牌标题，默认取 package.json 的 name */
     title?: string;
@@ -8,13 +7,15 @@ export interface PlaygroundConfig {
     scenes?: string;
     /** 是否展示源码面板，默认 true */
     sources?: boolean;
-    /** 代码区实现：可编辑编辑器 / 只读高亮块，默认 'monaco' */
-    codeViewer?: PlaygroundCodeViewer;
     theme?: {
         /** 外壳主题（12 个 CSS 变量），默认 'auto' */
         ui?: PlaygroundUiTheme;
-        /** 代码区 shiki 主题名，默认 'vitesse-dark' */
-        code?: string;
+        /**
+         * 演示画布主题，默认 'light'。
+         * 很多组件库只实现了浅色，画布固定浅色可以避免在暗色外壳里渲染成黑底黑字；
+         * 'auto' 表示跟随外壳。
+         */
+        stage?: PlaygroundUiTheme;
     };
     /** 扫描时排除的 glob（相对 scenes 根） */
     exclude?: string[];
@@ -30,7 +31,44 @@ export interface PlaygroundConfig {
     port?: number;
     /** 契约清单要扫描的组件 glob（如 src/components 下所有 .vue）；不配则不生成 manifest */
     components?: string[];
+    /**
+     * 非组件模块 glob（如 `src/lib/**` + `/*.ts`）：函数 / hooks / 常量的契约。
+     * 抽出来的内容进 API 页签的「函数 / 常量」表，并写进 manifest / llms.txt。
+     */
+    modules?: string[];
     /** 组件契约提取用的 tsconfig，默认项目根的 tsconfig.json */
     tsconfig?: string;
+    /**
+     * 供场景读取的纯常量（如 apiBase / appName）。
+     * ⚠️ 会明文进构建产物、任何人都能看到，禁止放 token / 密钥，这类值必须走插件运行时获取。
+     * 场景里用 `usePlaygroundEnv()` 读取；插件返回值会覆盖同名字段。
+     */
+    globals?: Record<string, unknown>;
+    /**
+     * 运行时插件模块路径，如 `['./src/playground/plugins.ts']`。
+     * 只接受路径而不是内联对象：配置会 `JSON.stringify` 进虚拟模块，函数无法序列化。
+     * 规则：`./x` 相对项目根；`/x` 与 `@/x` 原样交给 Vite。
+     */
+    plugins?: string[];
+    /**
+     * 分组（scenes 下的一级目录名）→ 侧栏显示名。
+     * 例如 `{ 'tao-common': 'Tao 通用组件' }`；不配时用目录名首字母大写化。
+     */
+    groups?: Record<string, string>;
+    /** 本地 IDE 打开：preset 决定用哪个编辑器的 URL scheme */
+    editor?: {
+        /** 'vscode' | 'cursor' | 'webstorm' | 'custom' */
+        preset?: 'vscode' | 'cursor' | 'webstorm' | 'custom';
+        /** preset = 'custom' 时的模板，支持 {file} / {line} */
+        custom?: string;
+        /** 是否把项目根绝对路径写进产物，默认 true；对外发布时设为 false（按钮降级为复制路径） */
+        exposeRoot?: boolean;
+        /** 访问者能否在按钮里自己换编辑器，默认 true */
+        allowChoice?: boolean;
+        /** 可选的编辑器列表，默认内置的常用几个（vscode/cursor/windsurf/trae/zed/webstorm/idea/sublime） */
+        options?: string[];
+        /** 是否允许访问者填自定义协议模板（任意 IDE），默认 true */
+        allowCustom?: boolean;
+    };
 }
 export declare const defineConfig: (config: PlaygroundConfig) => PlaygroundConfig;

package/dist/types/index.d.ts

@@ -1,14 +1,21 @@
 /// <reference path="./shims.d.ts" />
 export { defineConfig } from './config';
-export type { PlaygroundConfig, PlaygroundCodeViewer, PlaygroundUiTheme } from './config';
-export { defineSceneMeta } from './scene-meta';
-export type { SceneMeta } from './scene-meta';
-export type { SceneDescriptor } from './types';
+export type { PlaygroundConfig, PlaygroundUiTheme } from './config';
+export { defineSceneMeta, definePageMeta } from './scene-meta';
+export type { SceneMeta, PageMeta } from './scene-meta';
+export type { SceneDescriptor, PageDescriptor, SceneSection } from './types';
+export { PwDemoGrid, PwDemo, PwSceneNote, PwApiBrief } from './components/scene';
+export { PwProse, PwCallout, PwSteps, PwStep, PwMarkdown } from './components/prose';
+export type { CalloutTone, MarkdownBlock } from './components/prose';
+export { defineMarkdownScene } from './components/prose/markdown-scene';
 export { toast } from './components/toast';
-export { useSceneArgs, currentArgs } from './payload/args';
-export type { SceneArgs, SceneArgsOptions } from './payload/args';
-export { useSceneOutput, currentOutput } from './payload/output';
-export type { SceneSnapshot } from './payload/output';
+export { useSceneArgs, currentArgs, currentArgsSlots } from './payload/args';
+export type { SceneArgs, SceneArgsOptions, SceneArgsBinding } from './payload/args';
+export { useSceneOutput, currentOutput, currentOutputSlots } from './payload/output';
+export type { SceneSnapshot, SceneOutputBinding } from './payload/output';
+export { definePlaygroundPlugin } from './plugin';
+export type { PlaygroundPlugin, PlaygroundPluginContext, PlaygroundResolvedConfig, PlaygroundUiApi, PlaygroundUiOptions, PlaygroundPanelOptions, PlaygroundPanelHandle, } from './plugin';
+export { usePlaygroundEnv, usePlaygroundPlugin, usePlaygroundTheme, usePlaygroundUi, openPlaygroundPanel, closePlaygroundPanel, togglePlaygroundPanel, } from './plugin';
 export interface CreatePlaygroundOptions {
     /** 挂载点，默认 `#app` */
     el?: string | HTMLElement;

package/dist/types/module-api.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 非组件文件（纯函数 / hooks / 常量）的契约。
+ * 由 `@rinova/playground-vite` 用 TypeScript 编译器 API 抽取，写进 `.playground/manifest.json`；
+ * 这里的类型与 `packages/playground-vite/src/module-api.ts` 同构 —— manifest.json 就是那条契约。
+ */
+export interface ModuleParam {
+    name: string;
+    type: string;
+    optional: boolean;
+    /** 源码里的默认值原文，没有就是空串 */
+    default: string;
+    description: string;
+}
+export interface ModuleFunction {
+    name: string;
+    /** 名字以 use + 大写开头即为 hook */
+    kind: 'function' | 'hook';
+    /** `formatMoney(value: number, options?: FormatMoneyOptions): string` */
+    signature: string;
+    params: ModuleParam[];
+    returns: string;
+    description: string;
+    /** 有没有场景引用过这个名字 */
+    covered: boolean;
+    /** 引用过这个名字的场景 id */
+    coveredBy?: string[];
+}
+export interface ModuleConstant {
+    name: string;
+    type: string;
+    /** 短值直接给原文，长的留空 */
+    value: string;
+    description: string;
+    covered: boolean;
+    /** 引用过这个名字的场景 id */
+    coveredBy?: string[];
+}
+export interface ModuleType {
+    name: string;
+    kind: 'interface' | 'type';
+    file: string;
+    code: string;
+}
+export interface ModuleApi {
+    /** 文件名去掉扩展名，如 `money` */
+    name: string;
+    rel: string;
+    functions: ModuleFunction[];
+    constants: ModuleConstant[];
+    types: ModuleType[];
+    /** 引用了这个模块的场景 id */
+    scenes: string[];
+    /** 没有任何场景提到的导出名 */
+    uncovered: string[];
+}

package/dist/types/payload/args.d.ts

@@ -4,16 +4,35 @@ export interface SceneArgsOptions {
     options?: Record<string, Array<string | number>>;
     /** 字段标签，缺省用 key */
     labels?: Record<string, string>;
+    /**
+     * 槽位名。一个场景里多次调用 `useSceneArgs` 时，每块输入各占一个槽位，
+     * 面板按名字分块显示。只调用一次时可以省略。
+     */
+    slot?: string;
 }
 export interface SceneArgsBinding {
+    /** 槽位标识，缺省 `default` */
+    key: string;
+    /** 归属场景（页内多场景时只显示当前场景的槽位） */
+    sceneId: string;
+    /** 面板上显示的名字，等于 `options.slot` */
+    label: string;
     values: SceneArgs;
     defaults: SceneArgs;
     options: SceneArgsOptions;
 }
-/** 同一时刻只有一个场景挂载，所以只需要一个"当前入参"槽位 */
-export declare const currentArgs: import("vue").ShallowRef<SceneArgsBinding | null, SceneArgsBinding | null>;
+/** 当前场景挂载的全部输入槽位（同一时刻只有一个场景挂载） */
+export declare const currentArgsSlots: import("vue").ShallowRef<SceneArgsBinding[], SceneArgsBinding[]>;
+/** 兼容旧接口：第一个槽位 */
+export declare const currentArgs: import("vue").ComputedRef<SceneArgsBinding | null>;
 /**
- * 在场景的 `<script setup>` 里声明可变入参，返回响应式对象：
+ * 在场景的 `<script setup>` 里声明可变输入，返回响应式对象：
  * 面板改表单 → 这里同步变化 → 组件跟着重渲染。纯浏览器能力，生产环境同样可用。
+ *
+ * 一个场景里有多个 demo 时，各自调用一次并传 `slot` 区分：
+ * ```ts
+ * const primary = useSceneArgs({ size: 'md' }, { slot: '主按钮' })
+ * const ghost = useSceneArgs({ size: 'sm' }, { slot: '次按钮' })
+ * ```
  */
 export declare const useSceneArgs: <T extends SceneArgs>(defaults: T, options?: SceneArgsOptions) => T;

package/dist/types/payload/context.d.ts

@@ -0,0 +1,3 @@
+export declare const provideSceneContext: (name: string) => void;
+/** 不在场景里调用（例如自己在别处挂组件）时返回空串 */
+export declare const useSceneContext: () => string;

package/dist/types/payload/output.d.ts

@@ -1,4 +1,19 @@
 export type SceneSnapshot = Record<string, unknown>;
-/** 出参快照：由面板轮询调用，纯前端实现 */
-export declare const currentOutput: import("vue").ShallowRef<(() => SceneSnapshot) | null, (() => SceneSnapshot) | null>;
-export declare const useSceneOutput: (getter: () => SceneSnapshot) => void;
+export interface SceneOutputBinding {
+    /** 槽位标识，缺省 `default` */
+    key: string;
+    /** 归属场景（页内多场景时只显示当前场景的槽位） */
+    sceneId: string;
+    /** 面板上显示的名字，等于传进来的 slot */
+    label: string;
+    getter: () => SceneSnapshot;
+}
+/** 当前场景挂载的全部输出槽位；由面板轮询调用，纯前端实现 */
+export declare const currentOutputSlots: import("vue").ShallowRef<SceneOutputBinding[], SceneOutputBinding[]>;
+/** 兼容旧接口：第一个槽位 */
+export declare const currentOutput: import("vue").ComputedRef<(() => SceneSnapshot) | null>;
+/**
+ * 把场景里的响应式状态暴露成「输出」快照。
+ * 一个场景多个 demo 时传 `slot` 区分，例如 `useSceneOutput(() => ({ ... }), '主按钮')`。
+ */
+export declare const useSceneOutput: (getter: () => SceneSnapshot, slot?: string) => void;