apptify 0.6.2 → 0.7.0

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

@@ -0,0 +1,74 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSkeleton",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "variant",
+      "type": "'text' | 'avatar' | 'card' | 'list' | 'table' | 'image'",
+      "default": "\"text\"",
+      "description": "骨架类型：text、avatar、card、list、table、image。"
+    },
+    {
+      "name": "lines",
+      "type": "number",
+      "default": "3",
+      "description": "text 模式的行数，渲染时限制为 1–20。"
+    },
+    {
+      "name": "rows",
+      "type": "number",
+      "default": "3",
+      "description": "list/table 模式的行数，渲染时限制为 1–20。"
+    },
+    {
+      "name": "columns",
+      "type": "number",
+      "default": "4",
+      "description": "table 模式的列数，渲染时限制为 1–20。"
+    },
+    {
+      "name": "avatar",
+      "type": "boolean",
+      "default": "false",
+      "description": "text 模式在文字行旁显示头像占位；list 模式默认始终包含头像。"
+    },
+    {
+      "name": "width",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "宽度。数字按 px，字符串作为 CSS 尺寸；仍受可用空间约束。"
+    },
+    {
+      "name": "height",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "高度。数字按 px，字符串作为 CSS 尺寸。"
+    },
+    {
+      "name": "animated",
+      "type": "boolean",
+      "default": "true",
+      "description": "启用骨架动画，同时受动效设置约束。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"正在加载内容\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,103 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSlider",
+  "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": "number",
+      "default": "0",
+      "description": "单个数值，不支持双端范围数组。"
+    },
+    {
+      "name": "min",
+      "type": "number",
+      "default": "0",
+      "description": "原生 range 的最小值。"
+    },
+    {
+      "name": "max",
+      "type": "number",
+      "default": "100",
+      "description": "原生 range 的最大值。"
+    },
+    {
+      "name": "step",
+      "type": "number",
+      "default": "1",
+      "description": "每次调整的数值步长。"
+    },
+    {
+      "name": "showValue",
+      "type": "boolean",
+      "default": "true",
+      "description": "显示当前数值。"
+    },
+    {
+      "name": "formatValue",
+      "type": "(value: number) => string",
+      "default": "(value) => String(value)",
+      "description": "格式化函数 (value: number) => string，同时用于数值显示与 aria-valuetext。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: number) => void",
+      "description": "原生 range 提交变化时发出数值，区别于连续 input 模型更新。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,89 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSnackbar",
+  "source": "src/components/overlays.ts",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "true",
+      "description": "是否显示，默认 true。"
+    },
+    {
+      "name": "message",
+      "type": "string",
+      "default": "\"\"",
+      "description": "正文文字；提供 default 插槽时以插槽内容为准。"
+    },
+    {
+      "name": "title",
+      "type": "string",
+      "default": "\"\"",
+      "description": "标题文字。"
+    },
+    {
+      "name": "tone",
+      "type": "'default' | 'info' | 'success' | 'warning' | 'danger' | 'error'",
+      "default": "\"default\"",
+      "description": "视觉语义颜色，不会自行触发业务操作。"
+    },
+    {
+      "name": "duration",
+      "type": "number",
+      "default": "4000",
+      "description": "自动关闭等待时间，单位毫秒；0 或负数常驻。鼠标悬停或焦点进入会暂停计时，离开继续。"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "default": "\"\"",
+      "description": "非空时显示操作按钮，仅发出 action，不会自动关闭。"
+    },
+    {
+      "name": "closable",
+      "type": "boolean",
+      "default": "true",
+      "description": "显示关闭按钮，不影响 duration 自动关闭。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: boolean) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "close",
+      "type": "(value: undefined, reason: 'close' | 'timeout') => void",
+      "description": "手动关闭或计时结束时触发，首个参数为 undefined。"
+    },
+    {
+      "name": "action",
+      "type": "() => void",
+      "description": "点击操作按钮时触发，不会自动关闭。"
+    },
+    {
+      "name": "after-close",
+      "type": "() => void",
+      "description": "退出过渡完成后触发。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代 title 与 message 的内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "直接使用时位置由外层布局决定。操作按钮仅发出 action；duration 单位为毫秒。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-speed-dial-item.ts

@@ -0,0 +1,16 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  name: 'AppleSpeedDialItem', source: 'src/components/speed-dial.ts',
+  props: [
+    { name: 'label', type: 'string', default: 'undefined', required: true, description: '操作名称，图标按钮的可访问名称。' },
+    { name: 'icon', type: 'Component', default: 'undefined', description: '图标组件；有图标且未提供默认插槽时显示圆形图标按钮。' },
+    { name: 'disabled', type: 'boolean', default: 'false', description: '禁用此操作，保留按钮位置。' },
+    { name: 'visible', type: 'boolean', default: 'true', description: '控制操作的显示和注册；隐藏时不占位置。' },
+    { name: 'variant', type: "'primary' | 'secondary' | 'outline' | 'danger'", default: '"primary"', description: '操作按钮的外观类型。' },
+  ],
+  events: [{ name: 'click', type: '(event: MouseEvent) => void', description: '在全局宿主点击按钮时触发，处理函数仍由声明它的页面持有。' }],
+  slots: [{ name: 'default', type: '() => VNode[]', description: '按钮内容；省略时使用图标或 label。' }],
+  methods: [],
+  notes: ['按注册顺序插入 BackTop 与目录按钮之间，卸载和 KeepAlive 停用时自动注销。无需手动注册或父子通信。'],
+})

