apptify 0.6.1 → 0.7.0

package/templates/playground/src/editor/handbooks/apple-switch.ts

@@ -0,0 +1,79 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSwitch",
+  "source": "src/components/forms.ts",
+  "props": [
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "hint",
+      "type": "string",
+      "default": "\"\"",
+      "description": "字段帮助文字；error 非空时优先显示错误，帮助文字暂时隐藏。"
+    },
+    {
+      "name": "error",
+      "type": "string",
+      "default": "\"\"",
+      "description": "显示字段错误和错误样式，不会自行执行校验或阻止表单提交。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示忙碌状态；表单控件在加载时禁止编辑或选择。"
+    },
+    {
+      "name": "required",
+      "type": "boolean",
+      "default": "false",
+      "description": "为字段添加必填标记并传递必填约束；不会自动生成 error 文本。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "false",
+      "description": "开关状态，布尔值。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: boolean) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: boolean) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代左侧 label 文字。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-tab-bar.ts

@@ -0,0 +1,66 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTabBar",
+  "source": "src/components/tabs.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "items",
+      "type": "AppleItem[]",
+      "default": "[]",
+      "description": "按顺序显示的选项。每项 value 唯一，保留字符串和数字的类型区别。结构：{ label: string; value: string | number; disabled?: boolean; description?: string; href?: string; content?: string }。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "当前页签 value。省略时内部管理；无匹配或匹配项禁用时回退到第一个可用项。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"内容分类\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "({ item: AppleItem | undefined, value: string | number | undefined }) => VNode[]",
+      "description": "当前面板内容；优先级低于对应的 panel-${value}。"
+    },
+    {
+      "name": "panel-${value}",
+      "type": "({ item: AppleItem }) => VNode[]",
+      "description": "为具体页签 value 定义面板，例如 #panel-overview。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "与 Tabs 使用相同页签与面板契约；样式固定为 bar，不提供 variant prop。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-table.ts

@@ -0,0 +1,176 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTable",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "columns",
+      "type": "AppleColumn[]",
+      "default": "[]",
+      "description": "列数组：{ key, label, sortable?, align?: 'left'|'center'|'right', width?: number|string, minWidth?, maxWidth?, resizable? }。key 对应行字段；宽度数字按 px。"
+    },
+    {
+      "name": "rows",
+      "type": "Record<string, unknown>[]",
+      "default": "[]",
+      "description": "行对象数组；每行需提供稳定唯一的 rowKey。排序和分页在本地完成。"
+    },
+    {
+      "name": "rowKey",
+      "type": "string",
+      "default": "\"id\"",
+      "description": "行的唯一标识字段名称，默认 id。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"数据表格\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "selectable",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示行复选框及当前页全选框；全选只影响当前可见页。"
+    },
+    {
+      "name": "selected",
+      "type": "(string | number)[]",
+      "default": "undefined",
+      "description": "选中行的 rowKey 值数组，可用 v-model:selected；省略时内部管理。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁止排序、选择、翻页、列宽调整及 row-click。"
+    },
+    {
+      "name": "sortBy",
+      "type": "string",
+      "default": "undefined",
+      "description": "排序字段名，可用 v-model:sort-by；省略时使用内部排序状态。"
+    },
+    {
+      "name": "sortDirection",
+      "type": "'asc' | 'desc'",
+      "default": "undefined",
+      "description": "asc 或 desc，可用 v-model:sort-direction；省略时内部初始方向为 asc。"
+    },
+    {
+      "name": "page",
+      "type": "number",
+      "default": "undefined",
+      "description": "从 1 开始的当前页，可用 v-model:page；省略时内部初始为 1。"
+    },
+    {
+      "name": "pageSize",
+      "type": "number",
+      "default": "0",
+      "description": "每页行数，0 禁用分页；总条目数使用 rows.length。"
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "default": "false",
+      "description": "设置 aria-busy，空表格时显示加载文字；不会阻止排序、选择或行点击。"
+    },
+    {
+      "name": "emptyText",
+      "type": "string",
+      "default": "\"暂无数据\"",
+      "description": "没有行且不在加载时的文字；empty 插槽可以覆盖。"
+    },
+    {
+      "name": "virtual",
+      "type": "boolean",
+      "default": "false",
+      "description": "基于固定行高的虚拟滚动；配合分页时只虚拟化当前页。"
+    },
+    {
+      "name": "height",
+      "type": "number",
+      "default": "360",
+      "description": "virtual 模式的滚动视口高度，单位 px，实际至少 96。"
+    },
+    {
+      "name": "rowHeight",
+      "type": "number",
+      "default": "48",
+      "description": "虚拟行的固定高度，单位 px，实际至少 28；不支持自动测量可变行高。"
+    },
+    {
+      "name": "overscan",
+      "type": "number",
+      "default": "5",
+      "description": "虚拟视口前后额外渲染的行数，实际至少 0。"
+    },
+    {
+      "name": "resizable",
+      "type": "boolean",
+      "default": "true",
+      "description": "允许拖动或键盘调整列宽；列上 resizable=false 可单独关闭。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:selected",
+      "type": "(value: (string | number)[]) => void",
+      "description": "交互更新 selected 时发出新值；可使用对应的命名 v-model 接收。"
+    },
+    {
+      "name": "update:sortBy",
+      "type": "(value: string) => void",
+      "description": "交互更新 sortBy 时发出新值；可使用对应的命名 v-model 接收。"
+    },
+    {
+      "name": "update:sortDirection",
+      "type": "(value: 'asc' | 'desc') => void",
+      "description": "交互更新 sortDirection 时发出新值；可使用对应的命名 v-model 接收。"
+    },
+    {
+      "name": "sort",
+      "type": "(sort: { key: string; direction: 'asc' | 'desc' }) => void",
+      "description": "点击可排序列时，在 sortBy/sortDirection 更新事件后发出排序信息。"
+    },
+    {
+      "name": "update:page",
+      "type": "(value: number) => void",
+      "description": "交互更新 page 时发出新值；可使用对应的命名 v-model 接收。"
+    },
+    {
+      "name": "row-click",
+      "type": "(row: Record<string, unknown>) => void",
+      "description": "点击数据行时发出该行；复选框操作不会冒泡触发此事件。"
+    },
+    {
+      "name": "column-resize",
+      "type": "(column: { key: string; width: number }) => void",
+      "description": "拖动或键盘调整列宽时发出列 key 和约束后的像素宽度。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "cell-${key}",
+      "type": "({ row: Record<string, unknown>, value: unknown, index: number }) => VNode[]",
+      "description": "替代 key 对应列的单元格，例如 #cell-name。index 为当前排序/分页后可见页内的行索引。"
+    },
+    {
+      "name": "empty",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代空表格内容，包括默认加载或空文字。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "rows 使用稳定唯一 rowKey。虚拟滚动使用固定行高；与分页同时启用时只虚拟化当前页。",
+    "排序、选择、分页可受控也可内部管理。列宽可通过拖动或方向键调整；此组件不提供服务器分页协议。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-tabs.ts

@@ -0,0 +1,72 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTabs",
+  "source": "src/components/tabs.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "items",
+      "type": "AppleItem[]",
+      "default": "[]",
+      "description": "按顺序显示的选项。每项 value 唯一，保留字符串和数字的类型区别。结构：{ label: string; value: string | number; disabled?: boolean; description?: string; href?: string; content?: string }。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "当前页签 value。省略时内部管理；无匹配或匹配项禁用时回退到第一个可用项。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"内容分类\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "variant",
+      "type": "'underline' | 'bar'",
+      "default": "\"underline\"",
+      "description": "underline 为下划线样式；bar 为页签栏样式。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "({ item: AppleItem | undefined, value: string | number | undefined }) => VNode[]",
+      "description": "当前面板内容；优先级低于对应的 panel-${value}。"
+    },
+    {
+      "name": "panel-${value}",
+      "type": "({ item: AppleItem }) => VNode[]",
+      "description": "为具体页签 value 定义面板，例如 #panel-overview。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "支持方向键、Home/End，跳过禁用项。省略 v-model 时内部管理，不会自动请求面板内容。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-tag.ts

@@ -0,0 +1,56 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTag",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "tone",
+      "type": "string",
+      "default": "\"neutral\"",
+      "description": "视觉语义颜色，不会自行触发业务操作。"
+    },
+    {
+      "name": "closable",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示移除按钮；点击仅发出 close，不会自行移除标签。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "undefined",
+      "description": "默认文字及移除按钮的名称；default 插槽可替换文字。"
+    }
+  ],
+  "events": [
+    {
+      "name": "close",
+      "type": "(event: Event) => void",
+      "description": "点击移除按钮时触发；由父组件决定删除或隐藏标签。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "标签文字，优先于 label。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-textarea.ts

@@ -0,0 +1,109 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTextarea",
+  "source": "src/components/forms.ts",
+  "props": [
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "hint",
+      "type": "string",
+      "default": "\"\"",
+      "description": "字段帮助文字；error 非空时优先显示错误，帮助文字暂时隐藏。"
+    },
+    {
+      "name": "error",
+      "type": "string",
+      "default": "\"\"",
+      "description": "显示字段错误和错误样式，不会自行执行校验或阻止表单提交。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示忙碌状态；表单控件在加载时禁止编辑或选择。"
+    },
+    {
+      "name": "required",
+      "type": "boolean",
+      "default": "false",
+      "description": "为字段添加必填标记并传递必填约束；不会自动生成 error 文本。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string",
+      "default": "\"\"",
+      "description": "多行文本，输入后仍返回字符串。"
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "default": "undefined",
+      "description": "尚未填写或选择时显示的占位文字，不能替代字段名称。"
+    },
+    {
+      "name": "rows",
+      "type": "number",
+      "default": "4",
+      "description": "原生 textarea 的可见行数。"
+    },
+    {
+      "name": "maxlength",
+      "type": "number",
+      "default": "undefined",
+      "description": "原生最大字符数。省略时不限制长度。"
+    },
+    {
+      "name": "counter",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示字符数；同时设置 maxlength 时显示“当前数 / 上限”。"
+    },
+    {
+      "name": "resize",
+      "type": "boolean",
+      "default": "true",
+      "description": "允许用户纵向调整大小；false 禁止手动缩放。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string) => void",
+      "description": "原生 change 时发出文字，通常在修改后移出焦点时触发。"
+    }
+  ],
+  "slots": [],
+  "methods": [
+    {
+      "name": "focus()",
+      "type": "() => void",
+      "description": "通过组件 ref 将焦点移到输入或选择触发元素；禁用时无法聚焦。"
+    }
+  ],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-timeline.ts

@@ -0,0 +1,44 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTimeline",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "items",
+      "type": "AppleTimelineItem[]",
+      "default": "[]",
+      "description": "时间项：{ label: string; value: string | number; disabled?: boolean; description?: string; href?: string; content?: string } & { time?: string; tone?: 'default'|'success'|'danger' }。"
+    },
+    {
+      "name": "orientation",
+      "type": "'horizontal' | 'vertical'",
+      "default": "\"vertical\"",
+      "description": "时间线排列方向：vertical 或 horizontal。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"时间线\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "item",
+      "type": "({ item: AppleTimelineItem }) => VNode[]",
+      "description": "替代 description 部分；标题和 time 仍保留。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-tooltip.ts

@@ -0,0 +1,45 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleTooltip",
+  "source": "src/components/overlays.ts",
+  "props": [
+    {
+      "name": "text",
+      "type": "string",
+      "default": "undefined",
+      "description": "必填的提示文字，用于面板内容和可访问名称。",
+      "required": true
+    },
+    {
+      "name": "placement",
+      "type": "'top' | 'bottom' | 'left' | 'right'",
+      "default": "\"top\"",
+      "description": "期望提示方向：top、bottom、left、right；自动避让视口边缘。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用提示面板，不会禁用 default 插槽内的触发元素。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "({ props: Record<string, unknown>, open: () => void, close: () => void, isOpen: boolean }) => VNode[]",
+      "description": "作为底层 Popover 的 activator 透传，触发元素可绑定 props。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "仅用于短文字提示，默认插槽透传 Popover activator 参数；不应用 tooltip 承载需要焦点操作的表单。"
+  ]
+})