@a3s-lab/office 0.43.0 → 0.45.0

package/dist/7060.js

@@ -1,4 +1,4 @@
-import { workOfficeCollaborationJsonEqual, isWorkOfficeCollaborationRecord, cloneWorkOfficeCollaborationJson } from "./4650.js";
+import { workOfficeCollaborationJsonEqual, isWorkOfficeCollaborationRecord, cloneWorkOfficeCollaborationJson } from "./816.js";
 import { OfficeCollaborationError as WorkOfficeCollaborationError } from "./9787.js";
 import * as __rspack_external_yjs from "yjs";
 function patchWorkOfficeCollaborationFlatJsonMap(target, previous, next, label) {

package/dist/{4650.js → 816.js}

@@ -67,4 +67,15 @@ function isUnsafeJsonKey(key) {
 function invalidCollaborationJson(expected) {
     throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `Office collaboration requires ${expected}.`);
 }
-export { canonicalWorkOfficeCollaborationJson, cloneWorkOfficeCollaborationJson, isWorkOfficeCollaborationRecord, workOfficeCollaborationJsonEqual };
+const MODAL_DIALOG_SELECTOR = '[role="dialog"][aria-modal="true"]';
+const OFFICE_SHORTCUT_IGNORE_SELECTOR = '[data-office-shortcuts="ignore"]';
+function isOfficeCompositionKeyboardEvent(event) {
+    return event.isComposing || 'Process' === event.key || 229 === event.keyCode;
+}
+function isOfficeShortcutBlocked(target) {
+    if ("u" < typeof document) return false;
+    if (target instanceof Element && (target.closest(MODAL_DIALOG_SELECTOR) || target.closest(OFFICE_SHORTCUT_IGNORE_SELECTOR))) return true;
+    if (document.activeElement instanceof Element && (document.activeElement.closest(MODAL_DIALOG_SELECTOR) || document.activeElement.closest(OFFICE_SHORTCUT_IGNORE_SELECTOR))) return true;
+    return null !== document.querySelector(MODAL_DIALOG_SELECTOR);
+}
+export { canonicalWorkOfficeCollaborationJson, cloneWorkOfficeCollaborationJson, isOfficeCompositionKeyboardEvent, isOfficeShortcutBlocked, isWorkOfficeCollaborationRecord, workOfficeCollaborationJsonEqual };

package/dist/8715.js

@@ -1,4 +1,4 @@
-import { createOfficeId as createWorkId, directChild, attribute } from "./4121.js";
+import { createOfficeId as createWorkId, directChild, attribute } from "./6968.js";
 function sparseArrayIndexes(values) {
     if (!values) return [];
     return Object.keys(values).flatMap((key)=>{

package/dist/9333.js

@@ -1,4 +1,4 @@
-import { directChild, directChildren, attribute, firstDescendant } from "./4121.js";
+import { directChild, directChildren, attribute, firstDescendant } from "./6968.js";
 import { sparseMatrixColumnCount, cloneSparseMatrix, sparseArrayIndexes, sparseArrayEntries as spreadsheet_sparse_sparseArrayEntries, formatSpreadsheetCellRanges, parseSpreadsheetCellRanges as work_spreadsheet_ranges_parseSpreadsheetCellRanges } from "./8715.js";
 function* xlsxWorksheetCellEntries(worksheet) {
     if (Array.isArray(worksheet)) {
@@ -1353,22 +1353,6 @@ function stringRecord(value) {
     const entries = Object.entries(value).filter((entry)=>'string' == typeof entry[1]);
     return entries.length ? Object.fromEntries(entries) : void 0;
 }
-const SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS = [
-    'greaterThan',
-    'greaterThanOrEqual',
-    'lessThan',
-    'lessThanOrEqual',
-    'equal',
-    'notEqual',
-    'between',
-    'notBetween'
-];
-function isSpreadsheetConditionalComparisonOperator(value) {
-    return SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS.some((operator)=>operator === value);
-}
-function spreadsheetConditionalComparisonNeedsUpperValue(operator) {
-    return 'between' === operator || 'notBetween' === operator;
-}
 const DEFAULT_DATA_BAR_MIN_LENGTH = 10;
 const DEFAULT_DATA_BAR_MAX_LENGTH = 90;
 function defaultSpreadsheetColorScaleThresholds(colorCount) {
@@ -1758,6 +1742,22 @@ function work_spreadsheet_conditional_icons_palette(count) {
     if (4 === count) return COLOR_4;
     return COLOR_5;
 }
+const SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS = [
+    'greaterThan',
+    'greaterThanOrEqual',
+    'lessThan',
+    'lessThanOrEqual',
+    'equal',
+    'notEqual',
+    'between',
+    'notBetween'
+];
+function isSpreadsheetConditionalComparisonOperator(value) {
+    return SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS.some((operator)=>operator === value);
+}
+function spreadsheetConditionalComparisonNeedsUpperValue(operator) {
+    return 'between' === operator || 'notBetween' === operator;
+}
 function effectiveSpreadsheetHeaderFooterSections(sections) {
     return {
         left: sections?.left ?? '',

package/dist/core.js

@@ -2,10 +2,10 @@ import jszip from "jszip";
 import { MarkdownManager } from "@tiptap/markdown";
 import { getSchema } from "@tiptap/core";
 import { OFFICE_COLLABORATION_PROTOCOL as WORK_OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError as WorkOfficeCollaborationError, assertWorkOfficeCollaborationOrigin } from "./9787.js";
-import { directChildren, OoxmlPackage as work_ooxml_package_OoxmlPackage, parseXml, firstDescendant, directChild, descendants, createArtifact as createWorkArtifact, xmlContainsAnyElement, createOfficeId as createWorkId, attribute as work_ooxml_package_attribute } from "./4121.js";
+import { directChildren, OoxmlPackage as work_ooxml_package_OoxmlPackage, parseXml, firstDescendant, directChild, descendants, createArtifact as createWorkArtifact, xmlContainsAnyElement, createOfficeId as createWorkId, attribute as work_ooxml_package_attribute } from "./6968.js";
 import { fileNameWithoutExtension, work_file_download_downloadBlob, mountWorkLiveDocumentCapture, importWorkDocumentFile, moveWorkSourceBlob, materializeWorkDocumentContent as work_document_model_codec_materializeWorkDocumentContent, createWorkDocumentModel, work_file_download_safeFileName, documentPageSurfaceGeometryForElement, registerSourceBlob as rememberWorkSourceBlob, documentModelForContent, readSourceBlob as readWorkSourceBlob, createWorkDocumentExtensions, positionWorkLiveDocumentCapture, createWorkDocumentBlob } from "./4174.js";
 import { normalizeSpreadsheetPrintTitleRows, sparseMatrixColumnCount, normalizeSpreadsheetPrintArea, parseSpreadsheetPrintTitles, isValidSpreadsheetDefinedName, formatSpreadsheetCellRanges, stripSpreadsheetSheetQualifier, editableSpreadsheetFormula, sparseArrayEntries, qualifySpreadsheetRange, refreshSpreadsheetPivotTables, parseSpreadsheetCellRanges, normalizeSpreadsheetPrintTitleColumns } from "./8715.js";
-import { xlsxColorMatches, xlsxRichTextCellText, spreadsheetCellValueWithDiagonalBorder, xlsxRichTextStyleOrigins, normalizeSpreadsheetDataValidationErrorStyle, workSpreadsheetAutoFilterCriteriaEntries, directXlsxAlignment, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, applyImportedXlsxRichText, xlsxStyleCollectionIndex, sheetHasXlsxRichTextCells, spreadsheetExplicitTextOrientationFromCell, activeXlsxNativeFill, workSpreadsheetHasUnescapedWildcard, readXlsxRichTextCells, createXlsxRichTextReadContext, normalizeSpreadsheetDateValidationBoundary, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, workSpreadsheetSheetWithImportedAutoFilterCriteria, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, normalizeSpreadsheetTableTotalsLabel, activeXlsxSemanticColorOrigin, writeXlsxRichTextCells, xlsxNativeFillSemanticColors, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, spreadsheetUnderlineCellValueFromSheetJs } from "./5416.js";
+import { xlsxColorMatches, xlsxRichTextCellText, spreadsheetCellValueWithDiagonalBorder, xlsxRichTextStyleOrigins, normalizeSpreadsheetDataValidationErrorStyle, workSpreadsheetAutoFilterCriteriaEntries, directXlsxAlignment, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, applyImportedXlsxRichText, xlsxStyleCollectionIndex, sheetHasXlsxRichTextCells, spreadsheetExplicitTextOrientationFromCell, activeXlsxNativeFill, workSpreadsheetHasUnescapedWildcard, readXlsxRichTextCells, createXlsxRichTextReadContext, normalizeSpreadsheetDateValidationBoundary, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetDateValidationFormula, isSpreadsheetDependentListFormula, spreadsheetDiagonalBorderFromCellValue, workSpreadsheetSheetWithImportedAutoFilterCriteria, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, normalizeSpreadsheetTableTotalsLabel, activeXlsxSemanticColorOrigin, writeXlsxRichTextCells, xlsxNativeFillSemanticColors, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, spreadsheetUnderlineCellValueFromSheetJs } from "./610.js";
 import { freezeImportedSpreadsheetCell, readXlsxGradientFill, withXlsxPatternFill, xlsxCellStyleOriginSemanticColors, setXlsxToggleChild, withXlsxCellStyleOrigin, normalizeSpreadsheetConditionalVisualOptions, xlsxColorElementMatchesOrigin, withXlsxGradientFill, ensureXlsxStyleCollection, xlsxCellStyleOrigin, xlsxSemanticColorOriginKey, readXlsxPatternFill, isSpreadsheetConditionalComparisonOperator, registerImportedSpreadsheetMatrix, defaultSpreadsheetConditionalIconThresholds, readXlsxSemanticColorOrigin, setXlsxUnderlineChild, xlsxGradientFillFallbackColor, setXlsxColorChild, createXlsxColorResolver, resolveXlsxColor, setXlsxBorderLine, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, defaultXlsxBorder, prepareXlsxSemanticPalette, importedSheetProtectionAuthority, defaultSpreadsheetColorScaleThresholds, xlsxRgbColor, writeXlsxAlignment, xlsxGradientFillKey, applyXlsxSemanticColorOrigin, spreadsheetConditionalComparisonNeedsUpperValue, sheetHasProtectionState, xlsxWorksheetCellEntries, isSpreadsheetConditionalIconSetName, setXlsxValueChild, defaultXlsxFill, spreadsheetConditionalThresholdsEqual, spreadsheetConditionalIconSetCount } from "./9333.js";
 import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, readXlsxWorksheetCharts, createXlsxFormulaCell, patchXlsxWorksheetDrawings, readXlsxWorksheetImages, writeXlsxProtection, xlsxWorksheetChartsToSheet, readXlsxFormulaFeaturesFromPackage, emptySpreadsheetWorksheetCompatibilitySummary, createSpreadsheetFormulaMetadata, createXlsxErrorCell, xlsxWorksheetImagesToSheet, readXlsxProtection, patchXlsxFormulaFeatures, patchXlsxPivotTables, writeXlsxPageSetup, XlsxCellProtectionWriter, applyImportedXlsxPivotTables, readXlsxPageSetup } from "./4166.js";
 import { WorkFileImportController, materializeWorkFileSource } from "./9356.js";
@@ -3316,12 +3316,14 @@ function xlsxValidationFormula(item, source, namedListSources) {
     if ('date' === item.type) return spreadsheetDateValidationFormula(value);
     if ('dropdown' !== item.type) return value;
     const formula = value.replace(/^=/, '');
+    if (isSpreadsheetDependentListFormula(value)) return formula;
     if (/^=?[^,]+![A-Z]+\d+(?::[A-Z]+\d+)?$/i.test(value) || /^=?\$?[A-Z]+\$?\d+(?::\$?[A-Z]+\$?\d+)?$/i.test(value) || namedListSources.has(formula.toLocaleLowerCase())) return formula;
     return `"${value.replaceAll('"', '""')}"`;
 }
 function parseListFormula(value) {
     if (value.startsWith('"') && value.endsWith('"')) return value.slice(1, -1).replaceAll('""', '"');
-    return value.replace(/^=/, '');
+    const formula = value.replace(/^=/, '');
+    return isSpreadsheetDependentListFormula(formula) ? `=${formula}` : formula;
 }
 function fortuneValidationType(value) {
     const types = {
@@ -5427,10 +5429,10 @@ function work_pdf_export_safeFileName(value) {
 }
 var core_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
-export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./5416.js";
+export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./610.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
 export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
-export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
+export { createArtifact, createOfficeId, officeTemplates } from "./6968.js";
 export { createOfficeDocumentCollaborationBinding, forgetSourceBlob, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration, readSourceBlob, registerSourceBlob } from "./4174.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";

package/dist/index.js

@@ -2,12 +2,12 @@ var src_DOCUMENT_SNAPSHOT_VERSION = 1;
 var src_DOCUMENT_SOURCE_VERSION = 1;
 var src_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
-export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./5416.js";
+export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./610.js";
 export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource } from "./core.js";
 export { DocumentEditor, MarkdownEditor, PDF_EVIDENCE_COORDINATE_BASIS, PdfViewer, PresentationEditor, SpreadsheetEditor, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, preloadOfficeEditor } from "./432.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
 export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
-export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
+export { createArtifact, createOfficeId, officeTemplates } from "./6968.js";
 export { createOfficeDocumentCollaborationBinding, forgetSourceBlob, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration, readSourceBlob, registerSourceBlob } from "./4174.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";

package/dist/internal/features/work/editors/document-picture-properties-dialog-model.d.ts

@@ -1,4 +1,4 @@
-import type { WorkDocumentImageAlignment, WorkDocumentImageHorizontalReference, WorkDocumentImageLayout, WorkDocumentImageProperties, WorkDocumentImageWrapSide, WorkDocumentImageVerticalReference } from '../work-document-image-layout';
+import type { WorkDocumentImageAlignment, WorkDocumentImageHorizontalReference, WorkDocumentImageLayout, WorkDocumentImageProperties, WorkDocumentImageRotation, WorkDocumentImageVerticalReference, WorkDocumentImageWrapSide } from '../work-document-image-layout';
 export declare const IMAGE_PIXELS_PER_CENTIMETER: number;
 export interface DocumentPicturePropertiesSource {
     properties: WorkDocumentImageProperties;
@@ -24,6 +24,9 @@ export interface DocumentPicturePropertiesDraft {
     cropRight: string;
     cropBottom: string;
     cropLeft: string;
+    rotation: WorkDocumentImageRotation;
+    flipHorizontal: boolean;
+    flipVertical: boolean;
     relativeHeight: string;
     behindDocument: boolean;
     allowOverlap: boolean;

package/dist/internal/features/work/editors/spreadsheet-data-validation-list.d.ts

@@ -0,0 +1,44 @@
+import type { WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
+/** Keep dependent-list parsing synchronous and bounded at the editor boundary. */
+export declare const MAX_SPREADSHEET_DEPENDENT_LIST_FORMULA_LENGTH = 255;
+export declare const MAX_SPREADSHEET_DEPENDENT_LIST_REFERENCE_CELLS = 1024;
+export declare const MAX_SPREADSHEET_DEPENDENT_LIST_MATERIALIZED_CELLS = 10000;
+export interface SpreadsheetDependentListFormulaResult {
+    ok: boolean;
+    formula?: string;
+    message?: string;
+}
+export interface SpreadsheetDependentListReferenceResult {
+    ok: boolean;
+    empty?: boolean;
+    displayReference?: string;
+    message?: string;
+}
+/**
+ * Returns true for the deliberately small, local dependent-list grammar.
+ *
+ * The leading `=` is optional when reading an existing workbook, but authoring
+ * always writes it back so a formula cannot be confused with a literal list.
+ */
+export declare function isSpreadsheetDependentListFormula(value: unknown): boolean;
+/**
+ * Normalize an INDIRECT list source without evaluating workbook state.
+ * Supported arguments are quoted text, a single-cell reference, or a bounded
+ * `&` concatenation of those terms. Nested functions and external books are
+ * intentionally rejected at the local editor boundary.
+ */
+export declare function normalizeSpreadsheetDependentListFormula(value: string): SpreadsheetDependentListFormulaResult;
+/**
+ * Resolve one dependent list for a target cell. An empty driver cell is a
+ * valid state and produces an empty list; malformed non-empty references fail
+ * closed so the editor never silently offers the wrong options.
+ */
+export declare function resolveSpreadsheetDependentListReference(content: WorkSpreadsheetContent, sheetId: string, row: number, column: number, anchorRow: number, anchorColumn: number, formula: string): SpreadsheetDependentListReferenceResult;
+/**
+ * Materialize only the runtime view Fortune needs. The controlled model keeps
+ * the INDIRECT formula; each generated item carries a private marker so the
+ * projection cleanup can restore it after Fortune emits a cell operation.
+ */
+export declare function materializeSpreadsheetDependentListsForFortune(sheets: readonly WorkSpreadsheetSheet[], namedRanges?: WorkSpreadsheetContent['namedRanges']): WorkSpreadsheetSheet[];
+/** Restore controlled formulas and remove generated compact-cell overrides. */
+export declare function restoreSpreadsheetDependentListProjections(sheets: readonly WorkSpreadsheetSheet[]): WorkSpreadsheetSheet[];

package/dist/internal/features/work/editors/spreadsheet-data-validation.d.ts

@@ -46,7 +46,7 @@ export type SpreadsheetDataValidationResult = {
     message: string;
     ok: false;
 };
-export type SpreadsheetDataValidationErrorCode = 'invalid-custom-formula' | 'invalid-date' | 'invalid-list-source' | 'invalid-number' | 'invalid-operator' | 'invalid-range' | 'invalid-text-length' | 'missing-value' | 'multiple-list-columns' | 'out-of-bounds' | 'protected-range' | 'range-too-large' | 'sheet-not-found' | 'value-order';
+export type SpreadsheetDataValidationErrorCode = 'invalid-custom-formula' | 'invalid-date' | 'invalid-list-formula' | 'invalid-list-source' | 'invalid-number' | 'invalid-operator' | 'invalid-range' | 'invalid-text-length' | 'missing-value' | 'multiple-list-columns' | 'out-of-bounds' | 'protected-range' | 'range-too-large' | 'sheet-not-found' | 'value-order';
 export declare function spreadsheetDataValidationOperators(type: SpreadsheetDataValidationType): readonly SpreadsheetDataValidationOperator[];
 export declare function createSpreadsheetDataValidationDialogSource(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): SpreadsheetDataValidationDialogSource | null;
 export declare function validateSpreadsheetDataValidationRequest(content: WorkSpreadsheetContent, request: SpreadsheetDataValidationRequest): SpreadsheetDataValidationResult;
@@ -54,3 +54,4 @@ export declare function applySpreadsheetDataValidation(content: WorkSpreadsheetC
 export declare function removeSpreadsheetDataValidation(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): WorkSpreadsheetContent | null;
 export declare function canRemoveSpreadsheetDataValidation(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): boolean;
 export declare function spreadsheetDataValidationFailureMessage(content: WorkSpreadsheetContent, request: SpreadsheetDataValidationRequest): string | null;
+export declare function spreadsheetDataValidationItemAt(sheet: WorkSpreadsheetSheet, row: number, column: number): WorkSpreadsheetDataValidationItem | null;

package/dist/internal/features/work/editors/spreadsheet-editor-support.d.ts

@@ -20,7 +20,7 @@ export declare function spreadsheetFontSizeOptions(current: number | undefined):
 }[];
 export declare function spreadsheetFontFamilyOptions(current: string | undefined): OfficeSelectOption[];
 export declare function spreadsheetSheetsWithFiniteSelections(sheets: WorkSpreadsheetContent['sheets']): WorkSpreadsheetContent['sheets'];
-export declare function spreadsheetSheetsForFortune(sheets: WorkSpreadsheetContent['sheets']): WorkSpreadsheetContent['sheets'];
+export declare function spreadsheetSheetsForFortune(sheets: WorkSpreadsheetContent['sheets'], namedRanges?: WorkSpreadsheetContent['namedRanges']): WorkSpreadsheetContent['sheets'];
 export declare function spreadsheetSheetsFromFortune(sheets: WorkSpreadsheetContent['sheets'], sourceSheets: WorkSpreadsheetContent['sheets'], operations?: readonly Op[], dateSystem?: WorkSpreadsheetDateSystem): WorkSpreadsheetContent['sheets'];
 export declare function finiteSpreadsheetSelection(selection: Selection | undefined): Selection;
 export declare function sameSpreadsheetWorkbookState(changed: WorkSpreadsheetContent['sheets'], rendered: WorkSpreadsheetContent['sheets']): boolean;

package/dist/internal/features/work/work-document-image-layout.d.ts

@@ -16,6 +16,12 @@ export interface WorkDocumentImageCrop {
     bottom: number;
     left: number;
 }
+export type WorkDocumentImageRotation = 0 | 90 | 180 | 270;
+export interface WorkDocumentImageTransform {
+    rotation: WorkDocumentImageRotation;
+    flipHorizontal: boolean;
+    flipVertical: boolean;
+}
 export interface WorkDocumentImageLayer {
     relativeHeight: number;
     behindDocument: boolean;
@@ -36,6 +42,7 @@ export interface WorkDocumentImageProperties extends WorkDocumentImageLayoutOpti
     alternativeText: string;
     position?: WorkDocumentImagePosition | null;
     crop?: WorkDocumentImageCrop | null;
+    transform?: WorkDocumentImageTransform | null;
     contour?: WorkDocumentImageWrapContour | null;
     layer?: WorkDocumentImageLayer | null;
 }
@@ -63,6 +70,7 @@ export declare function documentImageAlternativeText(editor: Editor): string;
 export declare function documentImageLayoutFromElement(element: Element): WorkDocumentImageLayoutOptions;
 export declare function documentImagePositionFromElement(element: Element): WorkDocumentImagePosition | null;
 export declare function documentImageCropFromElement(element: Element): WorkDocumentImageCrop | null;
+export declare function documentImageTransformFromElement(element: Element): WorkDocumentImageTransform | null;
 export declare function documentImageLayerFromElement(element: Element): WorkDocumentImageLayer;
 export declare function normalizeDocumentImageLayoutOptions(value: Partial<Record<keyof WorkDocumentImageLayoutOptions, unknown>>): WorkDocumentImageLayoutOptions;
 export declare function normalizeDocumentImageLayout(value: unknown): WorkDocumentImageLayout;
@@ -76,6 +84,12 @@ export declare function normalizeDocumentImageHorizontalReference(value: unknown
 export declare function normalizeDocumentImageVerticalReference(value: unknown): WorkDocumentImageVerticalReference;
 export declare function normalizeDocumentImageCrop(value: Partial<Record<'cropBottom' | 'cropLeft' | 'cropRight' | 'cropTop', unknown>>): WorkDocumentImageCrop | null;
 export declare function normalizeDocumentImageCropEdge(value: unknown): number;
+export declare function defaultDocumentImageTransform(): WorkDocumentImageTransform;
+export declare function normalizeDocumentImageTransform(value: Partial<Record<keyof WorkDocumentImageTransform, unknown>>): WorkDocumentImageTransform;
+export declare function normalizeDocumentImageRotation(value: unknown): WorkDocumentImageRotation;
+export declare function documentImageTransformIsDefault(transform: WorkDocumentImageTransform): boolean;
+export declare function documentImageTransformCss(transform: WorkDocumentImageTransform): string;
+export declare function applyDocumentImageTransformToElement(element: HTMLElement, transform: WorkDocumentImageTransform | null): void;
 export declare function normalizeDocumentImageLayer(value: Partial<Record<keyof WorkDocumentImageLayer, unknown>>): WorkDocumentImageLayer;
 export declare function normalizeDocumentImageRelativeHeight(value: unknown): number;
 export declare function documentImageLayerCssZIndex(layer: WorkDocumentImageLayer): number;

package/dist/internal/features/work/work-docx-export-image.d.ts

@@ -2,5 +2,6 @@ import type { ParagraphChild } from 'docx';
 import type { DocxImageCropPatchCollector } from './work-docx-image-crop';
 import type { DocxImageIdentityPatchCollector } from './work-docx-image-identity';
 import type { DocxImageLayerPatchCollector } from './work-docx-image-layer';
+import type { DocxImageTransformPatchCollector } from './work-docx-image-transform';
 import type { DocxImageWrapPatchCollector } from './work-docx-image-wrap';
-export declare function imageToDocx(element: HTMLImageElement, docx: typeof import('docx'), cropPatches?: DocxImageCropPatchCollector, wrapPatches?: DocxImageWrapPatchCollector, layerPatches?: DocxImageLayerPatchCollector, identityPatches?: DocxImageIdentityPatchCollector): Promise<ParagraphChild>;
+export declare function imageToDocx(element: HTMLImageElement, docx: typeof import('docx'), cropPatches?: DocxImageCropPatchCollector, wrapPatches?: DocxImageWrapPatchCollector, layerPatches?: DocxImageLayerPatchCollector, identityPatches?: DocxImageIdentityPatchCollector, transformPatches?: DocxImageTransformPatchCollector): Promise<ParagraphChild>;

package/dist/internal/features/work/work-docx-image-layout-import.d.ts

@@ -1,5 +1,5 @@
 import { type WorkDocumentImageIdentity, type WorkDocumentImageIdentityRegistry } from './work-document-image-identity';
-import { type WorkDocumentImageCrop, type WorkDocumentImageLayer, type WorkDocumentImageLayoutOptions, type WorkDocumentImagePosition } from './work-document-image-layout';
+import { type WorkDocumentImageCrop, type WorkDocumentImageLayer, type WorkDocumentImageLayoutOptions, type WorkDocumentImagePosition, type WorkDocumentImageTransform } from './work-document-image-layout';
 import { type WorkDocumentImageWrapContour } from './work-document-image-wrap-contour';
 export interface ImportedDocxImageLayoutMarker {
     startMarker: string;
@@ -7,6 +7,7 @@ export interface ImportedDocxImageLayoutMarker {
     options: WorkDocumentImageLayoutOptions;
     position: WorkDocumentImagePosition | null;
     crop: WorkDocumentImageCrop | null;
+    transform: WorkDocumentImageTransform | null;
     contour: WorkDocumentImageWrapContour | null;
     layer: WorkDocumentImageLayer | null;
     identity: WorkDocumentImageIdentity;

package/dist/internal/features/work/work-docx-image-transform.d.ts

@@ -0,0 +1,17 @@
+import { type WorkDocumentImageTransform } from './work-document-image-layout';
+interface DocxImageTransformPatch {
+    marker: string;
+    transform: WorkDocumentImageTransform;
+}
+export interface DocxImageTransformReadResult {
+    transform: WorkDocumentImageTransform | null;
+    supported: boolean;
+}
+export declare function readDocxImageTransform(drawing: Element): DocxImageTransformReadResult;
+export declare class DocxImageTransformPatchCollector {
+    readonly patches: DocxImageTransformPatch[];
+    private nextMarker;
+    marker(transform: WorkDocumentImageTransform | null): string;
+}
+export declare function patchDocxImageTransforms(buffer: ArrayBuffer, patches: readonly DocxImageTransformPatch[]): Promise<ArrayBuffer>;
+export {};

package/dist/internal/features/work/work-types.d.ts

@@ -204,6 +204,10 @@ export interface WorkSpreadsheetDataValidationItem {
     type: string;
     type2: string;
     rangeTxt: string;
+    /**
+     * List values, a bounded range/name reference, or a local `=INDIRECT(...)`
+     * source formula for dependent dropdowns.
+     */
     value1: string;
     value2: string;
     validity: string;

package/dist/styles.css

@@ -8383,7 +8383,7 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
-.work-document-picture-properties-section.position, .work-document-picture-properties-section.layer, .work-document-picture-properties-section.crop, .work-document-picture-properties-alt-text {
+.work-document-picture-properties-section.position, .work-document-picture-properties-section.layer, .work-document-picture-properties-section.crop, .work-document-picture-properties-section.transform, .work-document-picture-properties-alt-text {
   grid-column: 1 / -1;
 }
 
@@ -8448,6 +8448,34 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
+.work-document-picture-properties-transform-row {
+  min-height: 34px;
+  color: var(--a3s-muted);
+  grid-template-columns: 64px minmax(0, 1fr);
+  align-items: center;
+  gap: 8px;
+  font-size: 11px;
+  display: grid;
+}
+
+.work-document-picture-properties-transform-options {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 6px 12px;
+  display: grid;
+}
+
+.work-document-picture-properties-transform-options .work-office-checkbox {
+  border-radius: 6px;
+  min-height: 34px;
+  padding: 5px 6px;
+}
+
+.work-document-picture-properties-transform-help {
+  color: var(--a3s-faint);
+  font-size: 10px;
+  line-height: 1.4;
+}
+
 .work-document-picture-properties-layer-options {
   grid-template-columns: repeat(2, minmax(0, 1fr));
   gap: 6px 12px;
@@ -11762,6 +11790,10 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
 .work-document-page .tiptap [data-resize-container][data-node="image"] {
   width: fit-content;
   max-width: 100%;
+  rotate: var(--work-document-image-rotation, 0deg);
+  scale: var(--work-document-image-flip-x, 1)
+    var(--work-document-image-flip-y, 1);
+  transform-origin: center;
   margin-block: 18px;
   display: block !important;
 }
@@ -12601,8 +12633,12 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
 }
 
 :is(.work-document-preview-page, .work-pdf-export-page.document) img[data-office-image-layout] {
-  border-radius: 4px;
   height: auto;
+  rotate: var(--work-document-image-rotation, 0deg);
+  scale: var(--work-document-image-flip-x, 1)
+    var(--work-document-image-flip-y, 1);
+  transform-origin: center;
+  border-radius: 4px;
   margin-block: 18px;
   display: block;
 }
@@ -17939,7 +17975,7 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   display: grid;
 }
 
-.work-spreadsheet-data-validation-custom-formula {
+.work-spreadsheet-data-validation-list-source, .work-spreadsheet-data-validation-custom-formula {
   gap: 8px;
   display: grid;
 }
@@ -18003,6 +18039,18 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   margin-right: auto;
 }
 
+@media (width <= 900px) {
+  .work-spreadsheet-canvas #luckysheet-dataVerification-dropdown-btn {
+    left: calc(100% - 24px) !important;
+  }
+
+  .work-spreadsheet-canvas #luckysheet-dataVerification-dropdown-List {
+    max-width: calc(100% - 8px);
+    left: auto !important;
+    right: 4px !important;
+  }
+}
+
 @media (width <= 560px) {
   .work-spreadsheet-data-validation-condition-grid, .work-spreadsheet-data-validation-values.two, .work-spreadsheet-data-validation-behavior, .work-spreadsheet-data-validation-message-grid {
     grid-template-columns: minmax(0, 1fr);

package/docs/latest/en/browser-editor-architecture.md

@@ -836,12 +836,13 @@ stable ProseMirror position, and distribute list-container height without
 double-counting nested content.
 
 Document image nodes carry typed layout, alignment, wrap-distance, alternative
-text, size, and per-image aspect-ratio-lock attributes. The contextual Picture
+text, size, per-image aspect-ratio-lock, and bounded transform attributes. The contextual Picture
 ribbon keeps fast layout actions and opens one responsive Picture Properties
 dialog for centimeter width and height, aspect-ratio locking, wrapping,
 alignment, text distance, signed horizontal and vertical offsets, their column,
 paragraph, margin, or page reference frames, four-edge percentage cropping,
-relative drawing order, behind-text placement, overlap and cell-layout policy,
+quarter-turn rotation, horizontal/vertical reflection, relative drawing order,
+behind-text placement, overlap and cell-layout policy,
 anchor locking, and alternative text. Applying the complete draft
 updates only changed attributes in one separated TipTap history entry; cancel
 and Escape preserve the node and return focus to the exact invoker. Dimensions
@@ -865,7 +866,10 @@ and ordered `wrapPolygon` vertices. Aligned anchors remain aligned,
 while precise offsets preserve `positionH` and `positionV` reference frames
 through edit, preview, and regenerated DOCX. Four-edge crop geometry remains
 typed in the controlled model and round-trips as DrawingML `a:srcRect` for
-inline and floating pictures. Supported floating pictures also preserve
+inline and floating pictures. Quarter-turn rotation and reflection round-trip
+as DrawingML `a:xfrm` `rot`, `flipH`, and `flipV` values for inline and floating
+pictures. Arbitrary-angle or malformed transform values are diagnosed and
+normalized to the bounded model. Supported floating pictures also preserve
 drawing-layer relationships through unsigned `relativeHeight`,
 `behindDoc`, `allowOverlap`, `layoutInCell`, and `locked` anchor attributes.
 The browser maps the unsigned drawing order into bounded foreground and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.43.0",
+  "version": "0.45.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",