sky-ui-kit 0.1.11 → 0.1.13

package/README.md

@@ -1,10 +1,12 @@
 # sky-ui-kit 组件与样式库
-
-## AI 接入入口：先选择使用方式
-
-当用户要求引入 sky-ui-kit 时，先读取当前安装包的 llms.txt 和 [原生 HTML 接入与迁移](docs/HTML-INTEGRATION.md)，检查项目和真实 exports。原生 HTML 路线统一库支持的控件样式，保留原 DOM、事件和表单行为，无需 Vue。仅在用户明确需要真实 Vue 组件时，才选择 Vue 直接接入或局部挂载。目标不明确时询问；接入后合并项目 AGENTS.md 规则，按实际视觉状态和业务行为验收，不能只以安装成功或 CSS 已加载作为完成依据。
-
-HTML 按需入口从 0.1.10 提供；0.1.9 使用完整 model-workspace.css。示例网站快速开始下方提供“HTML 按需样式接入”演示和完整可复制代码。
+
+## AI 接入入口：先询问用户
+
+创建 Vue 项目时还需询问地图一张图、系统管理或组合模板，见 [Vue 起步模板](docs/VUE-TEMPLATES.md)；用户未选择时不得自行生成其他业务工作台。
+
+当用户要求引入 sky-ui-kit 时，必须先读取[引导式接入流程](docs/START-HERE.md)，先询问用户接入 HTML/JavaScript 还是 Vue，再询问页面范围及接入目标，等待回答后配置。不得仅根据项目文件猜测路线；用户在当前对话已经明确的答案不重复询问。HTML 换肤保留原 DOM、业务事件和表单，不要求 Vue。按所选路线读取后续指南并合并项目 AGENTS.md；不能以安装成功或 CSS 已加载代替视觉及行为验收。
+
+HTML 按需入口从 0.1.10 提供；0.1.9 使用完整 model-workspace.css。示例网站快速开始下方提供“HTML 按需样式接入”演示和完整可复制代码。
 
 组件用途、数据约定、事件语义和限制见 [组件使用说明](docs/COMPONENT-GUIDE.md)；完整类型与默认值见 [组件 API](docs/COMPONENT-API.md)。
 
@@ -89,12 +91,12 @@ npm pack --dry-run
 
 `site-dist/` 是可部署的预览网站，`dist/` 是 npm 库产物。npm 包包含 dist 库产物、包内 AI/API/迁移文档、HTML 示例及 README；不包含预览网站、主题 store 运行时或原业务代码。
 
