apptify 0.6.1 → 0.7.0

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

@@ -0,0 +1,32 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleProvider",
+  "source": "src/components/foundation.ts",
+  "props": [
+    {
+      "name": "theme",
+      "type": "string",
+      "default": "undefined",
+      "description": "局部主题名称：light、dark、graphite、rose、system，或已注册主题。省略时继承父上下文。"
+    },
+    {
+      "name": "motion",
+      "type": "'auto' | 'full' | 'reduced' | 'none'",
+      "default": "undefined",
+      "description": "局部上下文的动效模式。省略时继承父上下文；仅接受 auto、full、reduced、none。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "处于局部主题和上下文中的内容。Provider 已包含 OverlayHost。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "嵌套 Provider 可使用局部主题和动效上下文；glass 与 ripple 偏好仍与父上下文共享。Provider 已自动挂载 OverlayHost，无需再放一个。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-pull-refresh.ts

@@ -0,0 +1,61 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "ApplePullRefresh",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "false",
+      "description": "刷新状态。交互开始更新为 true，调用 refresh 事件的 done() 或改为 false 结束。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "threshold",
+      "type": "number",
+      "default": "72",
+      "description": "经过阻尼处理后的下拉触发距离，单位 px，实际至少 1。仅滚动顶部开始的单指竖向手势参与。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"刷新内容\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: boolean) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "refresh",
+      "type": "(done: () => void) => void",
+      "description": "开始刷新时触发。任务完成后调用 done()，或将模型改为 false。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "({ refresh: () => void, refreshing: boolean }) => VNode[]",
+      "description": "需要刷新的内容，也可使用 refresh 手动开始。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "任务完成后必须调用 done() 或将模型设为 false。除了顶部触摸下拉，还提供可用键盘操作的刷新按钮。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-radio-group.ts

@@ -0,0 +1,91 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleRadioGroup",
+  "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": "items",
+      "type": "AppleOption[]",
+      "default": "[]",
+      "description": "单选项数组：{ label: string; value: string | number; disabled?: boolean }[]。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number | null",
+      "default": "null",
+      "description": "当前值。使用 v-model 同步组件发出的 update:modelValue。"
+    },
+    {
+      "name": "inline",
+      "type": "boolean",
+      "default": "false",
+      "description": "将原生单选按钮横向排列。"
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "default": "undefined",
+      "description": "原生 radio 组名称，省略时自动生成；表单提交时使用此名称。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number | null) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number | null) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,97 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleRate",
+  "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": "整数星级，0 表示未评分；不支持半星。"
+    },
+    {
+      "name": "max",
+      "type": "number",
+      "default": "5",
+      "description": "星星数量，渲染限制为 1–10，应用也应使用该范围。"
+    },
+    {
+      "name": "readonly",
+      "type": "boolean",
+      "default": "false",
+      "description": "只展示，禁止交互更新并移出 Tab 顺序；与 disabled 独立。"
+    },
+    {
+      "name": "allowClear",
+      "type": "boolean",
+      "default": "true",
+      "description": "再次点击当前星级时清为 0；不会改变键盘方向键的整数步进规则。"
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "default": "undefined",
+      "description": "HTML 表单字段名；设置后才会在 FormData 中包含此字段。"
+    }
+  ],
+  "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-scroll-bar.ts

@@ -0,0 +1,15 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  name: 'AppleScrollBar', source: 'src/components/scrollbar.ts',
+  props: [
+    { name: 'target', type: 'string | HTMLElement | (() => HTMLElement | undefined)', default: '""', description: 'CSS 选择器、元素或返回元素的函数；空值自动接管当前文档的滚动容器。' },
+    { name: 'axis', type: "'both' | 'horizontal' | 'vertical'", default: '"both"', description: '指定目标时显示的滚动方向。' },
+    { name: 'label', type: 'string', default: '""', description: '滚动条的可访问名称，默认从目标名称生成。' },
+    { name: 'controls', type: 'string', default: '""', description: '目标元素 ID；未提供时使用或生成目标 ID。' },
+  ],
+  events: [{ name: 'interaction', type: '() => void', description: '拖动、点击轨道、键盘或滚轮操作时触发。' }],
+  slots: [],
+  methods: [{ name: 'refresh()', type: '() => void', description: '重新测量目标及滚动位置。尺寸、内容和滚动变化默认自动同步。' }],
+  notes: ['AppleProvider 默认启用全局接管，无需逐个包裹内容。滚动条使用 fixed，不占布局空间；z-index 取 max(80, 目标及祖先层级)，弹窗内留在所属弹层上下文。', '原本主动隐藏滚动条的轮播、标签栏与日期滚轮保持原有交互；data-apple-scrollbar-ignore 可排除指定容器。'],
+})

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

@@ -0,0 +1,49 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSearch",
+  "source": "src/components/foundation.ts",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "string",
+      "default": "\"\"",
+      "description": "搜索框的文字；输入和清空均返回字符串。"
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "default": "\"搜索\"",
+      "description": "尚未填写或选择时显示的占位文字，不能替代字段名称。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"搜索\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用输入和清空按钮。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "search",
+      "type": "(value: string) => void",
+      "description": "按 Enter 时发出当前查询文字；不会自动请求或过滤数据。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-segmented-control.ts

