@web-ppt/edit-core 0.5.0-beta.1 → 0.5.0-beta.7

package/dist/chart/dataset-merge.d.ts

@@ -0,0 +1,5 @@
+import type { ChartDatasetState } from './types';
+export declare function mergeChartDatasetState(source: ChartDatasetState, sparse: unknown): {
+    state: ChartDatasetState;
+    deferred: boolean;
+};

package/dist/chart/formula.d.ts

@@ -0,0 +1,13 @@
+export interface ChartCellRange {
+    readonly sheet: string;
+    readonly startColumn: number;
+    readonly startRow: number;
+    readonly endColumn: number;
+    readonly endRow: number;
+}
+export declare function columnNumber(name: string): number;
+export declare function columnName(value: number): string;
+/** 只接受单工作表 A1 范围；外部引用、名称、3D 引用和并集一律拒绝。 */
+export declare function parseChartFormula(formula: string | null): ChartCellRange | null;
+export declare function chartFormula(range: ChartCellRange): string;
+export declare function resizedChartFormula(formula: string | null, count: number): string | null;

package/dist/chart/identity-frames.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementId } from '../types';
+import type { ChartIdentityScopes } from './identity-scopes';
+/** 部件只保存一份数据；原框架的身份前缀按 OPC 定位持久化，避免重开时都变成首框架的身份。 */
+export declare function chartIdentityScopes(doc: EditDoc, part: string, source: Uint8Array, owner: ElementId): ChartIdentityScopes | undefined;

package/dist/chart/identity-scopes.d.ts

@@ -0,0 +1,6 @@
+export interface ChartIdentityScopes {
+    readonly prefix: string;
+    readonly frames: readonly (readonly [string, string])[];
+}
+export declare function readIdentityScopes(value: unknown): ChartIdentityScopes | undefined;
+export declare function scopedIdentity(value: unknown, scope: ChartIdentityScopes | undefined, prefix: string): unknown;

package/dist/chart/identity.d.ts

@@ -0,0 +1,24 @@
+import type { XmlElement } from '@web-ppt/edit-core/xml';
+import type { ChartDatasetState, ChartPlotKind, ChartPointId, ChartSeriesId } from './types';
+import type { ChartIdentityScopes } from './identity-scopes';
+import type { CategoryOrientation } from './category-binding';
+export declare const CHART_IDENTITY_URI = "urn:web-ppt:chart-data-identities:v1";
+export interface ChartIdentityManifest {
+    readonly categoryOrientation?: CategoryOrientation;
+    readonly scopes?: ChartIdentityScopes;
+    readonly categories: readonly ChartPointId[];
+    readonly series: readonly {
+        readonly id: ChartSeriesId;
+        readonly points: readonly ChartPointId[];
+    }[];
+    readonly templates: readonly ChartIdentityTemplate[];
+}
+export interface ChartIdentityTemplate {
+    readonly id: ChartSeriesId;
+    readonly plotKind: ChartPlotKind;
+    readonly sourceIndex: number;
+    readonly points: readonly ChartPointId[];
+    readonly node: XmlElement;
+}
+export declare function readChartIdentityManifest(root: XmlElement, frameKey?: string, fallbackPrefix?: string): ChartIdentityManifest | null;
+export declare function writeChartIdentityManifest(root: XmlElement, state: ChartDatasetState, physicalSeriesOrder?: readonly ChartSeriesId[], templates?: readonly ChartIdentityTemplate[], scopes?: ChartIdentityScopes): void;

package/dist/chart/index.d.ts

@@ -0,0 +1,8 @@
+import type { EditDoc, ElementId } from '../types';
+import type { ChartDataset, EditableChart } from './types';
+export { chartDataEditor as createChartDataEditor } from './commands';
+export { chartProjection } from './projection';
+export type { ChartDataEditor } from './commands';
+export type { ChartCategory, ChartDataBinding, ChartDataset, ChartFormulaBinding, ChartPlotKind, ChartPoint, ChartPointId, ChartSeries, ChartSeriesId, EditableChart, } from './types';
+export declare function listEditableCharts(doc: EditDoc): EditableChart[];
+export declare function queryChartData(doc: EditDoc, id: ElementId): ChartDataset;

package/dist/chart/limits.d.ts

@@ -0,0 +1,6 @@
+export declare const MAX_CHART_NAME = 32767;
+export declare const MAX_CHART_IDENTITY = 512;
+export declare const MAX_CHART_POINTS = 20000;
+export declare const MAX_CHART_SERIES = 1024;
+export declare const MAX_CHART_CELLS = 100000;
+export declare const MAX_CATEGORY_LEVELS = 64;

