@trebco/treb 32.14.0 → 36.1.2

package/ooxml-types/src/types/package/relationships.ts

@@ -0,0 +1,37 @@
+import type { OneOrMany } from "../spreadsheetml/util.js";
+
+/** Common relationship types. Not exhaustive — Type fields accept any string. */
+export type WellKnownRelationshipType =
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument"
+  | "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings"
+  | "http://schemas.microsoft.com/office/2006/relationships/vbaProject"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
+  | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml";
+
+export interface Relationship {
+  $attributes?: {
+    Id: string;
+    Type: WellKnownRelationshipType | (string & {});
+    Target: string;
+    TargetMode?: "External" | "Internal";
+  };
+}
+
+export interface Relationships {
+  Relationship?: OneOrMany<Relationship>;
+}

package/ooxml-types/src/types/spreadsheetml/columns.ts

@@ -0,0 +1,20 @@
+import type { OneOrMany, XsdBoolean } from "./util.js";
+
+export interface Col {
+  $attributes?: {
+    min: number;
+    max: number;
+    width?: number;
+    style?: number;
+    hidden?: XsdBoolean;
+    bestFit?: XsdBoolean;
+    customWidth?: XsdBoolean;
+    outlineLevel?: number;
+    collapsed?: XsdBoolean;
+    phonetic?: XsdBoolean;
+  };
+}
+
+export interface Cols {
+  col: OneOrMany<Col>;
+}

package/ooxml-types/src/types/spreadsheetml/comments.ts

@@ -0,0 +1,30 @@
+import type { OneOrMany, TextElement } from "./util.js";
+import type { RichTextRun } from "./sheetData.js";
+
+export interface CommentText {
+  t?: TextElement;
+  r?: OneOrMany<RichTextRun>;
+}
+
+export interface Comment {
+  $attributes?: {
+    ref: string;
+    authorId: number;
+    guid?: string;
+    shapeId?: number;
+  };
+  text: CommentText;
+}
+
+export interface CommentList {
+  comment: OneOrMany<Comment>;
+}
+
+export interface Authors {
+  author: OneOrMany<TextElement>;
+}
+
+export interface Comments {
+  authors: Authors;
+  commentList: CommentList;
+}

package/ooxml-types/src/types/spreadsheetml/dataFeatures.ts