@@ -0,0 +1,85 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSegmentedControl",
+  "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": "items",
+      "type": "AppleOption[]",
+      "default": "[]",
+      "description": "分段单选项：{ label: string; value: string | number; disabled?: boolean }[]。这是 radio 控件，不包含内容面板。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number | null",
+      "default": "null",
+      "description": "当前值。使用 v-model 同步组件发出的 update:modelValue。"
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "default": "undefined",
+      "description": "原生 radio 组名称；省略时自动生成。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number | null) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number | null) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,91 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSelect",
+  "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": "items",
+      "type": "AppleOption[]",
+      "default": "[]",
+      "description": "选项结构：{ label: string; value: string | number; disabled?: boolean }[]。disabled 选项不能选择；required 时必须选中有效且未禁用的选项。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number | null",
+      "default": "null",
+      "description": "选中选项的 value；可为字符串、数字或 null，不会强制转为字符串。"
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "default": "\"请选择\"",
+      "description": "尚未填写或选择时显示的占位文字，不能替代字段名称。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number | null) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number | null) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [],
+  "methods": [
+    {
+      "name": "focus()",
+      "type": "() => void",
+      "description": "通过组件 ref 将焦点移到输入或选择触发元素；禁用时无法聚焦。"
+    }
+  ],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,151 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleSheet",
+  "source": "src/components/overlays.ts",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "false",
+      "description": "是否打开。使用 v-model 接收关闭操作的 false。"
+    },
+    {
+      "name": "title",
+      "type": "string",
+      "default": "\"\"",
+      "description": "标题文字。"
+    },
+    {
+      "name": "message",
+      "type": "string",
+      "default": "\"\"",
+      "description": "正文文字；提供 default 插槽时以插槽内容为准。"
+    },
+    {
+      "name": "ariaLabel",
+      "type": "string",
+      "default": "\"对话框\"",
+      "description": "没有 title 时用于对话框的可访问名称。"
+    },
+    {
+      "name": "persistent",
+      "type": "boolean",
+      "default": "false",
+      "description": "阻止 Escape 和背景点击关闭；显式关闭、确认和取消仍可使用。"
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "default": "false",
+      "description": "阻止所有交互关闭、确认和取消，显示忙碌状态。"
+    },
+    {
+      "name": "closeOnConfirm",
+      "type": "boolean",
+      "default": "true",
+      "description": "确认后自动关闭。异步保存时可设 false，由应用控制 loading 和 modelValue。"
+    },
+    {
+      "name": "confirmText",
+      "type": "string",
+      "default": "\"确定\"",
+      "description": "确认按钮文字，空字符串隐藏按钮。"
+    },
+    {
+      "name": "cancelText",
+      "type": "string",
+      "default": "\"取消\"",
+      "description": "取消按钮文字，空字符串隐藏按钮。"
+    },
+    {
+      "name": "showFooter",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示默认操作区；自定义 footer 插槽始终可以显示。Dialog 默认 true，Drawer/Sheet 默认 false。"
+    },
+    {
+      "name": "closable",
+      "type": "boolean",
+      "default": "true",
+      "description": "显示关闭按钮。"
+    },
+    {
+      "name": "width",
+      "type": "string | number",
+      "default": "440",
+      "description": "宽度。数字按 px，字符串作为 CSS 尺寸；仍受可用空间约束。"
+    },
+    {
+      "name": "placement",
+      "type": "'left' | 'right' | 'bottom'",
+      "default": "\"bottom\"",
+      "description": "抽屉方向为 left、right、bottom；Sheet 默认 bottom。Dialog 不使用方向来改变其居中布局。"
+    },
+    {
+      "name": "tone",
+      "type": "string",
+      "default": "\"default\"",
+      "description": "语义色；danger 使用危险确认按钮。"
+    },
+    {
+      "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: unknown, reason: 'escape' | 'backdrop' | 'cancel' | 'confirm' | 'close') => void",
+      "description": "交互关闭时发出结果和原因；确认 true，取消 false，直接关闭通常 undefined。外部直接设置 modelValue=false 不会主动发出 close。"
+    },
+    {
+      "name": "confirm",
+      "type": "(value: true) => void",
+      "description": "点击确认时触发；closeOnConfirm=true 时随后关闭。"
+    },
+    {
+      "name": "cancel",
+      "type": "(value: false) => void",
+      "description": "点击取消时触发，随后关闭。"
+    },
+    {
+      "name": "open",
+      "type": "() => void",
+      "description": "面板挂载并注册焦点与层级管理后触发。"
+    },
+    {
+      "name": "after-close",
+      "type": "() => void",
+      "description": "退出动效完成并释放层级状态后触发。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "title",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代标题内容；仍应通过 title 或 ariaLabel 提供对话框名称。"
+    },
+    {
+      "name": "default",
+      "type": "({ close: (value?: unknown) => void }) => VNode[]",
+      "description": "对话框正文，替代 message；调用 close(value) 交回结果。"
+    },
+    {
+      "name": "footer",
+      "type": "({ close: (value?: unknown) => void, confirm: () => void, cancel: () => void }) => VNode[]",
+      "description": "替代默认按钮区；即使 showFooter=false 也会显示。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})