apptify 0.6.1 → 0.7.0

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

@@ -0,0 +1,67 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleAlert",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "title",
+      "type": "string",
+      "default": "undefined",
+      "description": "标题文字。"
+    },
+    {
+      "name": "message",
+      "type": "string",
+      "default": "undefined",
+      "description": "正文文字；提供 default 插槽时以插槽内容为准。"
+    },
+    {
+      "name": "tone",
+      "type": "'info' | 'success' | 'warning' | 'danger'",
+      "default": "\"info\"",
+      "description": "视觉语义颜色，不会自行触发业务操作。"
+    },
+    {
+      "name": "closable",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示关闭按钮。"
+    },
+    {
+      "name": "modelValue",
+      "type": "boolean",
+      "default": "true",
+      "description": "是否显示，默认 true；关闭后更新为 false。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: boolean) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "close",
+      "type": "() => void",
+      "description": "点击关闭按钮时触发；此前已发出 update:modelValue(false)。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代 message 正文。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,32 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleAside",
+  "source": "src/components/navibar.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "hideOnPreview",
+      "type": "boolean",
+      "default": "true",
+      "description": "图片预览期间隐藏导航并禁止交互，同时保留原占位；退出预览时恢复。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "侧栏内容；布局由调用方提供。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-auto-size.ts

@@ -0,0 +1,32 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleAutoSize",
+  "source": "src/components/motion.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "axis",
+      "type": "'height' | 'both'",
+      "default": "\"height\"",
+      "description": "height 动画调整高度，both 同时调整宽度与高度。使用 ResizeObserver 测量实际内容尺寸。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "尺寸变化的内容。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,114 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleAutocomplete",
+  "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": "选中选项的 value；开始输入查询时更新为 null。查询文字本身通过 search 事件提供。"
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "default": "\"搜索或选择\"",
+      "description": "尚未填写或选择时显示的占位文字，不能替代字段名称。"
+    },
+    {
+      "name": "emptyText",
+      "type": "string",
+      "default": "\"没有匹配的选项\"",
+      "description": "没有匹配项时显示的文字。"
+    },
+    {
+      "name": "clearable",
+      "type": "boolean",
+      "default": "true",
+      "description": "选中值不为 null 时显示清空按钮；清空后 update:modelValue 和 change 都传 null。"
+    },
+    {
+      "name": "filter",
+      "type": "(query: string, item: AppleOption) => boolean",
+      "default": "(query, item) => item.label.toLocaleLowerCase().includes(query.toLocaleLowerCase())",
+      "description": "过滤函数 (query, item) => boolean。默认按 label 进行不区分大小写的包含匹配。"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "type": "(value: string | number | null) => void",
+      "description": "交互更新时发出新模型值；可使用 v-model 接收。"
+    },
+    {
+      "name": "change",
+      "type": "(value: string | number | null) => void",
+      "description": "用户提交选择或调整时发出当前值；直接从父组件赋值不会主动发出此事件。"
+    },
+    {
+      "name": "search",
+      "type": "(query: string) => void",
+      "description": "输入查询文字时发出；查询不是所选 value，选择选项不会发出 search。"
+    }
+  ],
+  "slots": [],
+  "methods": [
+    {
+      "name": "focus()",
+      "type": "() => void",
+      "description": "通过组件 ref 将焦点移到输入或选择触发元素；禁用时无法聚焦。"
+    }
+  ],
+  "notes": [
+    "字段名称、帮助和错误文字只用于说明。直接操作控件；原生 name、autocomplete 等属性需按实际输入类型使用。"
+  ]
+})

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

@@ -0,0 +1,50 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleAvatarGroup",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "items",
+      "type": "AppleAvatarItem[]",
+      "default": "[]",
+      "description": "成员数组：{ name: string; src?: string; value?: string | number }[]。"
+    },
+    {
+      "name": "max",
+      "type": "number",
+      "default": "4",
+      "description": "最多显示的头像数；超出显示 +N，负数按 0 处理。"
+    },
+    {
+      "name": "size",
+      "type": "number",
+      "default": "36",
+      "description": "尺寸，数字按 px。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"成员\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代完整头像集合，包括默认的 +N。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,56 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleAvatar",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "src",
+      "type": "string",
+      "default": "undefined",
+      "description": "图片地址；加载失败时使用回退内容。"
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "default": "\"用户\"",
+      "description": "图片的替代文字，也是失败或无 src 时的回退文字来源，取去除两端空白后的前两个字符。"
+    },
+    {
+      "name": "size",
+      "type": "number",
+      "default": "40",
+      "description": "尺寸，数字按 px。"
+    },
+    {
+      "name": "square",
+      "type": "boolean",
+      "default": "false",
+      "description": "使用方形头像样式。"
+    }
+  ],
+  "events": [
+    {
+      "name": "error",
+      "type": "(event: Event) => void",
+      "description": "头像图片加载失败时触发，并切换到插槽或姓名回退。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "无图片或加载失败时替代姓名回退文字。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

package/templates/playground/src/editor/handbooks/apple-back-top.ts

@@ -0,0 +1,62 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleBackTop",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "target",
+      "type": "string",
+      "default": "\"\"",
+      "description": "滚动容器的 CSS 选择器。空字符串使用 window；目标应在组件挂载时已存在。"
+    },
+    {
+      "name": "threshold",
+      "type": "number",
+      "default": "300",
+      "description": "目标滚动位置达到此值后显示按钮，单位 px。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"回到顶部\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "fixed",
+      "type": "boolean",
+      "default": "true",
+      "description": "固定右下角；嵌入 FloatingGroup 时由组负责定位。"
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "type": "(event: MouseEvent) => void",
+      "description": "执行回到顶部时发出原生事件，动画遵循动效偏好。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "替代默认向上箭头。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "示例使用可滚动容器演示阈值；target 为空时操作 window。目标在挂载时解析，更改目标后需要重新挂载组件。"
+  ]
+})

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