@@ -0,0 +1,261 @@
+import type { OneOrMany, TextElement, XsdBoolean } from "./util.js";
+import type { Color } from "./sheetProperties.js";
+import type { Extension, ExtensionList } from "./misc.js";
+import type {
+  ST_CfType,
+  ST_ConditionalFormattingOperator,
+  ST_TimePeriod,
+  ST_DataValidationType,
+  ST_DataValidationErrorStyle,
+  ST_DataValidationOperator,
+} from "./enums.js";
+
+// --- Merge Cells ---
+
+export interface MergeCell {
+  $attributes?: {
+    ref: string;
+  };
+}
+
+export interface MergeCells {
+  $attributes?: {
+    count?: number;
+  };
+  mergeCell: OneOrMany<MergeCell>;
+}
+
+// --- Conditional Formatting ---
+
+export interface ConditionalFormattingValueObject {
+  $attributes?: {
+    type: "num" | "percent" | "max" | "min" | "formula" | "percentile";
+    val?: string;
+    gte?: XsdBoolean;
+  };
+}
+
+export interface ColorScale {
+  cfvo: OneOrMany<ConditionalFormattingValueObject>;
+  color: OneOrMany<Color>;
+}
+
+export interface DataBar {
+  $attributes?: {
+    minLength?: number;
+    maxLength?: number;
+    showValue?: XsdBoolean;
+  };
+  cfvo: OneOrMany<ConditionalFormattingValueObject>;
+  color: Color;
+}
+
+export interface IconSet {
+  $attributes?: {
+    iconSet?: string;
+    showValue?: XsdBoolean;
+    percent?: XsdBoolean;
+    reverse?: XsdBoolean;
+  };
+  cfvo: OneOrMany<ConditionalFormattingValueObject>;
+}
+
+export interface CfRule {
+  $attributes?: {
+    type: ST_CfType;
+    priority: number;
+    dxfId?: number;
+    stopIfTrue?: XsdBoolean;
+    aboveAverage?: XsdBoolean;
+    percent?: XsdBoolean;
+    bottom?: XsdBoolean;
+    operator?: ST_ConditionalFormattingOperator;
+    text?: string;
+    timePeriod?: ST_TimePeriod;
+    rank?: number;
+    stdDev?: number;
+    equalAverage?: XsdBoolean;
+  };
+  formula?: OneOrMany<TextElement>;
+  colorScale?: ColorScale;
+  dataBar?: DataBar;
+  iconSet?: IconSet;
+  extLst?: ExtensionList<CfRuleExtension>;
+}
+
+/** Extension linking a standard cfRule to its x14 counterpart by GUID. */
+export interface CfRuleExtension extends Extension {
+  id?: TextElement;
+}
+
+export interface ConditionalFormatting {
+  $attributes?: {
+    sqref: string;
+    pivot?: XsdBoolean;
+  };
+  cfRule: OneOrMany<CfRule>;
+}
+
+// --- Data Validations ---
+
+export interface DataValidation {
+  $attributes?: {
+    type?: ST_DataValidationType;
+    errorStyle?: ST_DataValidationErrorStyle;
+    operator?: ST_DataValidationOperator;
+    allowBlank?: XsdBoolean;
+    showDropDown?: XsdBoolean;
+    showInputMessage?: XsdBoolean;
+    showErrorMessage?: XsdBoolean;
+    errorTitle?: string;
+    error?: string;
+    promptTitle?: string;
+    prompt?: string;
+    sqref: string;
+    imeMode?: string;
+  };
+  formula1?: TextElement;
+  formula2?: TextElement;
+}
+
+export interface DataValidations {
+  $attributes?: {
+    disablePrompts?: XsdBoolean;
+    xWindow?: number;
+    yWindow?: number;
+    count?: number;
+  };
+  dataValidation: OneOrMany<DataValidation>;
+}
+
+// --- Auto Filter ---
+
+export interface FilterColumn {
+  $attributes?: {
+    colId: number;
+    hiddenButton?: XsdBoolean;
+    showButton?: XsdBoolean;
+  };
+  filters?: Record<string, unknown>;
+  customFilters?: Record<string, unknown>;
+  top10?: Record<string, unknown>;
+  dynamicFilter?: Record<string, unknown>;
+  colorFilter?: Record<string, unknown>;
+  iconFilter?: Record<string, unknown>;
+}
+
+export interface AutoFilter {
+  $attributes?: {
+    ref: string;
+  };
+  filterColumn?: OneOrMany<FilterColumn>;
+  sortState?: SortState;
+}
+
+// --- Sort State ---
+
+export interface SortCondition {
+  $attributes?: {
+    descending?: XsdBoolean;
+    sortBy?: string;
+    ref: string;
+    customList?: string;
+    dxfId?: number;
+    iconSet?: string;
+    iconId?: number;
+  };
+}
+
+export interface SortState {
+  $attributes?: {
+    columnSort?: XsdBoolean;
+    caseSensitive?: XsdBoolean;
+    sortMethod?: string;
+    ref: string;
+  };
+  sortCondition?: OneOrMany<SortCondition>;
+}
+
+// --- x14 Conditional Formatting (extension) ---
+
+export interface X14ConditionalFormattingValueObject {
+  $attributes?: {
+    type: "autoMin" | "autoMax" | "min" | "max" | "percent" | "percentile" | "num" | "formula";
+  };
+  f?: TextElement;
+}
+
+export interface X14DataBar {
+  $attributes?: {
+    minLength?: number;
+    maxLength?: number;
+    border?: XsdBoolean;
+    gradient?: XsdBoolean;
+    direction?: "context" | "leftToRight" | "rightToLeft";
+    negativeBarColorSameAsPositive?: XsdBoolean;
+    negativeBarBorderColorSameAsPositive?: XsdBoolean;
+    axisPosition?: "automatic" | "middle" | "none";
+  };
+  cfvo?: OneOrMany<X14ConditionalFormattingValueObject>;
+  fillColor?: Color;
+  borderColor?: Color;
+  negativeFillColor?: Color;
+  negativeBorderColor?: Color;
+  axisColor?: Color;
+}
+
+export interface X14CfIcon {
+  $attributes?: {
+    iconSet: string;
+    iconId: number;
+  };
+}
+
+export interface X14IconSet {
+  $attributes?: {
+    iconSet?: string;
+    showValue?: XsdBoolean;
+    reverse?: XsdBoolean;
+    custom?: XsdBoolean;
+  };
+  cfvo?: OneOrMany<X14ConditionalFormattingValueObject>;
+  cfIcon?: OneOrMany<X14CfIcon>;
+}
+
+export interface X14CfRule {
+  $attributes?: {
+    type: ST_CfType | "dataBar" | "iconSet";
+    priority?: number;
+    id: string;
+  };
+  dataBar?: X14DataBar;
+  iconSet?: X14IconSet;
+  formula?: OneOrMany<TextElement>;
+  colorScale?: Record<string, unknown>;
+}
+
+export interface X14ConditionalFormatting {
+  cfRule?: OneOrMany<X14CfRule>;
+  /** sqref from xm namespace — cell range this formatting applies to. */
+  sqref?: TextElement;
+}
+
+export interface X14ConditionalFormattings {
+  conditionalFormatting?: OneOrMany<X14ConditionalFormatting>;
+}
+
+// --- Hyperlinks ---
+
+export interface Hyperlink {
+  $attributes?: {
+    ref: string;
+    id?: string;
+    location?: string;
+    tooltip?: string;
+    display?: string;
+  };
+}
+
+export interface Hyperlinks {
+  hyperlink: OneOrMany<Hyperlink>;
+}

