apptify 0.7.0 → 0.7.2

package/dist/components/button.d.ts

@@ -1,7 +1,7 @@
 import { type PropType, type Component } from 'vue';
 export declare const AppleButton: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     variant: {
-        type: PropType<"primary" | "secondary" | "outline" | "danger">;
+        type: PropType<"primary" | "secondary" | "outline" | "borderless" | "danger">;
         default: string;
     };
     size: {
@@ -28,7 +28,7 @@ export declare const AppleButton: import("vue").DefineComponent<import("vue").Ex
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "click"[], "click", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     variant: {
-        type: PropType<"primary" | "secondary" | "outline" | "danger">;
+        type: PropType<"primary" | "secondary" | "outline" | "borderless" | "danger">;
         default: string;
     };
     size: {
@@ -60,7 +60,7 @@ export declare const AppleButton: import("vue").DefineComponent<import("vue").Ex
     disabled: boolean;
     iconOnly: boolean;
     loading: boolean;
-    variant: "secondary" | "danger" | "primary" | "outline";
+    variant: "secondary" | "danger" | "primary" | "outline" | "borderless";
     ripple: boolean;
     type: "reset" | "submit" | "button";
     motion: import("..").ComponentMotion;

package/dist/components/foundation.d.ts

@@ -2484,7 +2484,7 @@ export declare const foundationComponents: {
     }, true, {}, any>;
     AppleButton: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         variant: {
-            type: PropType<"primary" | "secondary" | "outline" | "danger">;
+            type: PropType<"primary" | "secondary" | "outline" | "borderless" | "danger">;
             default: string;
         };
         size: {
@@ -2511,7 +2511,7 @@ export declare const foundationComponents: {
         };
     }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "click"[], "click", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         variant: {
-            type: PropType<"primary" | "secondary" | "outline" | "danger">;
+            type: PropType<"primary" | "secondary" | "outline" | "borderless" | "danger">;
             default: string;
         };
         size: {
@@ -2543,7 +2543,7 @@ export declare const foundationComponents: {
         disabled: boolean;
         iconOnly: boolean;
         loading: boolean;
-        variant: "secondary" | "danger" | "primary" | "outline";
+        variant: "secondary" | "danger" | "primary" | "outline" | "borderless";
         ripple: boolean;
         type: "reset" | "submit" | "button";
         motion: import("..").ComponentMotion;

package/dist/index.d.ts

@@ -5258,7 +5258,7 @@ export declare const components: {
     }, true, {}, any>;
     AppleButton: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         variant: {
-            type: import("vue").PropType<"primary" | "secondary" | "outline" | "danger">;
+            type: import("vue").PropType<"primary" | "secondary" | "outline" | "borderless" | "danger">;
             default: string;
         };
         size: {
@@ -5285,7 +5285,7 @@ export declare const components: {
         };
     }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "click"[], "click", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         variant: {
-            type: import("vue").PropType<"primary" | "secondary" | "outline" | "danger">;
+            type: import("vue").PropType<"primary" | "secondary" | "outline" | "borderless" | "danger">;
             default: string;
         };
         size: {
@@ -5317,7 +5317,7 @@ export declare const components: {
         disabled: boolean;
         iconOnly: boolean;
         loading: boolean;
-        variant: "secondary" | "danger" | "primary" | "outline";
+        variant: "secondary" | "danger" | "primary" | "outline" | "borderless";
         ripple: boolean;
         type: "reset" | "submit" | "button";
         motion: import(".").ComponentMotion;

package/docs/COMPONENTS.md

@@ -43,7 +43,7 @@ Tabs、TabBar、SegmentedControl、DatePicker 日期/时间页签均不使用 Ri
 | 组件 | 主要 Props | Events / Slots / 说明 |
 | --- | --- | --- |
 | `AppleProvider` | `theme?: string`、`motion?: auto/full/reduced/none` | default slot；应用主题并自动挂载弹层宿主。无显式属性时复用插件上下文。 |
-| `AppleButton` | M；`variant=primary`（primary/secondary/outline/danger）、`size=medium`（small/medium/large）、`icon: Component`、`iconOnly`、`label`、`disabled`、`loading`、`ripple=true`、`href`、`type=button` | `click(event)`；default slot；图标位于文字右侧。纯图标按钮须提供 label。关闭动效时禁用 Ripple，其余模式遵循全局波纹开关。 |
+| `AppleButton` | M；`variant=primary`（primary/secondary/outline/borderless/danger）、`size=medium`（small/medium/large）、`icon: Component`、`iconOnly`、`label`、`disabled`、`loading`、`ripple=true`、`href`、`type=button` | `click(event)`；default slot；borderless 默认透明无边框，悬停时显示灰色背景。图标位于文字右侧。纯图标按钮须提供 label。关闭动效时禁用 Ripple，其余模式遵循全局波纹开关。 |
 | `AppleLink` | `as=a`（a/button）、`href`、`external`、`disabled`、`icon`、`iconOnly`、`label` | default slot；文字操作使用 as=button；external 使用新窗口并设置 `noopener noreferrer`。 |
 | `AppleCard` | M；`title`、`subtitle`、`text`、`eyebrow`、`icon: Component 或图片 URL`、`iconColor`、`image`、`imageAlt`、`href`、`zoom=none`（big/small/none）、`shadow=normal`（normal/static/focused/none） | default、media、icon、title、actions slots；href 为标题链接，不会把所有嵌套控件变成一个大按钮。 |
 | `AppleImage` | M；`gallery: AppleImageItem | (string/AppleImageItem)[]`（唯一来源，默认空数组，单图可传对象）；`preview=true`、`carousel=false`、`autoplay=true`、`interval=5000`（毫秒，仅 carousel）、`disabled=false`、`label`、`galleryLayout=compact`（compact/tiled/tiled-wrap，所有设备）、`galleryShape=natural`（natural/square）、`index=0`、`squared`、`aspectRatio='4/3'`、`fit=cover`（cover/contain） | caption 与 item({item,index,active}) slots；carousel 强制 compact、默认每 5 秒循环播放，悬停、聚焦、预览、拖动、页面隐藏或禁用时暂停，保留自由滚动；默认点击预览；统一预览交互，支持拖动、双击、捏合、平滑滚轮及键盘；连续滚轮累积目标并保持位置与速度，缩放、旋转、翻页与进退场分通道，可在动画途中继续操作；翻页按距离与速度使用 360–720ms 动画，放大图片随各自画布裁剪离场；底部单一胶囊按左旋转、缩小、可选名称、放大、右旋转排列，每次旋转 90°，旋转状态按图片保存；竖屏隐藏箭头、关闭及缩放按钮；完整渲染图片组，compact 在固定框内横滑，桌面横向滚轮或 Shift+滚轮平滑横滑，连续事件保留累计目标，停止后平滑吸附；一次手势可跨越多张，快速点击翻页延续当前位置和速度；hover 放大并使用 AppleCard 的悬停阴影，横屏多图的缩略图左右按钮仅在悬浮时淡入、移开时淡出，遵循 --apple-fast 与 --apple-ease 并对齐图片中间（单图小窗与全屏均无翻页箭头），跨多张点击小点时直接衔接当前画面与目标图并支持连续改选，tiled 等高横向平铺，溢出时底部常显自定义滚动条，支持拖动、点击轨道与键盘，滑块比例随内容和容器尺寸同步，tiled-wrap 等宽保留图片比例，按列从上往下紧密堆叠，避免按行对齐产生空白；平铺 hover 只缩放当前图片；galleryShape=square 强制 1:1 并居中裁剪（覆盖 fit），squared 同样作用于图片组；`update:index`、`change(index)`；图片错误状态；squared 覆盖 aspectRatio。 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apptify",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "An Apple-inspired, responsive Vue 3 component library.",
   "repository": {
     "type": "git",

package/templates/playground/package.json

@@ -10,7 +10,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "apptify": "^0.7.0",
+    "apptify": "^0.7.2",
     "vue": "^3.5.0",
     "vue-router": "^4.6.4",
     "lucide-vue-next": "^0.468.0"

package/templates/playground/source-snapshot.json

@@ -1,6 +1,6 @@
 {
-  "createdAt": "2026-10-10T14:39:31.921Z",
-  "libraryVersion": "0.7.0",
+  "createdAt": "2026-10-16T17:27:03.556Z",
+  "libraryVersion": "0.7.2",
   "files": {
     "index.html": "75f6d93e3962ddca97a13b666a04d98ba9b263b6c288171383db764215034fea",
     "public/images/SOURCES.md": "24ccb6625b1168e48550b7651e9fc20cb747324d87666d39199608c7db20541b",
@@ -17,7 +17,7 @@
     "public/images/sunset.jpg": "4ee91e88f1e341143a807ef48fdfc24d63aa045d99351b4ea8ad7efcfef6ef9b",
     "public/images/waterfall.jpg": "cfd55ff5f41d3a58e91793d0e26a9ca90c86760aa401da033fbfa77d3364f238",
     "src/App.vue": "f85c256ed21601ccb0681a3592237e357d48ec02af371491b90a83a32203828e",
-    "src/ComponentDemo.vue": "61f82eb5eb550a73ca425938558a47b89d57bdafb6bf93c11ddd9bc8129e6230",
+    "src/ComponentDemo.vue": "a599154820d13ffb19e9a661c0e208f1b0ef79a664f3a372eb7735fa486804cd",
     "src/catalog.ts": "a27a875d316bcc8d0be523195a0b4e8e21279c7f33c8d2f024efaa8721e1518e",
     "src/components/ComponentIndex.vue": "7938a3fe3efb521d6efab4fe64edef06d40f22ecd68481d20427a24c39b6683f",
     "src/components/MasonryFeed.vue": "4882725da4211e2d39b782c839c7581a0672c815d12f146a8aee186df534ac68",
@@ -30,14 +30,14 @@
     "src/editor/AppleInputExample.vue": "b563cdcb1ec6b033a3a19878f68e7fe4cf39da9d3e838887b591b2364e1aad90",
     "src/editor/AppleInputPreview.vue": "e88a71316c62c4cb763d1f285b4b9fc8fbcb4a35c6282dc95b32d5824c87dc77",
     "src/editor/ComponentDocumentLink.vue": "f4e1c88666b315a13e48386e9353c5da733fc149fba97ecc084804abd9d0067c",
-    "src/editor/ComponentPlayground.vue": "b786d4735f2c92e8cd8ce063431b6530a844bd3d06eeef4b75f2051a95c7581b",
+    "src/editor/ComponentPlayground.vue": "2f5543cc26d438afbda48347d802d8621161c24fad6ed7d7fe37a85e2113fdec",
     "src/editor/ComponentWorkshop.vue": "0071a843cab7a8e25697c36755f911c8939c7657bd6264ec6c01a982da9f2647",
     "src/editor/ConfigurableEditor.vue": "dfcecbfb031d6840b22dcd208b163e75ce4e3706af33d3637ecb2925a3e3f6c8",
     "src/editor/LiveVueEditor.vue": "0559a63bba3dc2ffb2d54ad78e7b6c4577381280f3c08e1d3493e189fa6ff0d5",
     "src/editor/apple-input-source.ts": "c97f63206e22f6f461d2883c8baa6157e2c44a3c6b6ce6f8d4529743b9280cd5",
     "src/editor/apple-input.ts": "54546ef9b04c991e3bedd7f718cd4b03855d0ef9a7449ad4459be615d080a141",
     "src/editor/component-metadata.ts": "43a4d37f112cbd76953092679862cea426f5f5adb6738169d25a5dffb91207c1",
-    "src/editor/component-playground.ts": "aa20bae9be8d8b607da4d452d70204717287ccdff240c75eb954fe02053e352a",
+    "src/editor/component-playground.ts": "caaca2c02d22e98da71928b9984039c9756c49e6acd05d490cae7fff73808cae",
     "src/editor/contract.ts": "792b1e8b2d658297a4b48a1eaa1b697c59d4c0333a0629383e5f0f7a745bba1e",
     "src/editor/documents.ts": "11eb5a22c3bdcbd6ef4cce4cd263339d388e71c2aff1c7dd01e6466dfebc161b",
     "src/editor/handbook.ts": "6311187dd49aedb4fb232ded172bd09d2f9bf353f26e5e8f08a8d5e5d2e5d8bd",
@@ -52,7 +52,7 @@
     "src/editor/handbooks/apple-back-top.ts": "9c25f3483e9c4cf42e8d23b4a0daa2b8b8b8488b90438b64d064705662882296",
     "src/editor/handbooks/apple-badge.ts": "6543809f64aa6aeed1e1266a673a376999c268e7d3298c267e7df37c34953fca",
     "src/editor/handbooks/apple-breadcrumbs.ts": "28b3734dd3acfb2b1246a840aae596e3885f72bb82e080462962f083e3a679a1",
-    "src/editor/handbooks/apple-button.ts": "5ac2e05d7836877ab696e168cde1812cd8d4a838f9e5c766b61c881d883d4394",
+    "src/editor/handbooks/apple-button.ts": "fe33f8f70ea2a9a443750f816115a932fab466f87a2be89c882a03716cfab689",
     "src/editor/handbooks/apple-card.ts": "a1fdd55ccdb7f8f888640635631c002b58504984acbdbb76a0be8c58ea383a13",
     "src/editor/handbooks/apple-cascader.ts": "873e0198af0fe6b9cfd8364c8d32d74a2214390d11d8d1f3f6ce8b6d2b5710c2",
     "src/editor/handbooks/apple-checkbox.ts": "7b9e862613da46f8b22330ddd22bf6a3481b00d16078ecefb47bd3d392526b5e",
@@ -123,7 +123,7 @@
     "src/views/components.vue": "3fd082b7621b010e9499d5274c183cf99df10dda67483efe90b3db14bf575485",
     "src/views/index.vue": "aa266dd79241d4dd932aa7059ec0a11e92df2f1999674f6d7fa5bf335ba11698",
     "src/views/settings.vue": "8c4853775321eafac28dbd824f1cf8dbe08cce153944f269ade286071b1e1d56",
-    "tooling/playground-editor.mjs": "128b1ffa1b5660b04f7652130d5474c1f31686c2c8e0e2866f1ebde2594d0b5b",
+    "tooling/playground-editor.mjs": "b59e16b130ed6175a11bd281163ea823c1fa8a7ba48c7aeb0e683293f5170b6f",
     "tooling/prepare-input-source.mjs": "91bea35dcfa09735dbaeb5fbed7a70abfe447c3d133f4b4381e6ba0d0d4f9f6a"
   },
   "sourcePaths": {
@@ -253,10 +253,10 @@
   },
   "buildSources": {
     "src/components/AppleCard.vue": "c74eea151960b41ea6b6e53f38c6bd2eb96b1dd2664e2dc352581a173651d126",
-    "src/components/button.ts": "affab78ead984c2d54511774758755a87e80ff6024faaf5027e82def40a2b940",
+    "src/components/button.ts": "b264845f4c340bd201e2d0c5b6765560194a859021b45f3b1e6009bfc1fc58ae",
     "src/components/content.ts": "018cd8cf8052a89c0b271fdc15b27fb6296bd26cb7303ff88d58c9bfb21bbd58",
     "src/components/date-picker.ts": "c2ea419ab9f949b984cced9cf2ab3f6710a5a2c269a65293ecbca1d2cdc9b9ef",
-    "src/components/forms.ts": "0f73509ca37f5c7e8b7fa8d5ac320baa5d95340928fb734839f5796355500fc4",
+    "src/components/forms.ts": "90ae25b7c2200b8292a7f94e8219a553a1c834472a5e34480ffbb6cccf270825",
     "src/components/foundation.ts": "fe56d963605e6fa9776127c152ed151d7abc1a5a0b6e2c02c69b7c859d57e432",
     "src/components/link.ts": "f5d4acc163c205b4dfabffc62084e236aa4759f91b041367a8a4a185cca0a9e4",
     "src/components/mobile-image-viewer.ts": "b94830d23de10de0e38b28ec04479f8a39090b5d339514b65ae0bf78757310d3",
@@ -280,10 +280,10 @@
     "src/core/preview-navigation.ts": "8de5cc0f62b16b0590f212de6f7bb234859ec483a612673a87dd8fe9e260a813",
     "src/core/ripple.ts": "cc5f14ee2e68c082ef26599e5945a7689551da134d34a97934876686d01650e9",
     "src/core/scroll-motion.ts": "408ba816cba1c142e84c9e7154fca6aba88da0dd4b5a21005f59e3e1f03c0eef",
-    "src/core/scrollbar.ts": "0b146d22df3b13923ec1a16df7b4f57ab3950271e5facc9ab360b08ceaf4249c",
+    "src/core/scrollbar.ts": "511e9edff132554d0799a7647b2b3e865a772d5fed2e6300a623073887d8b763",
     "src/core/speed-dial.ts": "7d2ebc5320df0357801dd58361701d51b34f71d67822098d64fea5748420962f",
     "src/index.ts": "bb98e0c5833fea023d5b9300ee3920e1b95274a48931a41e0d562e4f2cc96f9e",
-    "src/styles/base.css": "de5eb1c8a41f196e4a53884159ee6ab1a9276fd1aff0e1184aaf7889ffac8bda",
+    "src/styles/base.css": "d98f2da531be0725d33d4a151ee326b22cafe2401418fda0f2c9945beaed8d8b",
     "src/styles/content.css": "ac89cc1e7040b34c915af909a1a80185e0b88a4aa81e1cb6b3daa75a3aac7177",
     "src/styles/date-picker.css": "bfb9dd345b7041c059ca16b56e3e08f5cc575b069f82351b6a783bb42ad1fa8f",
     "src/styles/forms.css": "35bfbe5a1d729d89dddc9c62882d1971cc12b0859131d46d356e044d20bdcae5",
@@ -292,7 +292,7 @@
     "src/styles/ripple.css": "a16d40e8b7946dfdffa332ac2456cea6a9bf1cf7f5ace3ed5e9ae21afdeb1c45",
     "src/styles/scrollbar.css": "d32015b2bae6dca16759e88c299fcd9d9ed84df0be164b51f2eb31981fdbe5e7",
     "playground/App.vue": "f85c256ed21601ccb0681a3592237e357d48ec02af371491b90a83a32203828e",
-    "playground/ComponentDemo.vue": "61f82eb5eb550a73ca425938558a47b89d57bdafb6bf93c11ddd9bc8129e6230",
+    "playground/ComponentDemo.vue": "a599154820d13ffb19e9a661c0e208f1b0ef79a664f3a372eb7735fa486804cd",
     "playground/catalog.ts": "a27a875d316bcc8d0be523195a0b4e8e21279c7f33c8d2f024efaa8721e1518e",
     "playground/components/ComponentIndex.vue": "7938a3fe3efb521d6efab4fe64edef06d40f22ecd68481d20427a24c39b6683f",
     "playground/components/MasonryFeed.vue": "4882725da4211e2d39b782c839c7581a0672c815d12f146a8aee186df534ac68",
@@ -305,14 +305,14 @@
     "playground/editor/AppleInputExample.vue": "b563cdcb1ec6b033a3a19878f68e7fe4cf39da9d3e838887b591b2364e1aad90",
     "playground/editor/AppleInputPreview.vue": "e88a71316c62c4cb763d1f285b4b9fc8fbcb4a35c6282dc95b32d5824c87dc77",
     "playground/editor/ComponentDocumentLink.vue": "f4e1c88666b315a13e48386e9353c5da733fc149fba97ecc084804abd9d0067c",
-    "playground/editor/ComponentPlayground.vue": "b786d4735f2c92e8cd8ce063431b6530a844bd3d06eeef4b75f2051a95c7581b",
+    "playground/editor/ComponentPlayground.vue": "2f5543cc26d438afbda48347d802d8621161c24fad6ed7d7fe37a85e2113fdec",
     "playground/editor/ComponentWorkshop.vue": "0071a843cab7a8e25697c36755f911c8939c7657bd6264ec6c01a982da9f2647",
     "playground/editor/ConfigurableEditor.vue": "dfcecbfb031d6840b22dcd208b163e75ce4e3706af33d3637ecb2925a3e3f6c8",
     "playground/editor/LiveVueEditor.vue": "0559a63bba3dc2ffb2d54ad78e7b6c4577381280f3c08e1d3493e189fa6ff0d5",
     "playground/editor/apple-input-source.ts": "c97f63206e22f6f461d2883c8baa6157e2c44a3c6b6ce6f8d4529743b9280cd5",
     "playground/editor/apple-input.ts": "54546ef9b04c991e3bedd7f718cd4b03855d0ef9a7449ad4459be615d080a141",
     "playground/editor/component-metadata.ts": "43a4d37f112cbd76953092679862cea426f5f5adb6738169d25a5dffb91207c1",
-    "playground/editor/component-playground.ts": "aa20bae9be8d8b607da4d452d70204717287ccdff240c75eb954fe02053e352a",
+    "playground/editor/component-playground.ts": "caaca2c02d22e98da71928b9984039c9756c49e6acd05d490cae7fff73808cae",
     "playground/editor/contract.ts": "792b1e8b2d658297a4b48a1eaa1b697c59d4c0333a0629383e5f0f7a745bba1e",
     "playground/editor/documents.ts": "11eb5a22c3bdcbd6ef4cce4cd263339d388e71c2aff1c7dd01e6466dfebc161b",
     "playground/editor/handbook.ts": "6311187dd49aedb4fb232ded172bd09d2f9bf353f26e5e8f08a8d5e5d2e5d8bd",
@@ -327,7 +327,7 @@
     "playground/editor/handbooks/apple-back-top.ts": "9c25f3483e9c4cf42e8d23b4a0daa2b8b8b8488b90438b64d064705662882296",
     "playground/editor/handbooks/apple-badge.ts": "6543809f64aa6aeed1e1266a673a376999c268e7d3298c267e7df37c34953fca",
     "playground/editor/handbooks/apple-breadcrumbs.ts": "28b3734dd3acfb2b1246a840aae596e3885f72bb82e080462962f083e3a679a1",
-    "playground/editor/handbooks/apple-button.ts": "5ac2e05d7836877ab696e168cde1812cd8d4a838f9e5c766b61c881d883d4394",
+    "playground/editor/handbooks/apple-button.ts": "fe33f8f70ea2a9a443750f816115a932fab466f87a2be89c882a03716cfab689",
     "playground/editor/handbooks/apple-card.ts": "a1fdd55ccdb7f8f888640635631c002b58504984acbdbb76a0be8c58ea383a13",
     "playground/editor/handbooks/apple-cascader.ts": "873e0198af0fe6b9cfd8364c8d32d74a2214390d11d8d1f3f6ce8b6d2b5710c2",
     "playground/editor/handbooks/apple-checkbox.ts": "7b9e862613da46f8b22330ddd22bf6a3481b00d16078ecefb47bd3d392526b5e",
@@ -411,12 +411,12 @@
     "public/images/snow.jpg": "59fec6d2bbf9df11b7c697c57a253b7bd4b5a097489ce1017fb5209b9ee54b8e",
     "public/images/sunset.jpg": "4ee91e88f1e341143a807ef48fdfc24d63aa045d99351b4ea8ad7efcfef6ef9b",
     "public/images/waterfall.jpg": "cfd55ff5f41d3a58e91793d0e26a9ca90c86760aa401da033fbfa77d3364f238",
-    "docs/COMPONENTS.md": "4d2c0a28ac5ca66b10b268f0f1dd14a50e4db773633893c3a71dbe14292c5161",
+    "docs/COMPONENTS.md": "f7aa44e772c43183274796dc37702cc45264491b8e899b0775a03b58ff7efc6b",
     "docs/INPUT-WORKSHOP.md": "82ea6db156d2d9be4cfee233675b107c837aaa30a849f92010e988e1df7ce3a0",
     "docs/PLAYGROUND-TEMPLATE.md": "e476d6622e89d8cb04d9acdd54c090e5d559d666bb49f266bcf36d3f3bf8fe67",
     "docs/VALIDATION.md": "3c1755f4699d6b7d8febb44b2b0b00eb416b86559c26d8b69e46a1c98271af5f",
     "README.md": "d260354846c6be4ba32f6ba668c8654650684dff08ebe73b6b8bcc49462c0322",
-    "package.json": "1ab5eec6f73819d8f78a9c7fca93503627997909c01215735e993462f57baf8c",
+    "package.json": "0d4bda6cc60481867535cf25ad2185d7c00759ae8d6eced089b8d06543ce718d",
     "index.html": "75f6d93e3962ddca97a13b666a04d98ba9b263b6c288171383db764215034fea",
     "vite.config.ts": "988aa18f3adf428ee3e82a41422bf76771d91b7fc3738ed36d731a497022f049",
     "vite.lib.config.ts": "d7bc7e47f18ea4257eb1dafd8ed895f47cad8f756157cfa9a6e98b30086b1c72",

package/templates/playground/src/ComponentDemo.vue

@@ -1,17 +1,19 @@
 <template>
   <div class="component-demo" :class="demoClass" :data-component="name">
     <apple-stack v-if="name === 'AppleButton'" direction="row" align="center">
-      <apple-button @click="notify('操作已完成')">继续</apple-button>
-      <apple-button variant="secondary" @click="notify('已选择次要操作')">稍后再说</apple-button>
-      <apple-button variant="outline" @click="notify('已加入收藏')">加入收藏</apple-button>
-      <apple-link as="button" :icon="icons.ArrowUpRight" @click="notify('正在查看详情')">了解更多</apple-link>
-      <apple-button :icon="icons.Plus" icon-only label="添加" @click="notify('已添加')" />
-      <apple-button loading>处理中</apple-button><apple-button disabled>暂不可用</apple-button>
+      <apple-tooltip text="primary"><apple-button @click="notify('操作已完成')">继续</apple-button></apple-tooltip>
+      <apple-tooltip text="secondary"><apple-button variant="secondary" @click="notify('已选择次要操作')">稍后再说</apple-button></apple-tooltip>
+      <apple-tooltip text="outline"><apple-button variant="outline" @click="notify('已加入收藏')">加入收藏</apple-button></apple-tooltip>
+      <apple-tooltip text="borderless"><apple-button variant="borderless" @click="notify('已选择无边框操作')">无边框</apple-button></apple-tooltip>
+      <apple-tooltip text='AppleLink · as="button"'><apple-link as="button" :icon="icons.ArrowUpRight" @click="notify('正在查看详情')">了解更多</apple-link></apple-tooltip>
+      <apple-tooltip text="primary · iconOnly"><apple-button :icon="icons.Plus" icon-only label="添加" @click="notify('已添加')" /></apple-tooltip>
+      <apple-tooltip text="primary · loading"><apple-button loading>处理中</apple-button></apple-tooltip>
+      <apple-tooltip text="primary · disabled"><apple-button disabled>暂不可用</apple-button></apple-tooltip>
     </apple-stack>
     <apple-stack v-else-if="name === 'AppleLink'" direction="row" align="center">
-      <apple-link href="https://www.apple.com.cn/" external>Apple 官网</apple-link>
-      <apple-link href="https://www.apple.com.cn/accessibility/" external>辅助功能</apple-link>
-      <apple-link disabled external>暂不可用</apple-link>
+      <apple-tooltip text="external"><apple-link href="https://www.apple.com.cn/" external>Apple 官网</apple-link></apple-tooltip>
+      <apple-tooltip text="external"><apple-link href="https://www.apple.com.cn/accessibility/" external>辅助功能</apple-link></apple-tooltip>
+      <apple-tooltip text="external · disabled"><apple-link disabled external>暂不可用</apple-link></apple-tooltip>
     </apple-stack>
     <apple-stack v-else-if="name === 'AppleSearch'">
       <apple-search v-model="searchText" label="搜索设置" placeholder="搜索设置" @search="notify(searchText ? `正在搜索：${searchText}` : '显示全部设置')" />

package/templates/playground/src/editor/ComponentPlayground.vue

@@ -11,6 +11,7 @@
               <AppleSelect v-else-if="controls[entry.name].kind === 'select'" :model-value="String(config.props[entry.name].value)" @update:model-value="config.props[entry.name].value = String($event)" :items="controls[entry.name].options.map(value => ({ label: value, value }))" :label="entry.name" :disabled="!config.props[entry.name].enabled" />
               <AppleTextarea v-else-if="['json', 'expression'].includes(controls[entry.name].kind)" :model-value="String(config.props[entry.name].value)" @update:model-value="config.props[entry.name].value = String($event)" :label="entry.name" :hint="controls[entry.name].kind === 'json' ? 'JSON' : 'JavaScript 表达式'" :rows="3" :error="errors[entry.name] || ''" :disabled="!config.props[entry.name].enabled" />
               <AppleInput v-else :model-value="String(config.props[entry.name].value)" @update:model-value="config.props[entry.name].value = String($event)" :label="entry.name" :error="errors[entry.name] || ''" :disabled="!config.props[entry.name].enabled" />
+              <blockquote v-if="doc.name === 'AppleButton' && entry.name === 'href' && config.props.href.enabled" class="sandbox-note">沙箱预览不支持打开外部链接；在实际页面中，href 可正常跳转。</blockquote>
             </div>
           </div>
           <AppleAccordion v-if="doc.slots.length" :items="[{ label: '插槽', value: 'slots' }]">
@@ -84,6 +85,7 @@ onBeforeUnmount(() => clearTimeout(updateTimer))
 .config-heading h3 { margin: 0; font-size: 16px; overflow-wrap: anywhere; }
 .config-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 20px; }
 .prop-control { display: grid; align-content: start; gap: 10px; min-width: 0; }
+.sandbox-note { margin: 0; padding-left: 12px; border-left: 2px solid var(--apple-border); color: var(--apple-secondary); font-size: 12px; line-height: 1.7; }
 .slot-control + .slot-control { border-top: 1px solid var(--apple-border); padding-top: 20px; }
 @media (max-width: 1100px) { .config-grid { grid-template-columns: minmax(0, 1fr); } }
 </style>

package/templates/playground/src/editor/component-playground.ts

@@ -149,6 +149,7 @@ ${component}
 <style scoped>
 .example { display: grid; gap: 28px; padding: 28px 24px; min-width: 0; }
 .component-section { display: grid; gap: 20px; min-width: 0; }
+.component-section > :deep(.apple-button) { justify-self: start; }
 .actions { display: flex; flex-wrap: wrap; gap: 20px; }
 .events-section { border-top: 1px solid var(--apple-border); padding-top: 20px; min-width: 0; }
 .event-heading { display: flex; align-items: center; justify-content: space-between; margin-bottom: 12px; }

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

@@ -12,15 +12,15 @@ export default defineHandbook({
     },
     {
       "name": "variant",
-      "type": "'primary' | 'secondary' | 'outline' | 'danger'",
+      "type": "'primary' | 'secondary' | 'outline' | 'borderless' | 'danger'",
       "default": "\"primary\"",
-      "description": "primary 为主要操作，secondary 和 outline 为描边按钮，danger 为危险操作。"
+      "description": "primary 为主要操作，secondary 和 outline 为描边按钮，borderless 无背景和边框、悬停时显示灰色背景，danger 为危险操作。"
     },
     {
       "name": "size",
       "type": "'small' | 'medium' | 'large'",
       "default": "\"medium\"",
-      "description": "按钮尺寸：small、medium、large。"
+      "description": "按钮尺寸：small、medium、large。窄屏下 small 保留至少 44px 的触控高度。"
     },
     {
       "name": "icon",
@@ -32,7 +32,7 @@ export default defineHandbook({
       "name": "iconOnly",
       "type": "boolean",
       "default": "false",
-      "description": "紧凑的纯图标布局。用 label 为按钮提供可访问名称。"
+      "description": "纯图标布局；提供 icon 或加载中时自动隐藏默认插槽文字，未提供 icon 时可用默认插槽放图标。用 label 提供可访问名称。"
     },
     {
       "name": "label",
@@ -62,13 +62,13 @@ export default defineHandbook({
       "name": "href",
       "type": "string",
       "default": "undefined",
-      "description": "非空且可用时渲染为 a；禁用或加载时渲染为 button，移除 href。"
+      "description": "链接地址，非空且可用时渲染为 a 并原生跳转；禁用或加载时移除 href。"
     },
     {
       "name": "type",
       "type": "'button' | 'submit' | 'reset'",
       "default": "\"button\"",
-      "description": "原生按钮类型。仅在渲染为 button 时使用，默认 button，避免意外提交表单。"
+      "description": "原生按钮类型：button 仅触发点击，submit 提交关联表单，reset 将关联表单控件恢复初始值。默认 button；渲染为 a 时不使用此属性。"
     }
   ],
   "events": [

package/templates/playground/tooling/playground-editor.mjs

@@ -1,7 +1,7 @@
 import { build } from 'esbuild'
 import { readFile } from 'node:fs/promises'
 import { createRequire } from 'node:module'
-import { resolve } from 'node:path'
+import { resolve, sep } from 'node:path'
 import { existsSync } from 'node:fs'
 import { createHash } from 'node:crypto'
 import { parse, compileScript, compileStyle } from 'vue/compiler-sfc'
@@ -74,8 +74,9 @@ export default function playgroundEditor({ appDir = 'playground', libraryDir = '
       return { code, map: null }
     },
     async handleHotUpdate(ctx) {
-      const source = libraryDir ? resolve(config.root, libraryDir) + '/' : undefined
-      if (!(source && ctx.file.startsWith(source)) && ctx.file !== resolve(config.root, appDir, 'editor/runtime.ts')) return
+      const source = libraryDir ? resolve(config.root, libraryDir) + sep : undefined
+      const changedFile = resolve(ctx.file)
+      if (!(source && changedFile.startsWith(source)) && changedFile !== resolve(config.root, appDir, 'editor/runtime.ts')) return
       // Preview resources are an in-memory bundle, separate from Vite's normal CSS HMR.
       // Rebuild it when library files change, then recreate the preview realm.
       await rebuild()

package/tooling/playground-editor.mjs

@@ -1,7 +1,7 @@
 import { build } from 'esbuild'
 import { readFile } from 'node:fs/promises'
 import { createRequire } from 'node:module'
-import { resolve } from 'node:path'
+import { resolve, sep } from 'node:path'
 import { existsSync } from 'node:fs'
 import { createHash } from 'node:crypto'
 import { parse, compileScript, compileStyle } from 'vue/compiler-sfc'
@@ -74,8 +74,9 @@ export default function playgroundEditor({ appDir = 'playground', libraryDir = '
       return { code, map: null }
     },
     async handleHotUpdate(ctx) {
-      const source = libraryDir ? resolve(config.root, libraryDir) + '/' : undefined
-      if (!(source && ctx.file.startsWith(source)) && ctx.file !== resolve(config.root, appDir, 'editor/runtime.ts')) return
+      const source = libraryDir ? resolve(config.root, libraryDir) + sep : undefined
+      const changedFile = resolve(ctx.file)
+      if (!(source && changedFile.startsWith(source)) && changedFile !== resolve(config.root, appDir, 'editor/runtime.ts')) return
       // Preview resources are an in-memory bundle, separate from Vite's normal CSS HMR.
       // Rebuild it when library files change, then recreate the preview realm.
       await rebuild()