@orbit-work/ui 0.1.2-preview.0 → 0.1.3

package/dist/file-tree.css

@@ -0,0 +1,85 @@
+/* FileTree adapter for rc-tree.
+ *
+ * This is an additive profile: import styles/core.css first. rc-tree creates
+ * the prefixed descendants; FileTree's public root keeps the overrides scoped.
+ */
+@layer components {
+  [data-slot="file-tree"] ul {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-indent {
+    display: inline-flex;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-indent-unit {
+    display: inline-block;
+    width: 14px;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-treenode {
+    display: flex;
+    align-items: center;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-node-content-wrapper {
+    display: inline-flex;
+    align-items: center;
+    flex: 1;
+    min-width: 0;
+    min-height: 28px;
+    box-sizing: border-box;
+    padding: var(--ow-space-05, 2px) var(--ow-space-15, 6px) var(--ow-space-05, 2px) var(--ow-space-05, 2px);
+    border-radius: var(--ow-radius-control);
+    cursor: pointer;
+    user-select: none;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-node-content-wrapper:hover {
+    background: var(--ow-hover);
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-node-content-wrapper:active {
+    background: var(--ow-press);
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-node-content-wrapper:focus-visible {
+    outline: var(--ow-focus-ring-w) solid var(--ow-focus-ring);
+    outline-offset: var(--ow-focus-ring-offset);
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-node-content-wrapper.ow-file-tree-node-selected,
+  [data-slot="file-tree"] .ow-file-tree-treenode-selected > .ow-file-tree-node-content-wrapper {
+    background: var(--ow-current-bg);
+    color: var(--ow-text);
+    font-weight: 500;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-switcher {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 18px;
+    height: 28px;
+    flex-shrink: 0;
+    cursor: pointer;
+    color: var(--ow-text-3);
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-switcher.ow-file-tree-switcher-noop {
+    visibility: hidden;
+  }
+
+  [data-slot="file-tree"] .ow-file-tree-treenode-motion {
+    transition: height var(--ow-dur-2) var(--ow-ease-beacon);
+    overflow: hidden;
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [data-slot="file-tree"] .ow-file-tree-treenode-motion {
+      transition: none;
+    }
+  }
+}

package/dist/index-nLo7jMlP.d.cts

@@ -0,0 +1,166 @@
+import * as react from 'react';
+import { ReactNode, HTMLAttributes } from 'react';
+
+/** Host surface selected by the application; UI code never infers it. */
+type HostPlatform = "mac" | "windows" | "linux" | "web";
+
+type DesktopLoginStage = "welcome" | "qr" | "waiting-confirmation" | "mfa" | "success" | "expired" | "error";
+/** 联邦连接（钉钉/飞书/企业微信），由宿主经 Identity identity-providers 发现。 */
+interface LoginProviderOption {
+    id: string;
+    displayName: string;
+    /**
+     * 契约 IdentityProviderKind（identity.authentication.v1）的归一化枚举名——
+     * 主进程已把 protojson 的名字/数字两种线格式统一成枚举名，UI 只认枚举名；
+     * UNSPECIFIED/未来值由 providerBrandIcon 回落 Globe 通用入口。
+     */
+    kind?: LoginProviderKind;
+}
+/** 契约 kind 枚举名（与 packages/services 生成类型同一份字符串联合，本包自持副本）。 */
+type LoginProviderKind = "IDENTITY_PROVIDER_KIND_UNSPECIFIED" | "IDENTITY_PROVIDER_KIND_DINGTALK" | "IDENTITY_PROVIDER_KIND_FEISHU" | "IDENTITY_PROVIDER_KIND_WECOM";
+/** 正在展示的扫码登录 QR：src 是主进程编码好的 PNG data URL。 */
+interface DesktopLoginQr {
+    providerId: string;
+    providerName: string;
+    src: string;
+    /**
+     * 主进程为该 provider 生成的 PC 客户端唤起 deeplink（钉钉 page/link），
+     * 在场时 QR 下方出「在客户端中确认」按钮；缺省表示该 provider 不支持，
+     * 只有手机扫码一条路。消费方必须经宿主的 onOpenDesktopClient 打开，
+     * 组件自己不碰 window。
+     */
+    desktopOpenUrl?: string;
+}
+interface DesktopLoginLabels {
+    welcome: (brandName: string) => ReactNode;
+    identifierPlaceholder: string;
+    passwordPlaceholder: string;
+    signIn: string;
+    otherMethods: string;
+    providerLogin: (providerName: string) => string;
+    agreementPrefix: string;
+    terms: string;
+    agreementJoin: string;
+    privacy: string;
+    agreementSuffix: string;
+    back: string;
+    mfaCodePlaceholder: string;
+    mfaSubmit: string;
+    successTitle: string;
+    successPreparing: string;
+    qrTitle: (providerName?: string) => string;
+    qrImageAlt: (providerName: string) => string;
+    waitingLabel: string;
+    waitingDescription: (brandName: string) => ReactNode;
+    expiredTitle: string;
+    failedTitle: string;
+    retry: string;
+    openDesktopClient: string;
+    mobilePrompt: (providerName: string, alternate: boolean) => ReactNode;
+    defaultMobileApp: string;
+    expiresAt: (expiresText: string) => string;
+    expiresDefault: string;
+    waitingConfirmation: string;
+    waitingDestination: string;
+}
+interface DesktopLoginViewProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    stage: DesktopLoginStage;
+    /**
+     * 左 KV 板的摄影背景图 URL（宿主传 `rendererAsset("login_kv.jpeg")`）。
+     * 图上压一层 `.login-kv-scrim` 黑渐变保宣传语可读性；`onError` 触发兜底——
+     * 根节点加 `fallback` 类，KV 板换成品牌藏蓝 `--ow-navy` 平涂（不是渐变）。
+     * 不传等同于兜底。裁决 7：登录页采研发的照片版，不走 --ow-stage-* 平涂舞台。
+     */
+    backgroundSrc?: string;
+    /**
+     * 自带标志图 URL。缺省用包内 OrbitworkMark（variant="auto"，随 data-theme 走
+     * 品牌四色制两档）——外部图是单档固定色，暗档下不会跟随，能不传就不传。
+     */
+    markSrc?: string;
+    /**
+     * KV 板两行宣传语（品牌定制/白标场景）。缺省回落到导出的
+     * DESKTOP_LOGIN_CLAIM / DESKTOP_LOGIN_CLAIM_NOTE 常量。
+     */
+    claim?: string;
+    claimNote?: string;
+    /** 品牌名：驱动欢迎标题「欢迎使用 {brandName}」与底部读数「{brandName} · {appVersion}」；
+     *  缺省 "Orbitwork"。标志的 alt/label 也随它走。 */
+    brandName?: string;
+    expiresText?: string;
+    error?: string | null;
+    appVersion?: string;
+    onBack: () => void;
+    /**
+     * 密码登录（Identity signInWithPassword），欢迎面的主路径表单；
+     * 提交由宿主走 IPC，loading 用 passwordSubmitting。
+     */
+    onPasswordLogin?: (identifier: string, password: string) => void;
+    passwordSubmitting?: boolean;
+    /**
+     * 三方 IM 扫码登录（钉钉/飞书/企业微信）：联邦连接由宿主经 Identity
+     * identity-providers 发现后传入，欢迎面在密码表单下方渲染品牌按钮行；
+     * 点击后经 onQrLogin 走 `auth:begin-qr-login`，QR 图经 `qr` 传回展示。
+     */
+    providers?: LoginProviderOption[];
+    onQrLogin?: (connectionId: string) => void;
+    /** 正在发起 QR 登录的 connectionId（按钮 loading）；无活动请求时为 null。 */
+    qrRequesting?: string | null;
+    /** 当前展示的 QR：src 是主进程编码好的 PNG data URL（stage 为 qr 系时渲染）。 */
+    qr?: DesktopLoginQr | null;
+    /**
+     * 打开 provider PC 客户端唤起链接（qr.desktopOpenUrl）。宿主走受白名单约束的
+     * IPC；失败（未装客户端）时由宿主提示回落到手机扫码。
+     */
+    onOpenDesktopClient?: (url: string) => void;
+    /**
+     * MFA 续接：密码登录返回 secondFactor 后宿主把 stage 切到 "mfa"，
+     * 用户输入验证码/恢复码后通过 onCompleteMfa 提交。
+     */
+    onCompleteMfa?: (code: string) => void;
+    mfaSubmitting?: boolean;
+    /** MFA 页文案允许宿主接入 locale；缺省保持当前中文产品文案。 */
+    mfaTitle?: string;
+    mfaHeading?: string;
+    mfaDescription?: string;
+    /** 其余产品文案的 locale 注入口；未传字段保持当前中文默认值。 */
+    labels?: Partial<DesktopLoginLabels>;
+}
+/**
+ * Desktop 登录页的完整受控视图。认证、轮询和导航仍由宿主负责。
+ *
+ * 版面＝左 KV 摄影板 + 右表单 rail：
+ * - KV 板走 `backgroundSrc` 摄影图 ＋ `.login-kv-scrim` 黑渐变遮罩 ＋ 两行宣传语
+ *   （裁决 7「登录页相关的用研发的吧」：P6-1 的 --ow-stage-* 平涂舞台版作废）。
+ *   遮罩是 §5「无渐变」的具名例外——它压的是照片不是 UI 面，登记在
+ *   scripts/ds2-allowlist.json 的 gradient 键；图挂了走 `fallback`，兜底是品牌
+ *   藏蓝 --ow-navy 平涂（不是 V1 那道 #27C2FF→#5029FF 蓝紫渐变）。
+ * - rail 是普通 UI 面（--ow-bg），密码表单错误行走 InlineMessage，样式由同目录
+ *   DesktopLoginView.css 单点持有。
+ *   QR 失败态（expired/error）的提示与「重新登录」收在 QR 上的实心覆盖层
+ *   （.qr-veil.failed）：主文案一行＋可选错误小字＋主钮，覆盖层实心遮罩不洇边框。
+ *
+ * 现行登录路径＝账号密码表单（主）＋ 三方 IM 扫码（钉钉/飞书/企业微信，裸品牌图标
+ * 点击件）。公司账户浏览器登录（onStartLogin / requesting-auth）已整族删除：
+ * 内嵌 QR 方案下该路径是冗余废状态（docs/integration/desktop-qr-signin.md）。
+ *
+ * 荧黄记账（R2 裁决改写，原写的「全屏唯一一处」在暗档不成立）：本屏暗档有两处荧黄，
+ * 两处都合法、分属两类——
+ * - **行动极 ×1 ＝ 失败态「重新登录」钮**（`Button variant="primary"`，暗档
+ *   --ow-btn-primary-bg ＝ #FFD23E）。欢迎面主路径是 secondary「登录」钮，不占行动极；
+ *   §4 配额用在这里。
+ * - **品牌标志**：欢迎面 `OrbitworkMark` 的卫星点。标志是 §12 锁定件本体，
+ *   荧黄是它的构成而非某一极的落点，**不计入三极配额**（同 OrbitworkLogo / BeaconIcons
+ *   在 ds2-allowlist 里的 yellow 豁免口径）。
+ * KV 板不另放标志——同屏两枚标志会重复品牌记号。
+ * 状态极、位置极本屏 0 处。
+ */
+/**
+ * 登录 KV 板的两行宣传语——**全仓唯一出处**。
+ * R2 复审前它在 DesktopLoginView 的 JSX 与 DesktopLoginChassis 的 props 默认值里各写一份，
+ * 两份分头漂移；现由本处导出（Chassis 已随裁决 7 整件删除，本处仍是唯一出处）。
+ */
+declare const DESKTOP_LOGIN_CLAIM = "\u667A\u80FD\u5DE5\u4F5C\uFF0C\u4ECE\u767B\u5F55\u5F00\u59CB";
+declare const DESKTOP_LOGIN_CLAIM_NOTE = "\u8FDE\u63A5\u4F60\u7684\u56E2\u961F\u4E0E AI \u52A9\u624B";
+declare const DesktopLoginView: react.ForwardRefExoticComponent<DesktopLoginViewProps & react.RefAttributes<HTMLDivElement>>;
+
+export { DESKTOP_LOGIN_CLAIM as D, type HostPlatform as H, type LoginProviderKind as L, DESKTOP_LOGIN_CLAIM_NOTE as a, type DesktopLoginLabels as b, type DesktopLoginQr as c, type DesktopLoginStage as d, DesktopLoginView as e, type DesktopLoginViewProps as f, type LoginProviderOption as g };

package/dist/index-nLo7jMlP.d.ts

@@ -0,0 +1,166 @@
+import * as react from 'react';
+import { ReactNode, HTMLAttributes } from 'react';
+
+/** Host surface selected by the application; UI code never infers it. */
+type HostPlatform = "mac" | "windows" | "linux" | "web";
+
+type DesktopLoginStage = "welcome" | "qr" | "waiting-confirmation" | "mfa" | "success" | "expired" | "error";
+/** 联邦连接（钉钉/飞书/企业微信），由宿主经 Identity identity-providers 发现。 */
+interface LoginProviderOption {
+    id: string;
+    displayName: string;
+    /**
+     * 契约 IdentityProviderKind（identity.authentication.v1）的归一化枚举名——
+     * 主进程已把 protojson 的名字/数字两种线格式统一成枚举名，UI 只认枚举名；
+     * UNSPECIFIED/未来值由 providerBrandIcon 回落 Globe 通用入口。
+     */
+    kind?: LoginProviderKind;
+}
+/** 契约 kind 枚举名（与 packages/services 生成类型同一份字符串联合，本包自持副本）。 */
+type LoginProviderKind = "IDENTITY_PROVIDER_KIND_UNSPECIFIED" | "IDENTITY_PROVIDER_KIND_DINGTALK" | "IDENTITY_PROVIDER_KIND_FEISHU" | "IDENTITY_PROVIDER_KIND_WECOM";
+/** 正在展示的扫码登录 QR：src 是主进程编码好的 PNG data URL。 */
+interface DesktopLoginQr {
+    providerId: string;
+    providerName: string;
+    src: string;
+    /**
+     * 主进程为该 provider 生成的 PC 客户端唤起 deeplink（钉钉 page/link），
+     * 在场时 QR 下方出「在客户端中确认」按钮；缺省表示该 provider 不支持，
+     * 只有手机扫码一条路。消费方必须经宿主的 onOpenDesktopClient 打开，
+     * 组件自己不碰 window。
+     */
+    desktopOpenUrl?: string;
+}
+interface DesktopLoginLabels {
+    welcome: (brandName: string) => ReactNode;
+    identifierPlaceholder: string;
+    passwordPlaceholder: string;
+    signIn: string;
+    otherMethods: string;
+    providerLogin: (providerName: string) => string;
+    agreementPrefix: string;
+    terms: string;
+    agreementJoin: string;
+    privacy: string;
+    agreementSuffix: string;
+    back: string;
+    mfaCodePlaceholder: string;
+    mfaSubmit: string;
+    successTitle: string;
+    successPreparing: string;
+    qrTitle: (providerName?: string) => string;
+    qrImageAlt: (providerName: string) => string;
+    waitingLabel: string;
+    waitingDescription: (brandName: string) => ReactNode;
+    expiredTitle: string;
+    failedTitle: string;
+    retry: string;
+    openDesktopClient: string;
+    mobilePrompt: (providerName: string, alternate: boolean) => ReactNode;
+    defaultMobileApp: string;
+    expiresAt: (expiresText: string) => string;
+    expiresDefault: string;
+    waitingConfirmation: string;
+    waitingDestination: string;
+}
+interface DesktopLoginViewProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    stage: DesktopLoginStage;
+    /**
+     * 左 KV 板的摄影背景图 URL（宿主传 `rendererAsset("login_kv.jpeg")`）。
+     * 图上压一层 `.login-kv-scrim` 黑渐变保宣传语可读性；`onError` 触发兜底——
+     * 根节点加 `fallback` 类，KV 板换成品牌藏蓝 `--ow-navy` 平涂（不是渐变）。
+     * 不传等同于兜底。裁决 7：登录页采研发的照片版，不走 --ow-stage-* 平涂舞台。
+     */
+    backgroundSrc?: string;
+    /**
+     * 自带标志图 URL。缺省用包内 OrbitworkMark（variant="auto"，随 data-theme 走
+     * 品牌四色制两档）——外部图是单档固定色，暗档下不会跟随，能不传就不传。
+     */
+    markSrc?: string;
+    /**
+     * KV 板两行宣传语（品牌定制/白标场景）。缺省回落到导出的
+     * DESKTOP_LOGIN_CLAIM / DESKTOP_LOGIN_CLAIM_NOTE 常量。
+     */
+    claim?: string;
+    claimNote?: string;
+    /** 品牌名：驱动欢迎标题「欢迎使用 {brandName}」与底部读数「{brandName} · {appVersion}」；
+     *  缺省 "Orbitwork"。标志的 alt/label 也随它走。 */
+    brandName?: string;
+    expiresText?: string;
+    error?: string | null;
+    appVersion?: string;
+    onBack: () => void;
+    /**
+     * 密码登录（Identity signInWithPassword），欢迎面的主路径表单；
+     * 提交由宿主走 IPC，loading 用 passwordSubmitting。
+     */
+    onPasswordLogin?: (identifier: string, password: string) => void;
+    passwordSubmitting?: boolean;
+    /**
+     * 三方 IM 扫码登录（钉钉/飞书/企业微信）：联邦连接由宿主经 Identity
+     * identity-providers 发现后传入，欢迎面在密码表单下方渲染品牌按钮行；
+     * 点击后经 onQrLogin 走 `auth:begin-qr-login`，QR 图经 `qr` 传回展示。
+     */
+    providers?: LoginProviderOption[];
+    onQrLogin?: (connectionId: string) => void;
+    /** 正在发起 QR 登录的 connectionId（按钮 loading）；无活动请求时为 null。 */
+    qrRequesting?: string | null;
+    /** 当前展示的 QR：src 是主进程编码好的 PNG data URL（stage 为 qr 系时渲染）。 */
+    qr?: DesktopLoginQr | null;
+    /**
+     * 打开 provider PC 客户端唤起链接（qr.desktopOpenUrl）。宿主走受白名单约束的
+     * IPC；失败（未装客户端）时由宿主提示回落到手机扫码。
+     */
+    onOpenDesktopClient?: (url: string) => void;
+    /**
+     * MFA 续接：密码登录返回 secondFactor 后宿主把 stage 切到 "mfa"，
+     * 用户输入验证码/恢复码后通过 onCompleteMfa 提交。
+     */
+    onCompleteMfa?: (code: string) => void;
+    mfaSubmitting?: boolean;
+    /** MFA 页文案允许宿主接入 locale；缺省保持当前中文产品文案。 */
+    mfaTitle?: string;
+    mfaHeading?: string;
+    mfaDescription?: string;
+    /** 其余产品文案的 locale 注入口；未传字段保持当前中文默认值。 */
+    labels?: Partial<DesktopLoginLabels>;
+}
+/**
+ * Desktop 登录页的完整受控视图。认证、轮询和导航仍由宿主负责。
+ *
+ * 版面＝左 KV 摄影板 + 右表单 rail：
+ * - KV 板走 `backgroundSrc` 摄影图 ＋ `.login-kv-scrim` 黑渐变遮罩 ＋ 两行宣传语
+ *   （裁决 7「登录页相关的用研发的吧」：P6-1 的 --ow-stage-* 平涂舞台版作废）。
+ *   遮罩是 §5「无渐变」的具名例外——它压的是照片不是 UI 面，登记在
+ *   scripts/ds2-allowlist.json 的 gradient 键；图挂了走 `fallback`，兜底是品牌
+ *   藏蓝 --ow-navy 平涂（不是 V1 那道 #27C2FF→#5029FF 蓝紫渐变）。
+ * - rail 是普通 UI 面（--ow-bg），密码表单错误行走 InlineMessage，样式由同目录
+ *   DesktopLoginView.css 单点持有。
+ *   QR 失败态（expired/error）的提示与「重新登录」收在 QR 上的实心覆盖层
+ *   （.qr-veil.failed）：主文案一行＋可选错误小字＋主钮，覆盖层实心遮罩不洇边框。
+ *
+ * 现行登录路径＝账号密码表单（主）＋ 三方 IM 扫码（钉钉/飞书/企业微信，裸品牌图标
+ * 点击件）。公司账户浏览器登录（onStartLogin / requesting-auth）已整族删除：
+ * 内嵌 QR 方案下该路径是冗余废状态（docs/integration/desktop-qr-signin.md）。
+ *
+ * 荧黄记账（R2 裁决改写，原写的「全屏唯一一处」在暗档不成立）：本屏暗档有两处荧黄，
+ * 两处都合法、分属两类——
+ * - **行动极 ×1 ＝ 失败态「重新登录」钮**（`Button variant="primary"`，暗档
+ *   --ow-btn-primary-bg ＝ #FFD23E）。欢迎面主路径是 secondary「登录」钮，不占行动极；
+ *   §4 配额用在这里。
+ * - **品牌标志**：欢迎面 `OrbitworkMark` 的卫星点。标志是 §12 锁定件本体，
+ *   荧黄是它的构成而非某一极的落点，**不计入三极配额**（同 OrbitworkLogo / BeaconIcons
+ *   在 ds2-allowlist 里的 yellow 豁免口径）。
+ * KV 板不另放标志——同屏两枚标志会重复品牌记号。
+ * 状态极、位置极本屏 0 处。
+ */
+/**
+ * 登录 KV 板的两行宣传语——**全仓唯一出处**。
+ * R2 复审前它在 DesktopLoginView 的 JSX 与 DesktopLoginChassis 的 props 默认值里各写一份，
+ * 两份分头漂移；现由本处导出（Chassis 已随裁决 7 整件删除，本处仍是唯一出处）。
+ */
+declare const DESKTOP_LOGIN_CLAIM = "\u667A\u80FD\u5DE5\u4F5C\uFF0C\u4ECE\u767B\u5F55\u5F00\u59CB";
+declare const DESKTOP_LOGIN_CLAIM_NOTE = "\u8FDE\u63A5\u4F60\u7684\u56E2\u961F\u4E0E AI \u52A9\u624B";
+declare const DesktopLoginView: react.ForwardRefExoticComponent<DesktopLoginViewProps & react.RefAttributes<HTMLDivElement>>;
+
+export { DESKTOP_LOGIN_CLAIM as D, type HostPlatform as H, type LoginProviderKind as L, DESKTOP_LOGIN_CLAIM_NOTE as a, type DesktopLoginLabels as b, type DesktopLoginQr as c, type DesktopLoginStage as d, DesktopLoginView as e, type DesktopLoginViewProps as f, type LoginProviderOption as g };