package/ooxml-types/src/types/spreadsheetml/enums.ts

@@ -0,0 +1,175 @@
+/** Cell data type (§18.18.11) */
+export type ST_CellType = "b" | "d" | "e" | "inlineStr" | "n" | "s" | "str";
+
+/** Cell formula type (§18.18.6) */
+export type ST_CellFormulaType = "normal" | "array" | "dataTable" | "shared";
+
+/** Pane position (§18.18.52) */
+export type ST_Pane = "bottomLeft" | "bottomRight" | "topLeft" | "topRight";
+
+/** Pane state (§18.18.53) */
+export type ST_PaneState = "frozen" | "frozenSplit" | "split";
+
+/** Sheet view type (§18.18.69) */
+export type ST_SheetViewType = "normal" | "pageBreakPreview" | "pageLayout";
+
+/** Page orientation (§18.18.50) */
+export type ST_Orientation = "default" | "portrait" | "landscape";
+
+/** Page order (§18.18.51) */
+export type ST_PageOrder = "downThenOver" | "overThenDown";
+
+/** Cell comments print mode (§18.18.5) */
+export type ST_CellComments = "none" | "asDisplayed" | "atEnd";
+
+/** Print error display (§18.18.58) */
+export type ST_PrintError = "displayed" | "blank" | "dash" | "NA";
+
+/** Data validation type (§18.18.21) */
+export type ST_DataValidationType =
+  | "none"
+  | "whole"
+  | "decimal"
+  | "list"
+  | "date"
+  | "time"
+  | "textLength"
+  | "custom";
+
+/** Data validation error style (§18.18.18) */
+export type ST_DataValidationErrorStyle = "stop" | "warning" | "information";
+
+/** Data validation operator (§18.18.20) */
+export type ST_DataValidationOperator =
+  | "between"
+  | "notBetween"
+  | "equal"
+  | "notEqual"
+  | "lessThan"
+  | "lessThanOrEqual"
+  | "greaterThan"
+  | "greaterThanOrEqual";
+
+/** Conditional format type (§18.18.12) */
+export type ST_CfType =
+  | "expression"
+  | "cellIs"
+  | "colorScale"
+  | "dataBar"
+  | "iconSet"
+  | "top10"
+  | "uniqueValues"
+  | "duplicateValues"
+  | "containsText"
+  | "notContainsText"
+  | "beginsWith"
+  | "endsWith"
+  | "containsBlanks"
+  | "notContainsBlanks"
+  | "containsErrors"
+  | "notContainsErrors"
+  | "timePeriod"
+  | "aboveAverage";
+
+/** Conditional formatting operator (§18.18.15) */
+export type ST_ConditionalFormattingOperator =
+  | "lessThan"
+  | "lessThanOrEqual"
+  | "equal"
+  | "notEqual"
+  | "greaterThanOrEqual"
+  | "greaterThan"
+  | "between"
+  | "notBetween"
+  | "containsText"
+  | "notContains"
+  | "beginsWith"
+  | "endsWith";
+
+/** Time period for conditional formatting (§18.18.82) */
+export type ST_TimePeriod =
+  | "today"
+  | "yesterday"
+  | "tomorrow"
+  | "last7Days"
+  | "thisMonth"
+  | "lastMonth"
+  | "nextMonth"
+  | "thisWeek"
+  | "lastWeek"
+  | "nextWeek";
+
+/** Sparkline type (x14:type) */
+export type ST_SparklineType = "line" | "column" | "stacked";
+
+/** Border style (§18.18.3) */
+export type ST_BorderStyle =
+  | "none"
+  | "thin"
+  | "medium"
+  | "dashed"
+  | "dotted"
+  | "thick"
+  | "double"
+  | "hair"
+  | "mediumDashed"
+  | "dashDot"
+  | "mediumDashDot"
+  | "dashDotDot"
+  | "mediumDashDotDot"
+  | "slantDashDot";
+
+/** Horizontal alignment (§18.18.40) */
+export type ST_HorizontalAlignment =
+  | "general"
+  | "left"
+  | "center"
+  | "right"
+  | "fill"
+  | "justify"
+  | "centerContinuous"
+  | "distributed";
+
+/** Vertical alignment (§18.18.88) */
+export type ST_VerticalAlignment =
+  | "top"
+  | "center"
+  | "bottom"
+  | "justify"
+  | "distributed";
+
+/** Pattern type (§18.18.55) */
+export type ST_PatternType =
+  | "none"
+  | "solid"
+  | "mediumGray"
+  | "darkGray"
+  | "lightGray"
+  | "darkHorizontal"
+  | "darkVertical"
+  | "darkDown"
+  | "darkUp"
+  | "darkGrid"
+  | "darkTrellis"
+  | "lightHorizontal"
+  | "lightVertical"
+  | "lightDown"
+  | "lightUp"
+  | "lightGrid"
+  | "lightTrellis"
+  | "gray125"
+  | "gray0625";
+
+/** Underline values (§18.4.13) */
+export type ST_UnderlineValues =
+  | "single"
+  | "double"
+  | "singleAccounting"
+  | "doubleAccounting"
+  | "none";
+
+/** Font scheme (§18.18.33) */
+export type ST_FontScheme = "none" | "major" | "minor";
+
+/** Gradient fill type (§18.18.37) */
+export type ST_GradientType = "linear" | "path";

