@gspwidget/wisedoc-mobile-selector 0.0.0-stage → 1.1.0

package/dist-lib/style.css

@@ -0,0 +1 @@
+.mobile-frame[data-v-1a3b612f]{--accent: #2660ff;font-family:PingFang SC,-apple-system,BlinkMacSystemFont,Microsoft YaHei,sans-serif;color:#1a1a1a;background:#fff;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased}.mobile-frame[data-v-1a3b612f],.mobile-frame[data-v-1a3b612f] *,.mobile-frame[data-v-1a3b612f] *:before,.mobile-frame[data-v-1a3b612f] *:after{box-sizing:border-box}button[data-v-1a3b612f]{font:inherit}button[data-v-1a3b612f]{cursor:pointer;-webkit-tap-highlight-color:transparent}button[data-v-1a3b612f]:focus-visible{outline:2px solid var(--accent);outline-offset:2px}.mobile-frame[data-v-1a3b612f]{display:flex;flex-direction:column;width:100%;height:100%;min-height:0;max-width:600px;margin:0 auto;background:#fff;overflow:hidden}.selector-sheet[data-v-1a3b612f]{display:flex;flex:1 1 auto;flex-direction:column;min-height:0;overflow:hidden;background:#fff}.sheet-header[data-v-1a3b612f]{position:relative;display:flex;flex:0 0 76px;align-items:center;justify-content:center;padding-top:4px}.sheet-header h1[data-v-1a3b612f]{margin:0;padding:0 48px;font-size:17px;font-weight:500;line-height:24px;letter-spacing:.3px}.header-back[data-v-1a3b612f],.header-close[data-v-1a3b612f]{position:absolute;top:18px;display:grid;width:44px;height:44px;padding:0;place-items:center;border:0;background:transparent;color:#1a1a1a}.header-back[data-v-1a3b612f]{left:0}.header-close[data-v-1a3b612f]{right:0}.header-icon[data-v-1a3b612f]{display:block;width:16px;height:16px}.tabs[data-v-1a3b612f],.breadcrumbs[data-v-1a3b612f]{display:flex;align-items:center;min-width:0}.tabs[data-v-1a3b612f]{flex:0 0 48px;height:48px;padding:0 16px;border-bottom:1px solid #e6e6e6;font-size:16px;line-height:24px;white-space:nowrap}.tab-active[data-v-1a3b612f]{position:relative;display:flex;align-items:center;height:48px;color:var(--accent);font-weight:500}.tab-active[data-v-1a3b612f]:after{position:absolute;bottom:0;left:0;width:100%;height:3px;border-radius:2px;background:linear-gradient(267deg,#2660ff,#3b82ff);content:""}.breadcrumbs[data-v-1a3b612f]{flex:0 0 56px;height:56px;gap:0;padding:8px 16px 0;overflow-x:auto;scrollbar-width:none;white-space:nowrap}.breadcrumbs[data-v-1a3b612f]::-webkit-scrollbar{display:none}.breadcrumbs button[data-v-1a3b612f]{flex:0 0 auto;max-width:min(47vw,176px);overflow:hidden;padding:0;border:0;background:transparent;color:#666;font-size:16px;line-height:24px;text-overflow:ellipsis;white-space:nowrap}.breadcrumbs .crumb-current[data-v-1a3b612f]{max-width:min(30vw,160px);color:#1a1a1a;font-weight:500}.crumb-divider[data-v-1a3b612f]{display:grid;flex:0 0 16px;place-items:center;width:16px;height:24px;color:#d1d1d1;font-size:16px;line-height:24px}.content-list[data-v-1a3b612f]{flex:1 1 auto;min-height:0;overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain;scrollbar-width:none}.content-list[data-v-1a3b612f]::-webkit-scrollbar{display:none}.root-list[data-v-1a3b612f]{padding-top:8px}.entry-row[data-v-1a3b612f]{display:flex;align-items:center;gap:12px;min-width:0;height:56px;padding:0 16px}.check-button[data-v-1a3b612f]{position:relative;display:grid;flex:0 0 24px;place-items:center;width:24px;height:24px;padding:0;border:0;background:transparent}.check-button[data-v-1a3b612f]:before{position:absolute;top:1px;right:1px;bottom:1px;left:1px;border:1px solid #999;border-radius:50%;background:#fff;content:""}.check-button.checked[data-v-1a3b612f]:before,.check-button.indeterminate[data-v-1a3b612f]:before{border-color:var(--accent);background:var(--accent)}.check-button.locked[data-v-1a3b612f]{cursor:not-allowed}.content-list:not(.selected-list) .check-button[data-v-1a3b612f]{margin-right:4px}.check-mark[data-v-1a3b612f]{position:relative;width:12px;height:7px;margin-top:-2px;transform:rotate(-45deg);border-left:2px solid #fff;border-bottom:2px solid #fff}.half-mark[data-v-1a3b612f]{position:relative;width:10px;height:2px;border-radius:1px;background:#fff}.entry-icon[data-v-1a3b612f]{flex:0 0 32px;width:32px;height:32px;object-fit:contain}.entry-name[data-v-1a3b612f]{flex:1 1 auto;min-width:0;overflow:hidden;padding:0;border:0;background:transparent;color:#1a1a1a;font-size:16px;font-weight:400;line-height:24px;text-align:left;text-overflow:ellipsis;white-space:nowrap}.row-next[data-v-1a3b612f]{display:grid;flex:0 0 28px;place-items:center;width:28px;height:44px;margin-right:-8px;padding:0;border:0;background:transparent}.right-chevron[data-v-1a3b612f]{display:inline-block;flex:0 0 auto;width:9px;height:9px;transform:rotate(-45deg);border-right:1.6px solid #a1a1a1;border-bottom:1.6px solid #a1a1a1}.status[data-v-1a3b612f]{display:flex;flex-direction:column;align-items:center;gap:14px;justify-content:center;min-height:160px;padding:24px;color:#777;font-size:14px;text-align:center}.status.error[data-v-1a3b612f]{color:#d9363e}.empty-state[data-v-1a3b612f]{min-height:240px;gap:16px;color:gray;font-size:14px;line-height:22px}.empty-state img[data-v-1a3b612f]{display:block;width:120px;height:100px}.status button[data-v-1a3b612f],.inline-error button[data-v-1a3b612f],.more-button[data-v-1a3b612f]{padding:0;border:0;background:transparent;color:var(--accent)}.more-button[data-v-1a3b612f]{display:block;width:100%;height:48px;font-size:14px}.more-button[data-v-1a3b612f]:disabled{color:#aaa}.inline-error[data-v-1a3b612f]{padding:12px 16px;color:#d9363e;font-size:13px;text-align:center}.selected-list[data-v-1a3b612f]{padding-top:0}.selected-list .entry-row[data-v-1a3b612f]{gap:12px}.selected-name[data-v-1a3b612f]{margin-right:auto}.remove-button[data-v-1a3b612f]{position:relative;display:grid;flex:0 0 32px;place-items:center;width:32px;height:44px;margin-right:-8px;margin-left:-4px;padding:0;border:0;background:transparent;font-size:0}.remove-button[data-v-1a3b612f]:before,.remove-button[data-v-1a3b612f]:after{position:absolute;width:14px;height:1.5px;background:#999;content:""}.remove-button[data-v-1a3b612f]:before{transform:rotate(45deg)}.remove-button[data-v-1a3b612f]:after{transform:rotate(-45deg)}.footer-bar[data-v-1a3b612f]{display:flex;flex:0 0 64px;align-items:center;gap:16px;height:64px;margin:0;padding:0 16px;border-top:1px solid #e6e6e6;background:rgba(255,255,255,.95)}.selection-summary[data-v-1a3b612f]{display:flex;flex:1 1 auto;align-items:center;gap:8px;min-width:0;min-height:40px;padding:0;border:0;background:transparent;color:#1a1a1a;font-size:14px;line-height:24px;text-align:left}.summary-arrow[data-v-1a3b612f]{display:block;flex:0 0 12px;width:12px;height:12px;color:#999}.selection-summary .summary-label[data-v-1a3b612f]{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.summary-label strong[data-v-1a3b612f]{font-weight:500}.selection-summary[data-v-1a3b612f]:disabled{color:#777;cursor:default}.confirm-button[data-v-1a3b612f]{flex:0 0 64px;width:64px;height:32px;padding:0;border:0;border-radius:6px;background:var(--accent);color:#fff;font-size:14px;font-weight:500}.confirm-button[data-v-1a3b612f]:disabled{background:#aabfff}.notice[data-v-1a3b612f]{position:fixed;right:16px;bottom:80px;left:16px;max-width:500px;margin:0 auto;padding:10px 14px;border-radius:8px;background:rgba(0,0,0,.78);color:#fff;font-size:13px;text-align:center}@media (max-width: 350px){.entry-row[data-v-1a3b612f]{gap:9px;padding:0 12px}.entry-name[data-v-1a3b612f]{font-size:15px}.footer-bar[data-v-1a3b612f]{gap:8px;padding-right:12px;padding-left:12px}}

package/dist-lib/types/App.vue.d.ts

@@ -0,0 +1,48 @@
+import { type KnowledgeApiOptions } from './shared/data-source';
+import type { KnowledgeDataSource, KnowledgeSelection, KnowledgeSelectionResult } from './shared/types';
+declare function setSelection(value: unknown): void;
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    dataSource?: KnowledgeDataSource | undefined;
+    apiOptions?: KnowledgeApiOptions | undefined;
+    initialSelection?: KnowledgeSelection[] | undefined;
+    iframeMessaging?: boolean | undefined;
+}>, {
+    iframeMessaging: boolean;
+}>>, {
+    setSelection: typeof setSelection;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    error: (error: unknown) => void;
+    close: () => void;
+    confirm: (payload: KnowledgeSelectionResult, selections: KnowledgeSelection[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    dataSource?: KnowledgeDataSource | undefined;
+    apiOptions?: KnowledgeApiOptions | undefined;
+    initialSelection?: KnowledgeSelection[] | undefined;
+    iframeMessaging?: boolean | undefined;
+}>, {
+    iframeMessaging: boolean;
+}>>> & Readonly<{
+    onError?: ((error: unknown) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onConfirm?: ((payload: KnowledgeSelectionResult, selections: KnowledgeSelection[]) => any) | undefined;
+}>, {
+    iframeMessaging: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist-lib/types/demo-source.d.ts

@@ -0,0 +1,3 @@
+import type { KnowledgeDataSource } from './shared/types';
+/** Development-only visual fixture; production always uses the real API source. */
+export declare const demoSource: KnowledgeDataSource;

package/dist-lib/types/index.d.ts

@@ -0,0 +1,7 @@
+import type { MobileKnowledgeSelectorComponent } from './public-types';
+export declare const MobileKnowledgeSelector: MobileKnowledgeSelectorComponent;
+export default MobileKnowledgeSelector;
+export type { MobileKnowledgeSelectorProps } from './public-types';
+export { createKnowledgeDataSource, DEFAULT_KNOWLEDGE_SELECTOR_CONFIG_URL } from './shared/data-source';
+export type { KnowledgeApiConfig, KnowledgeApiOptions } from './shared/data-source';
+export type { KnowledgeKind, KnowledgeNode, KnowledgeSelection, KnowledgeSelectionResult, KnowledgeChildren, KnowledgeDataSource } from './shared/types';

package/dist-lib/types/public-types.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentOptionsMixin, DefineComponent } from 'vue';
+import type { KnowledgeApiOptions } from './shared/data-source';
+import type { KnowledgeDataSource, KnowledgeSelection, KnowledgeSelectionResult } from './shared/types';
+export interface MobileKnowledgeSelectorProps {
+    dataSource?: KnowledgeDataSource;
+    apiOptions?: KnowledgeApiOptions;
+    initialSelection?: KnowledgeSelection[];
+}
+export type MobileKnowledgeSelectorComponent = DefineComponent<MobileKnowledgeSelectorProps, {
+    setSelection(value: KnowledgeSelection[]): void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    confirm: (result: KnowledgeSelectionResult, selections: KnowledgeSelection[]) => void;
+    close: () => void;
+    error: (error: unknown) => void;
+}>;

package/dist-lib/types/shared/data-source.d.ts

@@ -0,0 +1,25 @@
+import type { AxiosInstance } from 'axios';
+import type { KnowledgeDataSource } from './types';
+export interface KnowledgeApiOptions {
+    /** Inject the host Axios instance to reuse authentication interceptors. */
+    http?: AxiosInstance;
+    baseURL?: string;
+    withCredentials?: boolean;
+    /** Resolve config, API and authentication URLs against the selector server when used as a remote script. */
+    serviceOrigin?: string;
+    /** Runtime configuration, useful when the host already loaded its own settings. */
+    config?: KnowledgeApiConfig;
+    /** Overrides the shared deploy-time JSON URL; an empty string disables file loading. */
+    configUrl?: string;
+}
+/** Shared static file under the 5300 service's web root, independent of the host app directory. */
+export declare const DEFAULT_KNOWLEDGE_SELECTOR_CONFIG_URL = "/subapp/wisedoc/knowledge-selector.config.json";
+export interface KnowledgeApiConfig {
+    /** true: /api/wisedoc/rest; false: /api/cms/cs/v1.0. Defaults to true. */
+    useWisedocApi?: boolean;
+    /** Optional origin or reverse-proxy prefix, e.g. https://host:5200 or /cms-proxy. */
+    apiBaseUrl?: string;
+}
+/** Uses the existing wisedoc/CMS endpoint contracts without depending on the host application. */
+export declare function createKnowledgeDataSource(options?: KnowledgeApiOptions): KnowledgeDataSource;
+export declare const knowledgeDataSource: KnowledgeDataSource;

package/dist-lib/types/shared/selection.d.ts

@@ -0,0 +1,14 @@
+import type { KnowledgeSelection } from './types';
+export declare const selectionKey: (item: KnowledgeSelection) => string;
+export declare function covers(parent: KnowledgeSelection, child: KnowledgeSelection): boolean;
+export declare function toSelection(item: KnowledgeSelection): KnowledgeSelection;
+/** Also validates iframe input before it becomes reactive application state. */
+export declare function normalizeSelection(value: unknown): KnowledgeSelection[];
+export declare function selectionState(item: KnowledgeSelection, selected: KnowledgeSelection[]): {
+    checked: boolean;
+    disabled: boolean;
+    indeterminate: boolean;
+    inheritedFrom: string | undefined;
+};
+export declare function toggleSelection(item: KnowledgeSelection, selected: KnowledgeSelection[]): KnowledgeSelection[];
+export declare function toIdResult(selected: KnowledgeSelection[]): import('./types').KnowledgeSelectionResult;

package/dist-lib/types/shared/types.d.ts

@@ -0,0 +1,34 @@
+export type KnowledgeKind = 'library' | 'directory' | 'document';
+/** A selected range, not an enumeration of every document it covers. */
+export interface KnowledgeSelection {
+    id: string;
+    /** Document attachment metadata ID(s). Present for document selections. */
+    attachments?: string;
+    type: KnowledgeKind;
+    name: string;
+    libraryId: string;
+    parentId: string | null;
+    /** Ordered from the library to the immediate parent; library itself has []. */
+    ancestorIds: string[];
+    includeDescendants: boolean;
+}
+export interface KnowledgeNode extends KnowledgeSelection {
+    icon?: string;
+    pathNames: string[];
+}
+export interface KnowledgeChildren {
+    directories: KnowledgeNode[];
+    documents: KnowledgeNode[];
+    /** Total before backend permission filtering; do not infer the last page from row count. */
+    total: number;
+}
+export interface KnowledgeDataSource {
+    getLibraries(signal?: AbortSignal): Promise<KnowledgeNode[]>;
+    getChildren(parent: KnowledgeNode, page: number, size: number, signal?: AbortSignal): Promise<KnowledgeChildren>;
+}
+/** Explicit selected scopes grouped by entity kind. DocIds contains document attachments values. */
+export interface KnowledgeSelectionResult {
+    KBIds: string[];
+    DirIds: string[];
+    DocIds: string[];
+}

package/npm/346/216/245/345/205/245/344/270/216/345/217/221/345/270/203/350/257/264/346/230/216.md

@@ -0,0 +1,165 @@
+# 移动端知识库选择组件：npm 接入与发布
+
+包名：`@gspwidget/wisedoc-mobile-selector`，本次版本：`1.1.0`。适用于 **Vue 3.4.38 及以上的 Vue 3 项目**，不支持 Vue 2，也不直接作为原生 App 组件运行；原生 App 可在 Vue WebView 页面中集成。
+
+该包只包含移动端选择组件、接口和选择逻辑、图标、组件样式及 TypeScript 类型，不包含独立页面、设计稿、示例项目、node_modules 或整个前端工程。Vue 由使用方工程提供，Axios 是 npm 安装时解析的运行依赖。原来的 iframe 页面仍可通过 `npm run build` 单独构建。
+
+## 1. 安装
+
+未发布时，把交付的 tgz 文件发给同事，在对方项目根目录执行（换成实际文件路径）：
+
+```powershell
+npm install 'D:\交付物\gspwidget-wisedoc-mobile-selector-1.1.0.tgz'
+```
+
+发布后：
+
+```powershell
+npm install @gspwidget/wisedoc-mobile-selector --registry=https://registry.npmjs.org/
+```
+
+## 2. Vue 页面直接使用
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { MobileKnowledgeSelector } from '@gspwidget/wisedoc-mobile-selector'
+import type { KnowledgeSelection, KnowledgeSelectionResult } from '@gspwidget/wisedoc-mobile-selector'
+import '@gspwidget/wisedoc-mobile-selector/style.css'
+
+const opened = ref(false)
+const selection = ref<KnowledgeSelection[]>([])
+
+function onConfirm(result: KnowledgeSelectionResult, selections: KnowledgeSelection[]) {
+  // result = { KBIds: string[], DirIds: string[], DocIds: string[] }
+  // DocIds 是文档 attachments 字段的原始字符串，不是文档主键。
+  console.log(result)
+  selection.value = selections // 下次打开时回显
+  opened.value = false
+}
+</script>
+
+<template>
+  <button @click="opened = true">选择知识库文件</button>
+  <div v-if="opened" class="kb-mask">
+    <div class="kb-panel">
+      <MobileKnowledgeSelector
+        :initial-selection="selection"
+        @confirm="onConfirm"
+        @close="opened = false"
+        @error="error => console.error(error)"
+      />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.kb-mask { position: fixed; inset: 0; z-index: 1000; display: flex; align-items: flex-end; background: rgb(0 0 0 / 40%); }
+.kb-panel { width: 100%; height: calc(100dvh - 44px); overflow: hidden; border-radius: 16px 16px 0 0; background: white; }
+</style>
+```
+
+也可以放进已有的 Popup / Dialog 内容区域，**必须给组件父容器明确高度**，组件使用 100% 高度，内部列表滚动；组件不创建遮罩，不设置宿主 body 或 #app 样式。底部操作栏固定 64px，紧贴容器底部，不再自动叠加 safe-area。如果宿主需要避开系统 Home 指示器，由宿主容器统一处理，避免重复留白。
+
+### Props、事件和回显
+
+| 名称 | 说明 |
+| --- | --- |
+| `initialSelection` | 可选 `KnowledgeSelection[]`，首次挂载时读取；传上次 `confirm` 的第二个参数用于回显 |
+| `apiOptions` | 可选接口选项，首次挂载时读取，见下一节 |
+| `dataSource` | 可选自定义 `KnowledgeDataSource`，优先于 `apiOptions` |
+| `@confirm` | 两个参数：`(result, selections)`；第一个只含 KBIds / DirIds / DocIds，第二个用于回显 |
+| `@close` | 点击右上角关闭按钮时触发，无参数，不提交本轮变更 |
+| `@error` | 数据加载失败时触发，参数为错误对象，界面保留重试入口 |
+| `ref.setSelection(selections)` | 组件实例方法，用于挂载后主动更新回显 |
+
+下钻时标题左侧返回上一级；已选列表的返回按钮回到之前的浏览位置。确定与关闭只发出事件，由宿主关闭自己的弹窗。示例使用 `v-if`，关闭时卸载，下次打开重建。若使用 `v-show` 保持实例，重新打开时可调用 `setSelection`；接口配置变化后请重新挂载。
+
+选择某知识库或目录即覆盖它的全部下级，下级不能单独取消；可以跨库混选。结果只列出显式选择的范围，不枚举所覆盖的全部子项。DocIds 中每个值保留对应 attachments 原始字符串，不按逗号拆分。
+
+## 3. 配置文件和接口地址
+
+默认仍从**宿主页面所在服务**读取：
+
+```text
+/subapp/wisedoc/knowledge-selector.config.json
+```
+
+配置不存在（404）时默认走 Wisedoc；配置格式错误或其他请求错误会显示加载错误。配置示例：
+
+```json
+{ "useWisedocApi": false, "apiBaseUrl": "/cms-proxy" }
+```
+
+`useWisedocApi` 缺省或为 true 时使用 Wisedoc；false 时使用 CMS，并保留 CMS 未登录认证、`Accept: text/html` 和会话建立等待逻辑。
+
+如果宿主也部署在 5300 的 web 目录下，无需配置 URL，不受宿主子目录影响。**npm 包安装位置不代表接口服务地址**。若宿主部署在另一个服务，而公共配置仍在 5300，显式提供接口选项：
+
+```ts
+const apiOptions = {
+  serviceOrigin: 'https://实际5300服务域名:5300',
+  withCredentials: true
+}
+// <MobileKnowledgeSelector :api-options="apiOptions" ... />
+```
+
+此时公共 JSON、相对 API 路径、认证路径都以该服务为基准，JSON 中的绝对 apiBaseUrl 仍按原配置使用。也支持 `config` 直接传配置（跳过 JSON）、`configUrl` 覆盖配置路径、`http` 注入 Axios 实例。一般保持默认即可。同源网关代理最省事；跨域请求的 CORS、Cookie 和认证跳转仍须由服务端配置，npm 集成本身不会消除接口跨域。
+
+## 4. 本工程构建和打包
+
+```powershell
+Set-Location 'D:\Java\doc\移动端选择\wisedoc-mobile-selector'
+npm ci
+npm test
+npm run build:lib
+npm run pack:lib
+```
+
+- `build:lib`：生成 `dist-lib/index.js`（ESM）、`index.cjs`（CommonJS）、`style.css` 和 `types/` 声明文件，供打包工具引入。
+- `pack:lib`：运行 `npm pack`，其 prepack 会自动重新执行 `build:lib`，然后按 package.json 的 files 白名单生成 `gspwidget-wisedoc-mobile-selector-1.1.0.tgz`。仅想生成 tgz，直接执行这一条即可。
+- `npm run build`：仍生成 iframe 独立页面 `dist/`，与 npm 包分开。
+
+## 5. 第一次发布到 npm 官方仓库（由你操作）
+
+`@gspwidget/widget-devkit` 是组织作用域下的一个包；本次会新增另一个包 `@gspwidget/wisedoc-mobile-selector`，不会覆盖 widget-devkit。你需要自己的 npm 账号，并请 @gspwidget 管理员为你授予该组织的创建/发布包权限。包名中的 @gspwidget 不能仅靠本地配置获得权限。若组织使用内部 registry，请先向管理员确认；以下命令明确针对 npm 官方仓库。
+
+1. 到 [npm 官网](https://www.npmjs.com/) 注册/登录账号，并按照页面提示启用发布所需的双因素认证。然后在终端登录（认证由你完成，不要将 token 写入交付物）：
+
+```powershell
+npm login --registry=https://registry.npmjs.org/
+npm whoami --registry=https://registry.npmjs.org/
+```
+
+2. 在项目目录检查包名、版本和实际将上传的文件。dry-run 不发布：
+
+```powershell
+npm pkg get name version
+npm run pack:lib
+npm publish ./gspwidget-wisedoc-mobile-selector-1.1.0.tgz --dry-run --access public --registry=https://registry.npmjs.org/
+```
+
+3. 确认预览后，发布已经检查过的同一个 tgz，按提示完成认证：
+
+```powershell
+npm publish ./gspwidget-wisedoc-mobile-selector-1.1.0.tgz --access public --registry=https://registry.npmjs.org/
+```
+
+`--access public` 表示任何人都能下载这个包。若希望仅公司人员访问，请由组织管理员确认私有包服务/权限后使用 restricted，勿直接执行公开发布命令。官方 scoped public 包的发布方式见 [npm 官方说明](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages/)。发布认证要求见 [npm 双因素认证说明](https://docs.npmjs.com/requiring-2fa-for-package-publishing-and-settings-modification/)。
+
+4. 检查发布结果，让同事执行前面的安装命令：
+
+```powershell
+npm view @gspwidget/wisedoc-mobile-selector version --registry=https://registry.npmjs.org/
+```
+
+若报 403，通常需要核对组织发布权限、包名归属或发布认证。后续更新不能覆盖已发布的同一版本。修改代码后可用下面的命令更新版本并重新打包（这些命令不执行 Git 操作）：
+
+```powershell
+npm pkg set version=1.1.1
+npm install --package-lock-only --ignore-scripts
+npm test
+npm run pack:lib
+# 然后对新生成的 1.1.1.tgz 做 dry-run 和 publish
+```
+
+本次只生成交付物，未登录或向 npm 上传任何包。

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@gspwidget/wisedoc-mobile-selector",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "Vue 3 移动端知识库、目录和文档选择组件",
+  "license": "UNLICENSED",
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 0.0.0.0 --port 4203",
+    "build": "vue-tsc --noEmit && vite build",
+    "build:page": "vue-tsc --noEmit && vite build",
+    "build:lib": "vue-tsc --noEmit && vite build --config vite.lib.config.ts && vue-tsc -p tsconfig.lib.json",
+    "pack:lib": "npm pack",
+    "prepack": "npm run build:lib",
+    "preview": "vite preview --host 0.0.0.0 --port 4203",
+    "test": "node tests/run-tests.mjs"
+  },
+  "main": "./dist-lib/index.cjs",
+  "module": "./dist-lib/index.js",
+  "types": "./dist-lib/types/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist-lib/types/index.d.ts", "import": "./dist-lib/index.js", "require": "./dist-lib/index.cjs" },
+    "./style.css": "./dist-lib/style.css"
+  },
+  "files": ["dist-lib", "README.md", "npm接入与发布说明.md"],
+  "sideEffects": ["**/*.css"],
+  "publishConfig": { "registry": "https://registry.npmjs.org/", "access": "public" },
+  "peerDependencies": { "vue": "^3.4.38" },
+  "dependencies": {
+    "axios": "^1.7.9"
+  },
+  "devDependencies": {
+    "vue": "^3.4.38",
+    "@types/node": "^20.19.0",
+    "@vitejs/plugin-vue": "^4.6.2",
+    "typescript": "~5.3.3",
+    "vite": "^4.5.5",
+    "vue-tsc": "^1.8.27"
+  }
+}