@@ -0,0 +1,62 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleBadge",
+  "source": "src/components/content.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "value",
+      "type": "string | number",
+      "default": "undefined",
+      "description": "徽标内容；数值 0 默认隐藏，字符串 \"0\" 仍显示。数字超过 max 时显示 max+。"
+    },
+    {
+      "name": "max",
+      "type": "number",
+      "default": "99",
+      "description": "数字显示上限，仅对 number 类型 value 生效。"
+    },
+    {
+      "name": "dot",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示圆点并忽略 value 文字。"
+    },
+    {
+      "name": "showZero",
+      "type": "boolean",
+      "default": "false",
+      "description": "value 为数字 0 时仍显示。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "undefined",
+      "description": "徽标的可访问名称，省略时自动使用消息数量或“有新消息”。"
+    },
+    {
+      "name": "tone",
+      "type": "string",
+      "default": "\"danger\"",
+      "description": "视觉语义颜色，不会自行触发业务操作。"
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "被标记的内容；无插槽时徽标独立显示。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,38 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleBreadcrumbs",
+  "source": "src/components/content.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 }[]。最后一项始终显示为当前页文本；禁用项不生成可点击元素。"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "default": "\"当前位置\"",
+      "description": "控件名称或区域的可访问名称。无可见名称时应提供 aria-label。"
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "type": "(item: AppleItem, event: MouseEvent) => void",
+      "description": "点击可用的非末项时发出完整项和原生事件。接入 Router 时自行阻止默认导航。"
+    }
+  ],
+  "slots": [],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})

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

@@ -0,0 +1,92 @@
+import { defineHandbook } from '../handbook'
+
+export default defineHandbook({
+  "name": "AppleButton",
+  "source": "src/components/button.ts",
+  "props": [
+    {
+      "name": "motion",
+      "type": "'inherit' | 'auto' | 'full' | 'reduced' | 'none'",
+      "default": "\"inherit\"",
+      "description": "局部动效偏好。inherit 跟随外层；全局与系统的减少动效设置仍是上限。"
+    },
+    {
+      "name": "variant",
+      "type": "'primary' | 'secondary' | 'outline' | 'danger'",
+      "default": "\"primary\"",
+      "description": "primary 为主要操作，secondary 和 outline 为描边按钮，danger 为危险操作。"
+    },
+    {
+      "name": "size",
+      "type": "'small' | 'medium' | 'large'",
+      "default": "\"medium\"",
+      "description": "按钮尺寸：small、medium、large。"
+    },
+    {
+      "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": "按钮的可访问名称；iconOnly 时同时用作 title。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "description": "禁用控件的交互。选项自身的 disabled 仍然独立生效。"
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "default": "false",
+      "description": "显示加载图标并禁止点击；有 href 时也会退化为禁用的 button。"
+    },
+    {
+      "name": "ripple",
+      "type": "boolean",
+      "default": "true",
+      "description": "启用点击波纹，同时受全局波纹和动效设置约束。"
+    },
+    {
+      "name": "href",
+      "type": "string",
+      "default": "undefined",
+      "description": "非空且可用时渲染为 a；禁用或加载时渲染为 button，移除 href。"
+    },
+    {
+      "name": "type",
+      "type": "'button' | 'submit' | 'reset'",
+      "default": "\"button\"",
+      "description": "原生按钮类型。仅在渲染为 button 时使用，默认 button，避免意外提交表单。"
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "type": "(event: MouseEvent) => void",
+      "description": "可用状态下点击时触发；href 模式不会自动阻止原生链接跳转。"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "type": "() => VNode[]（无 slot props）",
+      "description": "按钮文字；图标与加载指示由 props 控制。"
+    }
+  ],
+  "methods": [],
+  "notes": [
+    "使用真实内容与可访问名称；交互控件可通过 Tab 和原生键盘方式操作，动效遵循外层偏好。"
+  ]
+})