package/ooxml-types/src/types/spreadsheetml/index.ts

@@ -0,0 +1,186 @@
+export type { OneOrMany, TextElement, ValElement, XsdBoolean } from "./util.js";
+
+export type {
+  ST_CellType,
+  ST_CellFormulaType,
+  ST_Pane,
+  ST_PaneState,
+  ST_SheetViewType,
+  ST_Orientation,
+  ST_PageOrder,
+  ST_CellComments,
+  ST_PrintError,
+  ST_DataValidationType,
+  ST_DataValidationErrorStyle,
+  ST_DataValidationOperator,
+  ST_CfType,
+  ST_ConditionalFormattingOperator,
+  ST_TimePeriod,
+  ST_SparklineType,
+  ST_BorderStyle,
+  ST_HorizontalAlignment,
+  ST_VerticalAlignment,
+  ST_PatternType,
+  ST_UnderlineValues,
+  ST_FontScheme,
+  ST_GradientType,
+} from "./enums.js";
+
+export type { Col, Cols } from "./columns.js";
+
+export type {
+  SheetDimension,
+  Color,
+  SheetPr,
+  SheetFormatPr,
+  SheetProtection,
+} from "./sheetProperties.js";
+
+export type {
+  PageMargins,
+  PageSetup,
+  PrintOptions,
+  HeaderFooter,
+  Break,
+  PageBreak,
+} from "./pageLayout.js";
+
+export type {
+  Drawing,
+  TablePart,
+  TableParts,
+  Extension,
+  ExtensionList,
+  OleObjects,
+  Controls,
+} from "./misc.js";
+
+export type {
+  Sparkline,
+  SparklineGroup,
+  SparklineGroups,
+} from "./sparkline.js";
+
+export type {
+  CellFormula,
+  RunProperties,
+  RichTextRun,
+  InlineString,
+  Cell,
+  Row,
+  SheetData,
+} from "./sheetData.js";
+
+export type { Selection, Pane, SheetView, SheetViews } from "./sheetViews.js";
+
+export type {
+  MergeCell,
+  MergeCells,
+  ConditionalFormattingValueObject,
+  ColorScale,
+  DataBar,
+  IconSet,
+  CfRule,
+  CfRuleExtension,
+  ConditionalFormatting,
+  DataValidation,
+  DataValidations,
+  FilterColumn,
+  AutoFilter,
+  SortCondition,
+  SortState,
+  X14ConditionalFormattingValueObject,
+  X14DataBar,
+  X14CfIcon,
+  X14IconSet,
+  X14CfRule,
+  X14ConditionalFormatting,
+  X14ConditionalFormattings,
+  Hyperlink,
+  Hyperlinks,
+} from "./dataFeatures.js";
+
+export type {
+  PhoneticRun,
+  PhoneticProperties,
+  StringItem,
+  SharedStringTable,
+} from "./sharedStrings.js";
+
+export type {
+  FileVersion,
+  WorkbookPr,
+  WorkbookProtection,
+  WorkbookView,
+  BookViews,
+  Sheet,
+  Sheets,
+  DefinedName,
+  DefinedNames,
+  CalcPr,
+  PivotCache,
+  PivotCaches,
+  ExternalReference,
+  ExternalReferences,
+  Workbook,
+} from "./workbook.js";
+
+export type {
+  MetadataType,
+  MetadataTypes,
+  MetadataRecord,
+  MetadataBlock,
+  MetadataBlocks,
+  DynamicArrayProperties,
+  MetadataExtension,
+  FutureMetadataBlock,
+  FutureMetadata,
+  Metadata,
+} from "./metadata.js";
+
+export type {
+  NumFmt,
+  NumFmts,
+  Font,
+  Fonts,
+  PatternFill,
+  GradientStop,
+  GradientFill,
+  Fill,
+  Fills,
+  BorderEdge,
+  Border,
+  Borders,
+  Alignment,
+  CellProtection,
+  CellFormat,
+  CellFormats,
+  CellStyle,
+  CellStyles,
+  DifferentialFormat,
+  DifferentialFormats,
+  TableStyle,
+  TableStyles,
+  RgbColor,
+  IndexedColors,
+  MruColors,
+  Colors,
+  StyleSheet,
+} from "./styles.js";
+
+export type {
+  CommentText,
+  Comment,
+  CommentList,
+  Authors,
+  Comments,
+} from "./comments.js";
+
+export type {
+  TableColumn,
+  TableColumns,
+  TableStyleInfo,
+  Table,
+} from "./table.js";
+
+export type { WorksheetExtension, Worksheet } from "./worksheet.js";