-## 当前发布状态与维护发布流程
-
-当前发布版本为 0.1.11，package.json 未设置 private 限制。HTML 按需样式和数字增强入口从 0.1.10 提供；0.1.11 包含相对链接修复、透明地图覆盖层及旧页面迁移文档和示例。已安装的 0.1.10 需升级后获得修订。
-
-消费项目无需执行库构建或发布操作。维护者仅在明确获得发布授权后，更新版本、运行 npm run docs:ai、类型检查和构建，核对包内文件后再发布。prepack 会生成文档并构建，不应把它当成纯检查命令。早期未发布状态见 [开发历史归档](docs/RELEASE-HISTORY.md)。
-
+## 当前发布状态与维护发布流程
+
+当前发布版本为 0.1.13，package.json 未设置 private 限制。HTML 按需样式和数字增强入口从 0.1.10 提供；0.1.12 增加先询问 HTML/Vue 的引导式接入流程；0.1.11 包含相对链接修复、透明地图覆盖层及旧页面迁移文档和示例。已安装的 0.1.10 需升级后获得修订。
+
+消费项目无需执行库构建或发布操作。维护者仅在明确获得发布授权后，更新版本、运行 npm run docs:ai、类型检查和构建，核对包内文件后再发布。prepack 会生成文档并构建，不应把它当成纯检查命令。早期未发布状态见 [开发历史归档](docs/RELEASE-HISTORY.md)。
+
 ## 样式隔离
 
 默认 style.css 只给库组件作用域设置样式，作用域之外的原生 Element Plus 不受库 CSS 覆盖。主动整站换肤才额外导入 global.css。浮层、局部变量和默认 teleported 差异见 [CSS-THEME.md](docs/CSS-THEME.md)。开发验证页：[样式隔离验证](http://127.0.0.1:5180/isolation.html)。
@@ -106,4 +108,7 @@ npm pack --dry-run
 包内提供 llms.txt、llms-full.txt、components.json 和 docs/AI-GUIDE.md、docs/COMPONENT-API.md。让 AI 工具读取 node_modules/sky-ui-kit/llms.txt 开始，再按链接读取详细 API。文档不会随 npm install 自动进入 AI 上下文。项目组件 API 根据源码生成，Ui 基础组件关联 Element Plus 官方 API 和类型声明。
 
 
-早期 0.1.7 安装说明已移至 [开发历史归档](docs/RELEASE-HISTORY.md)。
+早期 0.1.7 安装说明已移至 [开发历史归档](docs/RELEASE-HISTORY.md)。
+
+
+0.1.13 提供完整 Vue 起步项目：一张图、预报、系统设置。详见 [模板说明](docs/VUE-TEMPLATES.md)，复制包内 examples/vue-starter 即可开始。

package/components.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "sky-ui-kit",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "elementPlusVersion": "2.14.7",
   "setup": {
     "cssOnce": [
@@ -2229,6 +2229,18 @@
           "required": false,
           "defaultExpression": "false"
         },
+        {
+          "name": "embedded",
+          "type": "boolean",
+          "required": false,
+          "defaultExpression": "false"
+        },
+        {
+          "name": "showTools",
+          "type": "boolean",
+          "required": false,
+          "defaultExpression": "true"
+        },
         {
           "name": "title",
           "type": "string",
@@ -4340,6 +4352,151 @@
       ],
       "source": "src/components/ModelWorkspacePanel.vue"
     },
+    {
+      "name": "PlatformLayout",
+      "kind": "project-component",
+      "importFrom": "sky-ui-kit",
+      "props": [
+        {
+          "name": "mode",
+          "type": "'map' | 'management'",
+          "required": false,
+          "defaultExpression": "'map'"
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "required": false,
+          "defaultExpression": "'业务平台'"
+        },
+        {
+          "name": "active",
+          "type": "string",
+          "required": false,
+          "defaultExpression": "''"
+        },
+        {
+          "name": "items",
+          "type": "ProjectMenuItem[]",
+          "required": false,
+          "defaultExpression": "()=>[]"
+        },
+        {
+          "name": "groups",
+          "type": "ProjectMenuGroup[]",
+          "required": false,
+          "defaultExpression": "()=>[]"
+        },
+        {
+          "name": "menuActive",
+          "type": "string",
+          "required": false,
+          "defaultExpression": "''"
+        },
+        {
+          "name": "sidebarOpen",
+          "type": "boolean",
+          "required": false,
+          "defaultExpression": "true"
+        }
+      ],
+      "events": [
+        {
+          "name": "update:active",
+          "type": "[key:string]",
+          "required": true
+        },
+        {
+          "name": "update:menuActive",
+          "type": "[key:string]",
+          "required": true
+        },
+        {
+          "name": "update:sidebarOpen",
+          "type": "[open:boolean]",
+          "required": true
+        },
+        {
+          "name": "select",
+          "type": "[item:ProjectMenuItem]",
+          "required": true
+        }
+      ],
+      "slots": [
+        "map",
+        "brand",
+        "region",
+        "utilities",
+        "sidebar-heading",
+        "sidebar",
+        "sidebar-footer",
+        "default"
+      ],
+      "types": [],
+      "source": "src/components/PlatformLayout.vue"
+    },
+    {
+      "name": "MapCategoryMenu",
+      "kind": "project-component",
+      "importFrom": "sky-ui-kit",
+      "props": [
+        {
+          "name": "groups",
+          "type": "{ key: string; label: string; items: MapMenuItem[] }[]",
+          "required": true,
+          "defaultExpression": null
+        },
+        {
+          "name": "activeGroup",
+          "type": "string",
+          "required": false,
+          "defaultExpression": "''"
+        },
+        {
+          "name": "active",
+          "type": "string",
+          "required": false,
+          "defaultExpression": "''"
+        },
+        {
+          "name": "compact",
+          "type": "boolean",
+          "required": false,
+          "defaultExpression": "false"
+        },
+        {
+          "name": "dark",
+          "type": "boolean",
+          "required": false,
+          "defaultExpression": "false"
+        }
+      ],
+      "events": [
+        {
+          "name": "update:activeGroup",
+          "type": "[key: string]",
+          "required": true
+        },
+        {
+          "name": "update:active",
+          "type": "[key: string]",
+          "required": true
+        },
+        {
+          "name": "update:compact",
+          "type": "[value: boolean]",
+          "required": true
+        },
+        {
+          "name": "select",
+          "type": "[selection: { groupKey: string; item: MapMenuItem }]",
+          "required": true
+        }
+      ],
+      "slots": [],
+      "types": [],
+      "source": "src/components/MapCategoryMenu.vue"
+    },
     {
       "name": "UiAffix",
       "kind": "element-plus-component",

package/dist/chunks/{UiScrollbar-67b064c7.js → UiScrollbar-450d1521.js}

@@ -60,123 +60,123 @@ function E(i) {
 }
 const De = /* @__PURE__ */ e(s.ElScrollbar);
 export {
-  ms as $,
-  V as A,
-  j as B,
-  O as C,
-  _ as D,
-  z as E,
-  W as F,
-  Z as G,
-  J as H,
-  K as I,
-  Q as J,
-  X as K,
-  Y as L,
-  $ as M,
-  es as N,
-  as as O,
-  ts as P,
-  os as Q,
-  is as R,
-  ns as S,
-  ls as T,
-  y as U,
-  cs as V,
-  rs as W,
-  Es as X,
-  Us as Y,
-  ps as Z,
-  us as _,
-  v as a,
-  ve as a$,
-  ds as a0,
-  Cs as a1,
-  gs as a2,
-  Ts as a3,
-  Ss as a4,
-  Ps as a5,
-  Is as a6,
-  bs as a7,
-  ks as a8,
-  hs as a9,
-  se as aA,
-  ee as aB,
-  ae as aC,
-  te as aD,
-  oe as aE,
-  ie as aF,
-  ne as aG,
-  le as aH,
-  ce as aI,
-  re as aJ,
-  Ee as aK,
-  pe as aL,
-  ue as aM,
-  me as aN,
-  de as aO,
-  Ce as aP,
-  ge as aQ,
-  Te as aR,
-  Se as aS,
-  fe as aT,
-  Pe as aU,
-  Ie as aV,
-  be as aW,
-  ke as aX,
-  g as aY,
-  he as aZ,
-  Ae as a_,
-  As as aa,
-  vs as ab,
-  Ds as ac,
-  ws as ad,
-  Bs as ae,
-  Ms as af,
-  xs as ag,
-  Rs as ah,
-  Ls as ai,
-  Gs as aj,
-  ys as ak,
-  Vs as al,
-  js as am,
-  Fs as an,
-  Ns as ao,
-  Hs as ap,
-  Os as aq,
-  _s as ar,
-  zs as as,
-  Ws as at,
-  Zs as au,
-  Js as av,
-  Ks as aw,
-  Xs as ax,
-  Ys as ay,
-  $s as az,
-  q as b,
-  De as b0,
-  k as c,
-  ss as d,
-  N as e,
-  H as f,
-  qs as g,
-  I as h,
-  Ue as i,
-  F as j,
-  fs as k,
-  Qs as l,
-  f as m,
-  P as n,
-  b as o,
-  h as p,
-  A as q,
-  D as r,
-  w as s,
+  us as $,
+  G as A,
+  V as B,
+  j as C,
+  O as D,
+  _ as E,
+  z as F,
+  W as G,
+  Z as H,
+  J as I,
+  K as J,
+  Q as K,
+  X as L,
+  Y as M,
+  $ as N,
+  es as O,
+  as as P,
+  ts as Q,
+  os as R,
+  is as S,
+  ns as T,
+  De as U,
+  ls as V,
+  cs as W,
+  rs as X,
+  Es as Y,
+  Us as Z,
+  ps as _,
+  y as a,
+  Ae as a$,
+  ms as a0,
+  ds as a1,
+  Cs as a2,
+  gs as a3,
+  Ts as a4,
+  Ss as a5,
+  Ps as a6,
+  Is as a7,
+  bs as a8,
+  ks as a9,
+  $s as aA,
+  se as aB,
+  ee as aC,
+  ae as aD,
+  te as aE,
+  oe as aF,
+  ie as aG,
+  ne as aH,
+  le as aI,
+  ce as aJ,
+  re as aK,
+  Ee as aL,
+  pe as aM,
+  ue as aN,
+  me as aO,
+  de as aP,
+  Ce as aQ,
+  ge as aR,
+  Te as aS,
+  Se as aT,
+  fe as aU,
+  Pe as aV,
+  Ie as aW,
+  be as aX,
+  ke as aY,
+  g as aZ,
+  he as a_,
+  hs as aa,
+  As as ab,
+  vs as ac,
+  Ds as ad,
+  ws as ae,
+  Bs as af,
+  Ms as ag,
+  xs as ah,
+  Rs as ai,
+  Ls as aj,
+  Gs as ak,
+  ys as al,
+  Vs as am,
+  js as an,
+  Fs as ao,
+  Ns as ap,
+  Hs as aq,
+  Os as ar,
+  _s as as,
+  zs as at,
+  Ws as au,
+  Zs as av,
+  Js as aw,
+  Ks as ax,
+  Xs as ay,
+  Ys as az,
+  v as b,
+  ve as b0,
+  q as c,
+  k as d,
+  ss as e,
+  N as f,
+  H as g,
+  qs as h,
+  I as i,
+  Ue as j,
+  F as k,
+  fs as l,
+  Qs as m,
+  f as n,
+  P as o,
+  b as p,
+  h as q,
+  A as r,
+  D as s,
   e as t,
-  B as u,
-  M as v,
-  x as w,
-  R as x,
-  L as y,
-  G as z
+  w as u,
+  B as v,
+  M as w,
+  x,
+  R as y,
+  L as z
 };

package/dist/components/MapCategoryMenu.vue.d.ts

@@ -0,0 +1,36 @@
+import type { MapMenuItem } from './MapSideMenu.vue';
+type __VLS_Props = {
+    groups: {
+        key: string;
+        label: string;
+        items: MapMenuItem[];
+    }[];
+    activeGroup?: string;
+    active?: string;
+    compact?: boolean;
+    dark?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (selection: {
+        groupKey: string;
+        item: MapMenuItem;
+    }) => any;
+    "update:active": (key: string) => any;
+    "update:compact": (value: boolean) => any;
+    "update:activeGroup": (key: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((selection: {
+        groupKey: string;
+        item: MapMenuItem;
+    }) => any) | undefined;
+    "onUpdate:active"?: ((key: string) => any) | undefined;
+    "onUpdate:compact"?: ((value: boolean) => any) | undefined;
+    "onUpdate:activeGroup"?: ((key: string) => any) | undefined;
+}>, {
+    dark: boolean;
+    active: string;
+    compact: boolean;
+    activeGroup: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/MapPageLayout.vue.d.ts

@@ -13,23 +13,23 @@ type __VLS_Props = {
     timelineRight?: DesignLength;
     timelineBottom?: DesignLength;
 };
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {};
+declare var __VLS_7: {}, __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
-    left?: (props: typeof __VLS_1) => any;
+    left?: (props: typeof __VLS_7) => any;
 } & {
-    top?: (props: typeof __VLS_3) => any;
+    top?: (props: typeof __VLS_9) => any;
 } & {
-    toolbar?: (props: typeof __VLS_5) => any;
+    toolbar?: (props: typeof __VLS_11) => any;
 } & {
-    right?: (props: typeof __VLS_7) => any;
+    right?: (props: typeof __VLS_13) => any;
 } & {
-    legend?: (props: typeof __VLS_9) => any;
+    legend?: (props: typeof __VLS_15) => any;
 } & {
-    timeline?: (props: typeof __VLS_11) => any;
+    timeline?: (props: typeof __VLS_17) => any;
 } & {
-    content?: (props: typeof __VLS_13) => any;
+    content?: (props: typeof __VLS_19) => any;
 } & {
-    default?: (props: typeof __VLS_15) => any;
+    default?: (props: typeof __VLS_21) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "timeline-height": (height: number) => any;

package/dist/components/MapSideMenu.vue.d.ts

@@ -7,6 +7,8 @@ export interface MapMenuItem {
 }
 type __VLS_Props = {
     flat?: boolean;
+    embedded?: boolean;
+    showTools?: boolean;
     title?: string;
     active?: string;
     multiple?: boolean;
@@ -34,6 +36,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     multiple: boolean;
     active: string;
     items: MapMenuItem[];
+    embedded: boolean;
+    showTools: boolean;
     activeKeys: string[];
     compact: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/PlatformLayout.vue.d.ts

@@ -0,0 +1,55 @@
+import type { ProjectMenuItem, ProjectMenuGroup } from './ProjectMenu.vue';
+type __VLS_Props = {
+    mode?: 'map' | 'management';
+    title?: string;
+    active?: string;
+    items?: ProjectMenuItem[];
+    groups?: ProjectMenuGroup[];
+    menuActive?: string;
+    sidebarOpen?: boolean;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_15: {}, __VLS_17: {}, __VLS_27: {}, __VLS_36: {}, __VLS_38: {};
+type __VLS_Slots = {} & {
+    map?: (props: typeof __VLS_1) => any;
+} & {
+    brand?: (props: typeof __VLS_3) => any;
+} & {
+    region?: (props: typeof __VLS_5) => any;
+} & {
+    utilities?: (props: typeof __VLS_15) => any;
+} & {
+    'sidebar-heading'?: (props: typeof __VLS_17) => any;
+} & {
+    sidebar?: (props: typeof __VLS_27) => any;
+} & {
+    'sidebar-footer'?: (props: typeof __VLS_36) => any;
+} & {
+    default?: (props: typeof __VLS_38) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: ProjectMenuItem) => any;
+    "update:active": (key: string) => any;
+    "update:menuActive": (key: string) => any;
+    "update:sidebarOpen": (open: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: ProjectMenuItem) => any) | undefined;
+    "onUpdate:active"?: ((key: string) => any) | undefined;
+    "onUpdate:menuActive"?: ((key: string) => any) | undefined;
+    "onUpdate:sidebarOpen"?: ((open: boolean) => any) | undefined;
+}>, {
+    mode: "map" | "management";
+    title: string;
+    active: string;
+    items: ProjectMenuItem[];
+    groups: ProjectMenuGroup[];
+    menuActive: string;
+    sidebarOpen: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};