package/dist/chart/locator.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementId } from '../types';
+export declare function chartFrameKey(doc: EditDoc, id: ElementId): string;
+/** 图表身份由原 frame 的 spid + OPC 关系推导，默认编辑模型不为按需能力常驻字段。 */
+export declare function chartPartForElement(doc: EditDoc, id: ElementId): string | null;

package/dist/chart/materialize.d.ts

@@ -0,0 +1,7 @@
+import type { XmlDocument } from '@web-ppt/edit-core/xml';
+import type { ChartDatasetState } from './types';
+import type { ChartIdentityScopes } from './identity-scopes';
+export declare function materializeChartTree(source: string | Uint8Array, chartId: string, state: ChartDatasetState, frameKey?: string, scopes?: ChartIdentityScopes): XmlDocument;
+export declare function materializeChartXml(source: string | Uint8Array, chartId: string, state: ChartDatasetState): string;
+/** 编辑投影只消费当前图表方言；未知扩展仍原样保存，但不能以同名节点劫持屏幕数据。 */
+export declare function materializeChartProjectionXml(source: string | Uint8Array, chartId: string, state: ChartDatasetState, frameKey?: string): string;

package/dist/chart/ordering.d.ts

@@ -0,0 +1,9 @@
+import type { FractionalIndex } from '../types';
+interface OrderedChartRecord {
+    readonly id: string;
+    readonly order: FractionalIndex;
+}
+/** 并发插入可能得到相同分数序；稳定身份是跨副本必须共享的最终裁决。 */
+export declare function compareChartOrder(left: OrderedChartRecord, right: OrderedChartRecord): number;
+export declare function orderedChartRecords<T extends OrderedChartRecord>(values: Iterable<T>): T[];
+export {};

package/dist/chart/part-graph.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+export declare function nativeChartParts(doc: EditDoc): {
+    parts: string[];
+    charts: Set<string>;
+};

package/dist/chart/patch-validation.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionPatch } from '../commands/types';
+import type { ChartDatasetState } from './types';
+export declare function validatePatchAgainstState(state: ChartDatasetState, patchValue: ExtensionPatch, index: number): void;

package/dist/chart/plot-kinds.d.ts

@@ -0,0 +1,2 @@
+import type { ChartPlotKind } from './types';
+export declare const CHART_PLOTS: Readonly<Record<string, ChartPlotKind>>;

package/dist/chart/projection.d.ts

@@ -0,0 +1,8 @@
+import type { SlideElement } from '@web-ppt/core';
+import type { EditDoc, ElementId } from '../types';
+export declare function chartProjection(doc: EditDoc, id: ElementId): {
+    xml: string;
+    context: import("@web-ppt/core").ChartEnv;
+    part: string;
+};
+export declare function projectChartElement(doc: EditDoc, id: ElementId, element: SlideElement): SlideElement;

package/dist/chart/save.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { EditExtensionSavePlan } from '../extension-runtime';
+/** 图表和工作簿先形成一个 OPC 原子提交，普通保存随后只处理其余 part。 */
+export declare function saveChartDatasets(doc: EditDoc): EditExtensionSavePlan | void;

package/dist/chart/shared-added-plan.d.ts

@@ -0,0 +1,19 @@
+import type { ChartDatasetState, ChartSeriesId } from './types';
+import type { SharedGroup } from './shared-graph';
+import type { WorkbookCellValue } from './workbook-read';
+import type { SharedSeriesRemovals } from './shared-series';
+import type { AddedSeries } from './shared-added-records';
+import type { InsertedResource } from './shared-inserted-project';
+import type { XYResource } from './shared-xy-records';
+export interface SharedSeriesGrowth extends InsertedResource, XYResource {
+    readonly addedSeries?: AddedSeries;
+    readonly rows?: Readonly<Record<string, unknown>>;
+    readonly series?: SharedSeriesRemovals;
+}
+export interface AddedSeriesPlan {
+    readonly part: string;
+    readonly id: ChartSeriesId;
+    readonly state: ChartDatasetState;
+}
+/** 物理列/行由整个工作簿统一分配；文档存储的身份和数值不会随并发插入挪动。 */
+export declare function planAddedSeries(shared: SharedGroup, resource: SharedSeriesGrowth, baseline: ReadonlyMap<string, WorkbookCellValue>): AddedSeriesPlan[];

