apptify 0.6.1 → 0.7.0

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

@@ -0,0 +1,68 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleLink",
+  "source": "src/components/link.ts",
+  "props": [
+    {
+      "name": "as",
+      "type": "'a' | 'button'",
+      "default": "\"a\"",
+      "description": "渲染为 a 或 button。执行页面内操作时使用 button；原生 type 默认 button，也可作为 attr 指定 submit。"
+    },
+    {
+      "name": "href",
+      "type": "string",
+      "default": "undefined",
+      "description": "链接地址。"
+    },
+    {
+      "name": "external",
+      "type": "boolean",
+      "default": "false",
+      "description": "a 模式使用 _blank 打开，并添加 noopener noreferrer 和外链标记。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "移除 href、设置 aria-disabled 并阻止 click；button 模式还设置原生 disabled。"
+    },
+    {
+      "name": "icon",
+      "type": "Component",
+      "default": "undefined",
+      "description": "Vue 图标组件，例如从 lucide-vue-next 导入的 Mail；不是图标名称字符串。"
+    },
+    {
+      "name": "iconOnly",
+      "type": "boolean",
+      "default": "false",
+      "description": "紧凑的纯图标布局。用 label 为按钮提供可访问名称。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "undefined",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "type": "(event: MouseEvent) => void",
+      "description": "可用状态下点击时触发；需要自定义导航时可调用 event.preventDefault()。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "链接或按钮内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "页面跳转使用 href；页面内操作使用 as=\"button\"。链接不提供 motion 或 ripple props。"
+  ]
+})

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

@@ -0,0 +1,67 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleList",
+  "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": "string | number",
+      "default": "undefined",
+      "description": "当前选中 value，仅 selectable 交互会发出 update:modelValue。"
+    },
+    {
+      "name": "selectable",
+      "type": "boolean",
+      "default": "false",
+      "description": "使用 button 单选并更新 modelValue；false 时有 href 的项渲染为链接，其余作为内容。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"列表\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "select",
+      "type": "(item: AppleItem) => void",
+      "description": "点击可用项时发出完整项；selectable 时随后更新模型，否则保留链接行为。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "item",
+      "type": "({ item: AppleItem, selected: boolean }) => VNode[]",
+      "description": "替代列表项的内部内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,72 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleMenu",
+  "source": "src/components/overlays.ts",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "undefined",
+      "description": "打开状态；默认 undefined，允许内部管理。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"操作\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "items",
+      "type": "AppleMenuItem[]",
+      "default": "[]",
+      "description": "菜单数组：{ label, value: string|number, disabled?, danger?, description?, icon?: Component }。选择后关闭。"
+    },
+    {
+      "name": "selected",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "为指定 value 显示勾选标记；不会因选择事件自动更新此 prop。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: boolean) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "select",
+      "type": "(value: string | number, item: AppleMenuItem) => void",
+      "description": "选择可用菜单项时发出 value 和完整项，然后更新打开状态为 false。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "activator",
+      "type": "({ props: Record<string, unknown>, open: () => void, close: () => void, isOpen: boolean }) => VNode[]",
+      "description": "自定义菜单触发元素，绑定 props 保留交互。"
+    },
+    {
+      "name": "item",
+      "type": "({ item: AppleMenuItem }) => VNode[]",
+      "description": "替代菜单按钮的内部内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,100 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleNavibar",
+  "source": "src/components/navibar.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "items",
+      "type": "AppleItem[]",
+      "default": "[]",
+      "description": "导航项结构：{ label: string; value: string | number; disabled?: boolean; description?: string; href?: string; content?: string }[]。带 href 时生成链接；事件本身不会阻止链接导航。"
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "当前值。使用 v-model 同步组件发出的 update:modelValue。"
+    },
+    {
+      "name": "brand",
+      "type": "string",
+      "default": "\"\"",
+      "description": "品牌文字；brand 插槽可以覆盖。"
+    },
+    {
+      "name": "brandHref",
+      "type": "string",
+      "default": "\"/\"",
+      "description": "默认品牌链接地址，不负责 Vue Router 导航。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"主导航\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "fixed",
+      "type": "boolean",
+      "default": "true",
+      "description": "固定定位；关闭后按正常文档流布局。"
+    },
+    {
+      "name": "hideOnPreview",
+      "type": "boolean",
+      "default": "undefined",
+      "description": "省略时跟随 fixed；图片预览期间隐藏并保留占位，退出开始时恢复。"
+    },
+    {
+      "name": "breakpoint",
+      "type": "number",
+      "default": "640",
+      "description": "导航栏自身宽度小于等于此值时折叠为菜单，单位 px；不是仅检查窗口宽度。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number, item: AppleItem) => void",
+      "description": "选择导航项后发出 value 和完整项；不阻止 href 跳转。"
+    },
+    {
+      "name": "toggle",
+      "type": "(open: boolean) => void",
+      "description": "折叠菜单打开状态改变时触发。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "brand",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代品牌内容。"
+    },
+    {
+      "name": "item",
+      "type": "({ item: AppleItem, active: boolean }) => VNode[]",
+      "description": "替代每个导航项的内部内容；外层链接/按钮仍由组件处理。"
+    },
+    {
+      "name": "actions",
+      "type": "({ close: (restoreFocus?: boolean) => void }) => VNode[]",
+      "description": "右侧附加操作；需要时调用 close() 关闭折叠菜单。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "固定模式保留占位；折叠取决于导航栏自身宽度。链接导航由 href 或应用的 Router 处理。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-otp-input.ts

@@ -0,0 +1,108 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleOtpInput",
+  "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": "验证码字符串；键入和粘贴后截取到 length。"
+    },
+    {
+      "name": "length",
+      "type": "number",
+      "default": "6",
+      "description": "验证码位数，要求 1–12，默认 6。"
+    },
+    {
+      "name": "numeric",
+      "type": "boolean",
+      "default": "true",
+      "description": "只保留数字；false 允许非空白字符。"
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "default": "undefined",
+      "description": "HTML 表单字段名；设置后才会在 FormData 中包含此字段。"
+    },
+    {
+      "name": "mask",
+      "type": "boolean",
+      "default": "false",
+      "description": "将各位输入渲染为 password，不改变实际模型。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    },
+    {
+      "name": "complete",
+      "type": "(value: string) => void",
+      "description": "更新后的字符串长度达到 length 时触发；不执行远程验证。"
+    }
+  ],
+  "slots": [],
+  "methods": [
+    {
+      "name": "focus(index = 0)",
+      "type": "(index?: number) => void",
+      "description": "聚焦指定验证码位，索引从 0 开始并约束在有效范围。"
+    }
+  ],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-overlay-host.ts