package/templates/playground/src/editor/handbooks/apple-speed-dial.ts

@@ -0,0 +1,13 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  name: 'AppleSpeedDial', source: 'src/components/speed-dial.ts',
+  props: [
+    { name: 'backTop', type: 'boolean', default: 'true', description: '内置回到顶部按钮，始终排在操作项上方。' },
+    { name: 'target', type: 'string', default: '""', description: 'BackTop 监听的滚动容器 CSS 选择器，空字符串使用 window。' },
+    { name: 'threshold', type: 'number', default: '300', description: '滚动达到此距离后显示 BackTop，单位 px。' },
+    { name: 'label', type: 'string', default: '"快捷操作"', description: '浮动操作组的可访问名称。' },
+  ],
+  events: [], slots: [], methods: [],
+  notes: ['在 App.vue 的 AppleProvider 内放置一次；子页面使用 AppleSpeedDialItem 注册操作，不重复创建宿主。', '宽度不超过 900px 时自动收集 AppleTree 移动目录，目录按钮排最后。多个目录使用 AppleTabBar，弹窗保持稳定的高高度。'],
+})

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

@@ -0,0 +1,38 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSpinner",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "size",
+      "type": "number",
+      "default": "22",
+      "description": "尺寸，数字按 px。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"正在加载\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "加载图标旁的附加内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,44 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleStack",
+  "source": "src/components/foundation.ts",
+  "props": [
+    {
+      "name": "direction",
+      "type": "'row' | 'column'",
+      "default": "\"column\"",
+      "description": "Flex 主轴方向：row 或 column。"
+    },
+    {
+      "name": "gap",
+      "type": "string | number",
+      "default": "16",
+      "description": "子项间距。数字按 px；字符串按 CSS 长度处理。"
+    },
+    {
+      "name": "align",
+      "type": "string",
+      "default": "\"stretch\"",
+      "description": "CSS align-items 值，例如 stretch、center、flex-start、flex-end。"
+    },
+    {
+      "name": "wrap",
+      "type": "boolean",
+      "default": "true",
+      "description": "row 时允许换行；column 始终使用 nowrap。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "参与 Flex 排列的子项。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,69 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleStatistic",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "value",
+      "type": "string | number",
+      "default": "0",
+      "description": "数值使用 locale 本地化并按 precision 保留小数；字符串原样显示。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "undefined",
+      "description": "必填的统计名称。",
+      "required": true
+    },
+    {
+      "name": "prefix",
+      "type": "string",
+      "default": "undefined",
+      "description": "数值前的文字。"
+    },
+    {
+      "name": "suffix",
+      "type": "string",
+      "default": "undefined",
+      "description": "数值后的文字。"
+    },
+    {
+      "name": "precision",
+      "type": "number",
+      "default": "0",
+      "description": "小数位数，实际限制为 0–20，仅影响数字 value。"
+    },
+    {
+      "name": "locale",
+      "type": "string",
+      "default": "\"zh-CN\"",
+      "description": "Intl 数字格式的地区标识，例如 zh-CN、en-US；使用有效地区标识。"
+    },
+    {
+      "name": "description",
+      "type": "string",
+      "default": "undefined",
+      "description": "补充说明文字。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "数值和说明之后的附加内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,91 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleStepper",
+  "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": "number",
+      "default": "0",
+      "description": "当前数值。加减和提交输入时约束在 min/max 内；输入过程中仅更新有效且范围内的值。"
+    },
+    {
+      "name": "min",
+      "type": "number",
+      "default": "-Infinity",
+      "description": "允许的最小数值。"
+    },
+    {
+      "name": "max",
+      "type": "number",
+      "default": "Infinity",
+      "description": "允许的最大数值。"
+    },
+    {
+      "name": "step",
+      "type": "number",
+      "default": "1",
+      "description": "加减按钮每次调整的步长，也传递给原生 number 输入。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: number) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,61 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSteps",
+  "source": "src/components/content.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": "number",
+      "default": "0",
+      "description": "从 0 开始的步骤位置，不是 item.value。"
+    },
+    {
+      "name": "clickable",
+      "type": "boolean",
+      "default": "false",
+      "description": "允许点击步骤并发出索引；否则只展示进度。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"步骤\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: number) => void",
+      "description": "点击可用步骤时发出从 0 开始的位置，不是 item.value。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})