package/dist/chart/shared-added-records.d.ts

@@ -0,0 +1,8 @@
+import type { ChartDatasetState } from './types';
+import type { SharedGroup } from './shared-graph';
+import type { CommandPatches, DocumentExtensionPatch } from '../commands/types';
+export type AddedSeries = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+export declare function addedSeriesCommand(source: ChartDatasetState, workbook: string, local: CommandPatches): CommandPatches | undefined;
+export declare function decodeAddedSeries(state: ChartDatasetState, added: AddedSeries | undefined): Record<string, unknown> | undefined;
+export declare function validateAddedSeries(shared: SharedGroup, added: unknown): void;
+export declare function validateAddedSeriesPatch(shared: SharedGroup, patch: DocumentExtensionPatch): void;

package/dist/chart/shared-address.d.ts

@@ -0,0 +1,5 @@
+export declare function sharedCellAddress(key: string): {
+    column: number;
+    row: number;
+    sheet: string;
+};

package/dist/chart/shared-allocate.d.ts

@@ -0,0 +1,7 @@
+import type { ChartFormulaBinding } from './types';
+import type { WorkbookCellValue } from './workbook-read';
+/** 单次规划共享全部预约和搜索额度，避免不同图表各自认领同一块空白。 */
+export declare function sharedSeriesAllocator(reserved: Set<string>, baseline: ReadonlyMap<string, WorkbookCellValue>): (sheet: string, horizontal: boolean, start: number, count: number) => {
+    name: ChartFormulaBinding;
+    data: ChartFormulaBinding;
+};

package/dist/chart/shared-cache-codec.d.ts

@@ -0,0 +1,5 @@
+import type { ChartDatasetState } from './types';
+import type { ExtensionPatch } from '../commands/types';
+/** 来源身份用原生序号寻址；新增身份保留创建者分配的唯一 ID，不依赖任何框架的生命周期。 */
+export declare function sharedCacheIdentityMap(source: ChartDatasetState): Record<string, string>;
+export declare function sharedCacheCodec(source: ChartDatasetState, identities?: Readonly<Record<string, string>>): (patch: ExtensionPatch, encode: boolean) => ExtensionPatch;

package/dist/chart/shared-cache-identities.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+/** 迁移后的数据沿用旧身份；否则迟到补丁中的新增身份和标量引用会失去含义。 */
+export declare function sharedCacheIdentities(doc: EditDoc, part: string): Readonly<Record<string, string>> | undefined;

package/dist/chart/shared-cache-migration.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { DocumentExtensionPatch, Patch } from '../commands/types';
+import type { ExtensionMigrationResolver } from '../extension-runtime';
+import type { ChartDatasetState } from './types';
+export declare function migrateLocalChartData(doc: EditDoc, pending?: readonly Patch[], resolve?: ExtensionMigrationResolver): DocumentExtensionPatch[];
+/** 查询复用迁移规划器的身份校验；不调用协同时钟裁决器，也不安装地址或改写文档。 */
+export declare function localChartMigrationReason(doc: EditDoc, source: ChartDatasetState, ids: readonly string[]): string;

package/dist/chart/shared-cache-save.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+import type { EditExtensionSavePlan } from '../extension-runtime';
+export declare function saveSharedData(doc: EditDoc): EditExtensionSavePlan | void;

package/dist/chart/shared-cache-scopes.d.ts

@@ -0,0 +1,13 @@
+import type { EditDoc, ElementRecord } from '../types';
+/** 来源归属取自原生框架与复制出处；自定义新增 ID 即使同尾缀也不能被猜成来源记录。 */
+export declare function sharedCacheScopeIds(doc: EditDoc, part: string, native: Readonly<Record<string, string>>, identities: Readonly<Record<string, string>>): (record: ElementRecord) => {
+    ids: {
+        [k: string]: string;
+    };
+    removed: {
+        id: string;
+        ids: {
+            [x: string]: string;
+        };
+    }[];
+};

package/dist/chart/shared-cache.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc, ElementId } from '../types';
+import type { CommandPatches, DocumentExtensionPatch } from '../commands/types';
+import type { ChartDatasetState } from './types';
+export declare function sharedCacheSource(doc: EditDoc, part: string, allowLegacy?: boolean): ChartDatasetState | undefined;
+export declare function ownsSharedCache(doc: EditDoc, id: ElementId): boolean;
+export declare function sharedCacheTransactionsOnly(doc: EditDoc, id: ElementId): boolean;
+export declare function validateSharedCachePatch(doc: EditDoc, patch: DocumentExtensionPatch): void;
+export declare function sharedCacheOverrides(doc: EditDoc, source: ChartDatasetState): Record<string, unknown> | undefined;
+export declare function sharedCacheFrameOverrides(doc: EditDoc, id: ElementId): unknown;
+export declare function sharedCacheDataset(doc: EditDoc, id: ElementId, state: ChartDatasetState): ChartDatasetState;
+export declare function sharedCacheCommand(doc: EditDoc, id: ElementId, local: CommandPatches): CommandPatches;