@@ -0,0 +1,13 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleOverlayHost",
+  "source": "src/components/overlays.ts",
+  "props": [],
+  "events": [],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "只消费注入上下文的 overlays.entries；不接受公开 props、事件或插槽。Provider 已包含 Host，独立宿主场景才手动挂载。"
+  ]
+})

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

@@ -0,0 +1,61 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "ApplePagination",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "modelValue",
+      "type": "number",
+      "default": "1",
+      "description": "从 1 开始的页码，显示时约束在有效页数内。"
+    },
+    {
+      "name": "total",
+      "type": "number",
+      "default": "0",
+      "description": "总条目数量，不是总页数；0 或负数时禁用翻页。"
+    },
+    {
+      "name": "pageSize",
+      "type": "number",
+      "default": "10",
+      "description": "每页条目数量；页数使用 ceil(total / max(1, pageSize))。"
+    },
+    {
+      "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": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,112 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "ApplePopover",
+  "source": "src/components/overlays.ts",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "undefined",
+      "description": "受控打开状态；省略时内部管理，保留默认 undefined 可体验非受控模式。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"更多\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "placement",
+      "type": "'top' | 'bottom' | 'left' | 'right'",
+      "default": "\"bottom\"",
+      "description": "期望弹出方向：top、bottom、left、right；碰到视口边缘时会避让。"
+    },
+    {
+      "name": "align",
+      "type": "'start' | 'center' | 'end'",
+      "default": "\"start\"",
+      "description": "与触发元素对齐：start、center、end。"
+    },
+    {
+      "name": "role",
+      "type": "string",
+      "default": "\"dialog\"",
+      "description": "面板 ARIA role，默认 dialog；自定义语义应与内容匹配。"
+    },
+    {
+      "name": "width",
+      "type": "number | string",
+      "default": "280",
+      "description": "宽度。数字按 px，字符串作为 CSS 尺寸；仍受可用空间约束。"
+    },
+    {
+      "name": "openOnHover",
+      "type": "boolean",
+      "default": "false",
+      "description": "在非触摸设备上支持悬停打开，同时保留焦点和点击交互。"
+    },
+    {
+      "name": "trapFocus",
+      "type": "boolean",
+      "default": "true",
+      "description": "打开后限制 Tab 焦点在面板内；tooltip 等非模态提示可关闭。"
+    },
+    {
+      "name": "panelClass",
+      "type": "string",
+      "default": "\"\"",
+      "description": "附加到弹出面板的 CSS class。"
+    },
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: boolean) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "open",
+      "type": "() => void",
+      "description": "打开状态改变为 true 时触发。"
+    },
+    {
+      "name": "close",
+      "type": "() => void",
+      "description": "面板退出过渡完成并释放层级状态后触发，无参数。"
+    },
+    {
+      "name": "after-close",
+      "type": "() => void",
+      "description": "面板退出过渡完成后触发。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "activator",
+      "type": "({ props: Record<string, unknown>, open: () => void, close: () => void, isOpen: boolean }) => VNode[]",
+      "description": "自定义触发元素，使用 v-bind=\"props\" 保留点击、焦点与 ARIA 交互。"
+    },
+    {
+      "name": "default",
+      "type": "({ close: () => void }) => VNode[]",
+      "description": "弹出面板内容；close() 关闭面板。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "支持受控与非受控状态，Esc 与外部点击关闭并恢复焦点。自定义 activator 应绑定 slot props。"
+  ]
+})

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

@@ -0,0 +1,56 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleProgress",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "modelValue",
+      "type": "number",
+      "default": "0",
+      "description": "只读进度数值，显示百分比约束为 0–100%；不发出 update:modelValue，使用 :model-value。"
+    },
+    {
+      "name": "max",
+      "type": "number",
+      "default": "100",
+      "description": "进度总量，用于将 modelValue 换算为百分比；非正值按 0% 显示。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"进度\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "indeterminate",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示不定进度，不提供 aria-valuenow。"
+    },
+    {
+      "name": "showValue",
+      "type": "boolean",
+      "default": "false",
+      "description": "确定进度显示百分比，不定进度显示“进行中”。"
+    },
+    {
+      "name": "tone",
+      "type": "string",
+      "default": "\"accent\"",
+      "description": "视觉语义颜色，不会自行触发业务操作。"
+    }
+  ],
+  "events": [],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})