apptify 0.6.2 → 0.7.1

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

@@ -0,0 +1,112 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleCard",
+  "source": "src/components/AppleCard.vue",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "icon",
+      "type": "Component | string",
+      "default": "undefined",
+      "description": "Vue 图标组件或图片 URL 字符串；icon 插槽可以覆盖。"
+    },
+    {
+      "name": "iconColor",
+      "type": "string",
+      "default": "undefined",
+      "description": "组件图标的颜色，不影响字符串图片图标。"
+    },
+    {
+      "name": "title",
+      "type": "string",
+      "default": "undefined",
+      "description": "标题文字。"
+    },
+    {
+      "name": "subtitle",
+      "type": "string",
+      "default": "undefined",
+      "description": "标题下方的补充文字。"
+    },
+    {
+      "name": "text",
+      "type": "string",
+      "default": "undefined",
+      "description": "内容文字。"
+    },
+    {
+      "name": "eyebrow",
+      "type": "string",
+      "default": "undefined",
+      "description": "标题上方的短文字。"
+    },
+    {
+      "name": "image",
+      "type": "string",
+      "default": "undefined",
+      "description": "顶部图片 URL；media 插槽会替代该图片。"
+    },
+    {
+      "name": "imageAlt",
+      "type": "string",
+      "default": "\"\"",
+      "description": "顶部图片的替代文字。"
+    },
+    {
+      "name": "href",
+      "type": "string",
+      "default": "undefined",
+      "description": "仅将标题渲染为链接，不会让整张卡片可点击。"
+    },
+    {
+      "name": "zoom",
+      "type": "'big' | 'small' | 'none'",
+      "default": "\"none\"",
+      "description": "悬停缩放：big、small、none；仅完整动效且支持悬停时使用。"
+    },
+    {
+      "name": "shadow",
+      "type": "'normal' | 'static' | 'focused' | 'none'",
+      "default": "\"normal\"",
+      "description": "阴影：normal（悬停增强）、static、focused、none。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "media",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代默认顶部图片。"
+    },
+    {
+      "name": "icon",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代默认图标。"
+    },
+    {
+      "name": "title",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代默认标题，需自行保留标题与链接语义。"
+    },
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "放在文字后的卡片正文。"
+    },
+    {
+      "name": "actions",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "底部操作区。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,102 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleCascader",
+  "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 | number)[]",
+      "default": "[]",
+      "description": "已选 value 的路径数组，每级一个值；改选上级时舍弃其后的旧路径。"
+    },
+    {
+      "name": "items",
+      "type": "AppleCascaderOption[]",
+      "default": "[]",
+      "description": "递归选项：{ label: string; value: string | number; disabled?: boolean } & { children?: AppleCascaderOption[] }。需自行提供数据。"
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "default": "\"请选择\"",
+      "description": "尚未填写或选择时显示的占位文字，不能替代字段名称。"
+    },
+    {
+      "name": "levelLabels",
+      "type": "string[]",
+      "default": "[]",
+      "description": "各层选择器的占位文字和可访问名称，未提供的层级使用 placeholder / label。"
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "default": "undefined",
+      "description": "提交字段按 name[0]、name[1] 等命名。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: (string | number)[]) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: (string | number)[]) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    },
+    {
+      "name": "complete",
+      "type": "(path: (string | number)[]) => void",
+      "description": "选择无子节点的叶子选项时触发，参数是完整选中路径。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,85 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleCheckbox",
+  "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": "是否勾选，布尔值。"
+    },
+    {
+      "name": "indeterminate",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示混合状态并设置 aria-checked=mixed；不会自行修改 modelValue。"
+    }
+  ],
+  "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-color-picker.ts

@@ -0,0 +1,79 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleColorPicker",
+  "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": "\"#0071e3\"",
+      "description": "HEX 颜色字符串，默认 #0071e3。交互更新为小写的六位 #rrggbb；HEX 输入允许三位简写。"
+    },
+    {
+      "name": "showValue",
+      "type": "boolean",
+      "default": "true",
+      "description": "在颜色触发按钮旁显示大写 HEX 文字，不影响面板中的 HEX 编辑。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string) => void",
+      "description": "完成拖动、键盘操作、应用 HEX 或选择色样时发出；连续拖动的模型更新不一定发出 change。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,26 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleContainer",
+  "source": "src/components/foundation.ts",
+  "props": [
+    {
+      "name": "width",
+      "type": "number | string",
+      "default": "1200",
+      "description": "内容最大宽度；数字按 px，字符串按 CSS 尺寸。实际宽度不会超过可用空间。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "容器内的内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-date-picker.ts

@@ -0,0 +1,104 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleDatePicker",
+  "source": "src/components/date-picker.ts",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "string",
+      "default": "\"\"",
+      "description": "规范化模型字符串：YYYY、YYYY-MM、YYYY-MM-DD、日期THH:mm[:ss] 或 HH:mm[:ss]，由显示分段决定；清空为 \"\"。"
+    },
+    {
+      "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": "min",
+      "type": "string",
+      "default": "undefined",
+      "description": "最早允许的日期/时间字符串，与当前模型精度对应。"
+    },
+    {
+      "name": "max",
+      "type": "string",
+      "default": "undefined",
+      "description": "最晚允许的日期/时间字符串，与当前模型精度对应。"
+    },
+    {
+      "name": "format",
+      "type": "string",
+      "default": "undefined",
+      "description": "显示分段格式，例如 YYYY/MM/DD、YYYY/MM/DD HH:mm:ss 或 HH:mm。优先级高于 granularity 和 type，模型仍用规范化分隔符。"
+    },
+    {
+      "name": "granularity",
+      "type": "string",
+      "default": "undefined",
+      "description": "格式预设名称。内置 year、month、day、hour、minute、second、hm、hms、ym、ymd、ymdhm、ymdhms。显式 format 优先。"
+    },
+    {
+      "name": "type",
+      "type": "'date' | 'month' | 'datetime-local' | 'time'",
+      "default": "\"date\"",
+      "description": "未设置 format/granularity 时选择 date、month、datetime-local 或 time 的默认分段。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "format > granularity > type。显示格式和模型格式分离，输入不会自动跳到下一段；不支持范围或 ISO week 选择。",
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,151 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleDialog",
+  "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": "true",
+      "description": "显示默认操作区；自定义 footer 插槽始终可以显示。Dialog 默认 true，Drawer/Sheet 默认 false。"
+    },
+    {
+      "name": "closable",
+      "type": "boolean",
+      "default": "true",
+      "description": "显示关闭按钮。"
+    },
+    {
+      "name": "width",
+      "type": "string | number",
+      "default": "480",
+      "description": "宽度。数字按 px，字符串作为 CSS 尺寸；仍受可用空间约束。"
+    },
+    {
+      "name": "placement",
+      "type": "'left' | 'right' | 'bottom'",
+      "default": "\"right\"",
+      "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 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})