package/dist/chart/shared-category.d.ts

@@ -0,0 +1,4 @@
+import type { ChartDatasetState } from './types';
+import type { WorkbookMap } from './workbook';
+import type { SharedCellEdit } from './shared-cell';
+export declare function sharedCategoryEdits(source: ChartDatasetState, before: ChartDatasetState, after: ChartDatasetState, parts: Readonly<Record<string, Uint8Array>>, map: WorkbookMap, touched: ReadonlySet<string>): Map<string, SharedCellEdit>;

package/dist/chart/shared-cell.d.ts

@@ -0,0 +1,9 @@
+import type { WorkbookCellValue } from './workbook-read';
+export type SharedCellEdit = {
+    readonly value: string | number | null;
+} | {
+    readonly parent: string;
+};
+export declare function decodeSharedCell(raw: unknown): SharedCellEdit;
+/** 延续组保存为对组首的引用；并发改名因此不会把旧标签复制成第二份真值。 */
+export declare function sharedCellValue(key: string, overrides: Readonly<Record<string, unknown>>, baseline: ReadonlyMap<string, WorkbookCellValue>): string | number | null;

package/dist/chart/shared-family.d.ts

@@ -0,0 +1,26 @@
+import type { SharedGroup } from './shared-graph';
+import type { ChartDatasetState } from './types';
+import type { SharedXYAxisOwner } from './shared-xy-source';
+export interface SharedCategoryFamily {
+    readonly key: string;
+    readonly sheet: string;
+    readonly horizontal: boolean;
+    readonly start: number;
+    readonly end: number;
+    readonly lanes: ReadonlySet<number>;
+    readonly keys: ReadonlySet<string>;
+    readonly charts: SharedGroup['charts'];
+    readonly positions: ReadonlyMap<string, ReadonlyMap<string, number>>;
+    readonly xyOwners: readonly SharedXYAxisOwner[];
+    readonly ranges: ReadonlyMap<string, {
+        readonly start: number;
+        readonly end: number;
+    }>;
+    readonly anchors: ReadonlySet<number>;
+    readonly numericLanes: ReadonlySet<number>;
+}
+/** 相交的数据单元格把视图组成一个记录轴；框架身份不会改变这个区域的所有权。 */
+export declare function sharedCategoryFamily(shared: SharedGroup, id: string): SharedCategoryFamily;
+export declare function sharedCategoryForXY(shared: SharedGroup, chartId: string, seriesId: string): SharedCategoryFamily | undefined;
+export declare function sharedFamilyForState(shared: SharedGroup, state: ChartDatasetState): SharedCategoryFamily;
+export declare function sharedFamilyByKey(shared: SharedGroup, key: string): SharedCategoryFamily;

package/dist/chart/shared-fields.d.ts

@@ -0,0 +1,18 @@
+import type { ChartDatasetState } from './types';
+export interface SharedCellField {
+    readonly key: string;
+    readonly path: readonly string[];
+    readonly value: string | number | null;
+    readonly kind: 'number' | 'text';
+    readonly nullable?: boolean;
+    readonly parent?: {
+        readonly level: number;
+        readonly raw: string | null;
+        readonly family: string;
+    };
+}
+/** 混合图中的类别记录只拥有类别系列的数值；XY 系列按各自的记录轴增删。 */
+export declare function sharedCategoryFields(state: ChartDatasetState, fields?: readonly SharedCellField[]): SharedCellField[];
+/** 空缓存也保留公式所有权，分配新系列不能占用这些仍可恢复的区域。 */
+export declare function sharedFormulaCells(state: ChartDatasetState): string[];
+export declare function sharedCellFields(state: ChartDatasetState): SharedCellField[];

package/dist/chart/shared-graph.d.ts

