@tutti-os/workspace-file-reference 0.0.14 → 0.0.15

package/dist/react/index.js

@@ -9,8 +9,8 @@ import {
   prefetchReferenceTree,
   useWorkspaceFileReferencePickerView,
   workspaceFileReferenceDefaultExpandedDepth
-} from "../chunk-CD3YNHYJ.js";
-import "../chunk-7C3RZYQE.js";
+} from "../chunk-KSK6PILG.js";
+import "../chunk-HRC2MZ5H.js";
 export {
   ROOT_CHILDREN_KEY,
   collectVisibleTreeEntries,

package/dist/{referenceSourceAggregator-yyyLVOPi.d.ts → referenceSourceAggregator-B8ATnJOZ.d.ts}

@@ -31,6 +31,11 @@ interface ReferenceSourceAggregator {
     open(scope: ReferenceScope, node: ReferenceNode): Promise<void>;
     readPreview(scope: ReferenceScope, node: ReferenceNode): Promise<ReferencePreview | null>;
     resolveSelection(node: ReferenceNode): SelectedReference;
+    /**
+     * 把语义定位参数解析为某源内从根到目标分组的 NodeRef 路径(root → leaf)。
+     * 源未实现 locateTarget / 未找到时返回 null。需先 listSources/listRoot 触发源加载。
+     */
+    locateTarget(scope: ReferenceScope, sourceId: string, params: Record<string, string>): Promise<NodeRef[] | null>;
     /** 取已加载的源(用于读取 capabilities/metadata)。需先 listRoot 触发加载。 */
     getLoadedSource(sourceId: string): ReferenceSourceService | undefined;
 }

package/dist/ui/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WorkspaceFileReferenceCopy, WorkspaceFileReferenceAdapter, WorkspaceFileReference } from '../contracts/index.js';
+import { WorkspaceFileReferenceCopy, WorkspaceFileReferenceAdapter, WorkspaceFileReference, ReferenceLocateTarget } from '../contracts/index.js';
 import { JSX } from 'react';
-import { R as ReferenceSourceAggregator } from '../referenceSourceAggregator-yyyLVOPi.js';
+import { R as ReferenceSourceAggregator } from '../referenceSourceAggregator-B8ATnJOZ.js';
 
 interface WorkspaceFileReferencePickerProps {
     copy: WorkspaceFileReferenceCopy;
@@ -10,18 +10,45 @@ interface WorkspaceFileReferencePickerProps {
     onClose: () => void;
     onConfirm: (refs: WorkspaceFileReference[]) => void;
     open: boolean;
+    /**
+     * When true, the dialog is rendered inline (non-portaled, absolutely
+     * positioned) so it stays clipped within the nearest positioned ancestor —
+     * e.g. an agent GUI node window — instead of covering the whole viewport.
+     * Defaults to false (portal to body + cover the viewport).
+     */
+    scoped?: boolean;
     workspaceId: string;
 }
-declare function WorkspaceFileReferencePicker({ copy, fileAdapter, initialPath, onClose, onConfirm, open, workspaceId }: WorkspaceFileReferencePickerProps): react_jsx_runtime.JSX.Element | null;
+declare function WorkspaceFileReferencePicker({ copy, fileAdapter, initialPath, onClose, onConfirm, open, scoped, workspaceId }: WorkspaceFileReferencePickerProps): react_jsx_runtime.JSX.Element;
+
+/** 一个 navigable 源文件夹的折叠选区(文件已映射为 WorkspaceFileReference)。 */
+interface ReferenceBundleSelection {
+    sourceId: string;
+    nodeId: string;
+    displayName: string;
+    iconUrl?: string | null;
+    files: WorkspaceFileReference[];
+}
+interface ReferenceGroupedSelection {
+    files: WorkspaceFileReference[];
+    bundles: ReferenceBundleSelection[];
+}
 
 interface ReferenceSourcePickerProps {
     aggregator: ReferenceSourceAggregator;
     copy: WorkspaceFileReferenceCopy;
+    /** 可选:打开时直达某事项/应用分组(展开并聚焦)。 */
+    initialTarget?: ReferenceLocateTarget | null;
     onClose: () => void;
     onConfirm: (refs: WorkspaceFileReference[]) => void;
+    /**
+     * 可选:启用「文件夹=一个 bundle 节点」确认形态。提供时确认走 confirmGrouped,
+     * navigable 源的选中文件夹折叠成 bundle 回调,其余仍为单条文件。
+     */
+    onConfirmBundles?: (result: ReferenceGroupedSelection) => void;
     open: boolean;
     workspaceId: string;
 }
-declare function ReferenceSourcePicker({ aggregator, copy, onClose, onConfirm, open, workspaceId }: ReferenceSourcePickerProps): JSX.Element | null;
+declare function ReferenceSourcePicker({ aggregator, copy, initialTarget, onClose, onConfirm, onConfirmBundles, open, workspaceId }: ReferenceSourcePickerProps): JSX.Element | null;
 
-export { ReferenceSourcePicker, type ReferenceSourcePickerProps, WorkspaceFileReferencePicker, type WorkspaceFileReferencePickerProps };
+export { type ReferenceBundleSelection, type ReferenceGroupedSelection, ReferenceSourcePicker, type ReferenceSourcePickerProps, WorkspaceFileReferencePicker, type WorkspaceFileReferencePickerProps };