@@ -0,0 +1,19 @@
+import type { EditDoc, ElementId } from '../types';
+import type { ChartDatasetState } from './types';
+import type { SharedCellField } from './shared-fields';
+export { sharedChartTopology as nativeChartParts } from './shared-topology';
+export interface SharedGroup {
+    readonly workbook: string;
+    readonly reason?: string;
+    readonly charts: readonly {
+        id: ElementId;
+        native?: true;
+        state: ChartDatasetState;
+        fields: readonly SharedCellField[];
+    }[];
+}
+export declare function hasSharedChartScopes(bytes: Uint8Array): boolean;
+export declare function sharedWorkbookParts(doc: EditDoc): string[];
+/** 所有权来自 OPC 部件图；没有当前框架的图表仍然是工作簿的原生消费者。 */
+export declare function sharedGroupForWorkbook(doc: EditDoc, workbook: string): SharedGroup | undefined;
+export declare function sharedGroupForFrame(doc: EditDoc, id: ElementId): SharedGroup | undefined;

package/dist/chart/shared-growth-space.d.ts

@@ -0,0 +1,5 @@
+import type { SharedGroup } from './shared-graph';
+import type { InsertedResource } from './shared-inserted-project';
+import type { XYResource } from './shared-xy-records';
+/** 来源区域彼此独立，不代表扩展后仍独立；空格也不能同时分配给两条记录轴。 */
+export declare function assertSharedGrowthSpace(shared: SharedGroup, resource: InsertedResource & XYResource): void;

package/dist/chart/shared-inserted-cells.d.ts

@@ -0,0 +1,14 @@
+import type { SharedGroup } from './shared-graph';
+import type { InsertedRows } from './shared-inserted-records';
+export interface InsertedCellResource {
+    readonly insertions?: InsertedRows;
+    readonly cells?: Readonly<Record<string, unknown>>;
+}
+export declare const insertedCellKey: (id: string, lane: number | string) => string;
+export declare function insertedCellReference(key: string): {
+    id: string;
+    lane: number;
+} | undefined;
+export declare function validateInsertedCellReference(shared: SharedGroup, target: string, parent: string, insertions?: InsertedRows): void;
+/** 虚拟单元格只是引用解析图的节点，所有字面值仍只有文档中的一份记录。 */
+export declare function insertedCellOverrides(shared: SharedGroup, resource: InsertedCellResource): Record<string, unknown>;

package/dist/chart/shared-inserted-command.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from '../commands/types';
+import type { SharedGroup } from './shared-graph';
+import type { InsertedResource } from './shared-inserted-project';
+import type { WorkbookCellValue } from './workbook-read';
+import type { SharedSeriesGrowth } from './shared-added-plan';
+export declare function insertedCategoryCommand(doc: EditDoc, shared: SharedGroup, id: string, local: CommandPatches, origin: string, resource: InsertedResource & SharedSeriesGrowth, baseline: ReadonlyMap<string, WorkbookCellValue>): CommandPatches | undefined;

package/dist/chart/shared-inserted-layout.d.ts

@@ -0,0 +1,16 @@
+import type { SharedCategoryFamily } from './shared-family';
+import type { InsertedRows } from './shared-inserted-records';
+import type { RemovedCells } from './shared-rows';
+import type { WorkbookCellValue } from './workbook-read';
+import type { SharedGroup } from './shared-graph';
+import type { SharedRecordAxis } from './shared-record-axis';
+export declare function insertedRowLayout(family: SharedCategoryFamily, insertions: InsertedRows | undefined, removals?: RemovedCells): {
+    key: (lane: number, axis: number) => string;
+    records: readonly import("./shared-inserted-records").InsertedRow[];
+    active: import("./shared-inserted-records").InsertedRow[];
+    deleted: number[];
+    originalAxis: (axis: number) => number;
+    insertedAxis: (row: import("./shared-inserted-records").InsertedRow) => number;
+    end: number;
+};
+export declare function assertInsertedRoom(shared: SharedGroup, family: SharedRecordAxis, layout: Pick<ReturnType<typeof insertedRowLayout>, 'active' | 'deleted' | 'end' | 'key'>, baseline: ReadonlyMap<string, WorkbookCellValue>): void;

package/dist/chart/shared-inserted-project.d.ts

@@ -0,0 +1,14 @@
+import type { ChartDatasetState } from './types';
+import type { SharedGroup } from './shared-graph';
+import type { InsertedRows } from './shared-inserted-records';
+import { sharedFamilyForState } from './shared-family';
+import type { RemovedCells } from './shared-rows';
+import type { WorkbookCellValue } from './workbook-read';
+import type { InsertedCellResource } from './shared-inserted-cells';
+export interface InsertedResource extends InsertedCellResource {
+    readonly insertions?: InsertedRows;
+    readonly rows?: RemovedCells;
+}
+/** 插入顺序投影到每个视图的本地分数序；工作簿坐标只在保存边界派生。 */
+export declare function projectInsertedCategories(shared: SharedGroup, state: ChartDatasetState, original: ChartDatasetState, resource: InsertedResource, baseline: ReadonlyMap<string, WorkbookCellValue>): void;
+export declare function insertedCellLane(family: ReturnType<typeof sharedFamilyForState>, key: string): string;

package/dist/chart/shared-inserted-records.d.ts

@@ -0,0 +1,16 @@
+import type { DocumentExtensionPatch } from '../commands/types';
+import type { SharedGroup } from './shared-graph';
+import type { FractionalIndex } from '../types';
+import type { SharedCategoryFamily } from './shared-family';
+export interface InsertedRow {
+    readonly id: string;
+    readonly anchor: number;
+    readonly order: FractionalIndex;
+    readonly parent?: string | null;
+    readonly removed?: true;
+    readonly cells?: Readonly<Record<string, string | number | null>>;
+}
+export type InsertedRows = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+export declare function validateInsertedPatch(shared: SharedGroup, patch: DocumentExtensionPatch): void;
+export declare function validateInsertedRows(shared: SharedGroup, value: unknown): void;
+export declare function insertedRows(family: Pick<SharedCategoryFamily, 'key'>, insertions: InsertedRows | undefined): InsertedRow[];

package/dist/chart/shared-inserted-save.d.ts

@@ -0,0 +1,6 @@
+import type { EditDoc } from '../types';
+import type { SharedGroup } from './shared-graph';
+import type { InsertedResource } from './shared-inserted-project';
+import type { WorkbookCellValue } from './workbook-read';
+/** 全轴一次压紧或插入；所有视图回写同一组单元格，不能各自重排自己的子范围。 */
+export declare function writeInsertedCategories(doc: EditDoc, shared: SharedGroup, resource: InsertedResource, baseline: ReadonlyMap<string, WorkbookCellValue>, write: (key: string, value: string | number | null) => void): void;

package/dist/chart/shared-joint-command.d.ts

@@ -0,0 +1,9 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from '../commands/types';
+import type { ChartPointId, ChartSeriesId } from './types';
+import type { SharedGroup } from './shared-graph';
+import type { SharedCategoryFamily } from './shared-family';
+import type { InsertedResource } from './shared-inserted-project';
+import type { SharedSeriesGrowth } from './shared-added-plan';
+import type { WorkbookCellValue } from './workbook-read';
+export declare function jointPointCommand(doc: EditDoc, shared: SharedGroup, family: SharedCategoryFamily, chartId: string, seriesId: ChartSeriesId, pointId: ChartPointId, local: CommandPatches, origin: string, resource: InsertedResource & SharedSeriesGrowth, baseline: ReadonlyMap<string, WorkbookCellValue>): CommandPatches;

package/dist/chart/shared-joint-records.d.ts

@@ -0,0 +1,9 @@
+import type { SharedGroup } from './shared-graph';
+import type { InsertedResource } from './shared-inserted-project';
+import type { SharedXYFamily } from './shared-xy-family';
+import type { XYAxisRecords } from './shared-xy-records';
+/** XY 视图借用共同记录的布局；派生适配不向文档写入第二份结构状态。 */
+export declare function jointXYRecords(shared: SharedGroup, resource: InsertedResource): Array<{
+    family: SharedXYFamily;
+    record: XYAxisRecords;
+}>;

package/dist/chart/shared-record-axis.d.ts

@@ -0,0 +1,25 @@
+export interface SharedRecordAxis {
+    readonly key: string;
+    readonly sheet: string;
+    readonly horizontal: boolean;
+    readonly start: number;
+    readonly end: number;
+    readonly lanes: ReadonlySet<number>;
+    readonly keys: ReadonlySet<string>;
+    readonly references?: ReadonlySet<string>;
+}
+interface AxisInsertion {
+    readonly id: string;
+    readonly anchor: number;
+    readonly removed?: true;
+}
+/** 来源坐标是身份；压紧和插入只改变派生坐标，不改写后续记录的寻址。 */
+export declare function recordAxisLayout<T extends AxisInsertion>(family: SharedRecordAxis, records: readonly T[], removed: ReadonlySet<number>): {
+    records: readonly T[];
+    active: T[];
+    deleted: number[];
+    originalAxis: (axis: number) => number;
+    insertedAxis: (row: T) => number;
+    end: number;
+};
+export {};

package/dist/chart/shared-record-remove.d.ts

@@ -0,0 +1,13 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from '../commands/types';
+import type { SharedGroup } from './shared-graph';
+import type { SharedCategoryFamily } from './shared-family';
+import type { WorkbookCellValue } from './workbook-read';
+interface Resource {
+    readonly rows?: Readonly<Record<string, unknown>>;
+    readonly cells?: Readonly<Record<string, unknown>>;
+    readonly heads?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+/** 删除一条来源记录，同时保留各层级视图的组首延续引用。 */
+export declare function removeSharedRecord(doc: EditDoc, shared: SharedGroup, family: SharedCategoryFamily, position: number, origin: string, resource: Resource, baseline: ReadonlyMap<string, WorkbookCellValue>): CommandPatches;
+export {};

package/dist/chart/shared-record-stage.d.ts

@@ -0,0 +1,2 @@
+import type { DocumentExtensionPatch } from '../commands/types';
+export declare function stageSharedRecords(records: Readonly<Record<string, unknown>> | undefined, patches: readonly DocumentExtensionPatch[]): Readonly<Record<string, Readonly<Record<string, unknown>>>>;

package/dist/chart/shared-records.d.ts

@@ -0,0 +1,2 @@
+import type { ChartDatasetState } from './types';
+export declare function decodeSharedDataset(source: ChartDatasetState, dataset: Record<string, unknown>, identities?: Readonly<Record<string, string>>): Record<string, unknown>;

package/dist/chart/shared-rows.d.ts

@@ -0,0 +1,17 @@
+import type { ChartDatasetState } from './types';
+import type { SharedGroup } from './shared';
+import type { SharedCategoryFamily } from './shared-family';
+export { sharedCellAddress } from './shared-address';
+import type { WorkbookCellValue } from './workbook-read';
+export interface RemovedCell {
+    readonly horizontal: boolean;
+    readonly end: number;
+}
+export type RemovedCells = Readonly<Record<string, unknown>>;
+export declare function removedCell(raw: unknown): RemovedCell;
+/** 原地址是记录身份，删除范围只描述物理压紧区域；其后的编辑不按当前显示行号重新寻址。 */
+export declare function sharedRowPlan(shared: SharedGroup, id: string, categoryId: string, baseline: ReadonlyMap<string, WorkbookCellValue>): Map<string, RemovedCell>;
+export declare function sharedRecordRemovalPlan(family: SharedCategoryFamily, position: number, baseline: ReadonlyMap<string, WorkbookCellValue>): Map<string, RemovedCell>;
+export declare function sharedRowPlanForCell(shared: SharedGroup, key: string, baseline: ReadonlyMap<string, WorkbookCellValue>): Map<string, RemovedCell>;
+export declare function shiftedCell(key: string, rows: RemovedCells, inclusive?: boolean): string;
+export declare function projectSharedRows(state: ChartDatasetState, rows: RemovedCells | undefined): void;

package/dist/chart/shared-runtime.d.ts

@@ -0,0 +1,19 @@
+import type { EditDoc, ElementId } from '../types';
+import type { CommandPatches } from '../commands/types';
+import type { ChartDatasetState } from './types';
+import type { ChartIdentityScopes } from './identity-scopes';
+export interface SharedChartRuntime {
+    readonly dataset: (doc: EditDoc, id: ElementId, state: ChartDatasetState) => ChartDatasetState;
+    readonly command: (doc: EditDoc, id: ElementId, local: CommandPatches, origin: string) => CommandPatches;
+    readonly active: (doc: EditDoc, workbook?: string) => boolean;
+    readonly owns: (doc: EditDoc, id: ElementId) => boolean;
+    readonly workbook?: (doc: EditDoc, id: ElementId) => boolean;
+    readonly overrides?: (doc: EditDoc, id: ElementId) => unknown;
+    readonly source?: (doc: EditDoc, id: ElementId, deferred: boolean, part: string | undefined, read: () => ChartDatasetState) => ChartDatasetState;
+    readonly identityScopes?: (doc: EditDoc, part: string, source: Uint8Array, id: ElementId) => ChartIdentityScopes | undefined;
+}
+export declare const sharedChartRuntime: () => SharedChartRuntime | undefined;
+export declare const setSharedChartRuntime: (value: SharedChartRuntime) => void;
+export declare const chartDatasetOverrides: (doc: EditDoc, id: ElementId) => unknown;
+export declare const SHARED_CHART_REASON = "\u5171\u4EAB\u56FE\u8868\u6570\u636E\u9700\u8981\u52A0\u8F7D chart-shared \u7F16\u8F91\u5165\u53E3";
+export declare function sharedDatasetState(doc: EditDoc, id: ElementId, state: ChartDatasetState): ChartDatasetState;

package/dist/chart/shared-save-plan.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { EditExtensionSavePlan } from '../extension-runtime';
+/** 共享工作簿只由此扩展提交一次；未挂载的图表也使用同一份工作簿状态重建缓存。 */
+export declare function saveSharedChartParts(doc: EditDoc): EditExtensionSavePlan | void;

package/dist/chart/shared-save.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+/** 共享保存直接消费唯一单元格覆盖；不能让不同图表的显示缓存轮流重写同一工作簿。 */
+export declare function sharedWorkbookPatch(doc: EditDoc, workbook: string): Uint8Array | undefined;

package/dist/chart/shared-series.d.ts

@@ -0,0 +1,6 @@
+import type { EditDoc } from '../types';
+import type { ChartDatasetState } from './types';
+export type SharedSeriesRemovals = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+export declare function projectSharedSeries(state: ChartDatasetState, removals: SharedSeriesRemovals | undefined): void;
+/** 删除的是图表中的系列；只有全部原生视图都释放的单元格才可清空。 */
+export declare function unusedSharedCells(doc: EditDoc, workbook: string): Set<string>;

package/dist/chart/shared-source-cache.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementId } from '../types';
+import type { ChartDatasetState } from './types';
+/** 缓存只依赖不可变来源字节，编辑覆盖仍每次重新投影；保存后的原始基线也必须参与失效判断。 */
+export declare function cachedSharedSource(doc: EditDoc, id: ElementId, deferred: boolean, nativePart: string | undefined, read: () => ChartDatasetState): ChartDatasetState;

package/dist/chart/shared-topology.d.ts

@@ -0,0 +1,9 @@
+import type { EditDoc, ElementId } from '../types';
+import { nativeChartParts } from './part-graph';
+interface ChartTopology extends ReturnType<typeof nativeChartParts> {
+    readonly frames: ReadonlyMap<string, readonly ElementId[]>;
+    readonly signature: string;
+}
+/** 结构补丁替换记录集合，保存替换来源包；数据覆盖不改变原生消费者关系。 */
+export declare function sharedChartTopology(doc: EditDoc): ChartTopology;
+export {};

package/dist/chart/shared-unresolved.d.ts

@@ -0,0 +1,3 @@
+import type { SlideElement } from '@web-ppt/core';
+import type { EditDoc, ElementId } from '../types';
+export declare function projectUnresolvedChart(doc: EditDoc, id: ElementId, element: SlideElement): SlideElement;

package/dist/chart/shared-validation.d.ts

@@ -0,0 +1,6 @@
+import type { DocumentExtensionPatch } from '../commands/types';
+import type { SharedGroup } from './shared';
+import type { WorkbookCellValue } from './workbook-read';
+export declare function validateSharedPatch(shared: SharedGroup, patch: DocumentExtensionPatch, baseline: ReadonlyMap<string, WorkbookCellValue>): void;
+/** 恢复可先于按需扩展加载；投影和保存仍须校验完整覆盖，不能只信任在线补丁入口。 */
+export declare function validateSharedOverrides(shared: SharedGroup, resource: unknown, baseline: ReadonlyMap<string, WorkbookCellValue>): void;

package/dist/chart/shared-workbook-source.d.ts

@@ -0,0 +1,6 @@
+import type { EditDoc } from '../types';
+export declare function sharedWorkbookSource(doc: EditDoc, part: string): {
+    parts: Record<string, Uint8Array<ArrayBufferLike>>;
+    map: import("./workbook").WorkbookMap;
+    baseline: Map<string, import("./workbook-read").WorkbookCellValue>;
+};

package/dist/chart/shared-xy-command.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from '../commands/types';
+import type { SharedGroup } from './shared-graph';
+import type { WorkbookCellValue } from './workbook-read';
+import type { XYResource } from './shared-xy-records';
+import type { SharedSeriesGrowth } from './shared-added-plan';
+export declare function sharedXYCommand(doc: EditDoc, shared: SharedGroup, id: string, local: CommandPatches, origin: string, resource: XYResource & SharedSeriesGrowth, baseline: ReadonlyMap<string, WorkbookCellValue>): CommandPatches | undefined;