@ricsam/formula-engine 0.2.11 → 0.2.13

package/dist/types/core/managers/style-manager.d.ts

@@ -70,9 +70,10 @@ export declare class StyleManager {
      */
     removeSheetStyles(workbookName: string, sheetName: string): void;
     /**
-     * Get the style for a specific cell
-     * Returns the first matching style (first match wins)
-     * Checks cellStyles first, then conditionalStyles
+     * Get the style for a specific cell.
+     * Direct cell styles compose in insertion order, with later styles overriding
+     * earlier styles for the same properties. Conditional styles then layer over
+     * direct styles for the properties they define.
      */
     getCellStyle(cellAddress: CellAddress): CellStyle | undefined;
     /**

package/dist/types/core/types.d.ts

@@ -371,14 +371,33 @@ export interface DirectCellStyle {
     areas: RangeAddress[];
     style: CellStyle;
 }
+export interface RangeMetadata<TMetadata = unknown> {
+    id: string;
+    areas: RangeAddress[];
+    metadata: TMetadata;
+}
+export interface RangeMetadataInput<TMetadata = unknown> {
+    id?: string;
+    areas: RangeAddress[];
+    metadata: TMetadata;
+}
 export interface CellStyle {
     backgroundColor?: string;
     color?: string;
+    borderColor?: string;
+    borderSides?: {
+        top?: boolean;
+        right?: boolean;
+        bottom?: boolean;
+        left?: boolean;
+    };
     fontSize?: number;
     bold?: boolean;
     italic?: boolean;
     underline?: boolean;
+    wrapText?: boolean;
 }
+export type CopyCellsIncludePart = "content" | "style" | "cellMetadata" | "rangeMetadata";
 export interface CopyCellsOptions {
     /**
      * Whether this is a cut operation (clears source cells after copying)
@@ -387,18 +406,19 @@ export interface CopyCellsOptions {
     cut?: boolean;
     /**
      * What to include in the copy operation.
-     * - Use 'all' as shorthand for ['content', 'style', 'metadata']
+     * - Use 'all' as shorthand for ['content', 'style', 'cellMetadata', 'rangeMetadata']
      * - Use array for fine-grained control over what to copy:
      *   - ['content'] - copy only values/formulas
      *   - ['style'] - copy only formatting
-     *   - ['metadata'] - copy only metadata (rich text, links, etc.)
+     *   - ['cellMetadata'] - copy only cell metadata (rich text, links, etc.)
+     *   - ['rangeMetadata'] - copy only range metadata
      *   - ['content', 'style'] - copy content and formatting
-     *   - ['content', 'metadata'] - copy content and metadata
-     *   - ['style', 'metadata'] - copy formatting and metadata
-     *   - ['content', 'style', 'metadata'] - same as 'all'
+     *   - ['content', 'cellMetadata'] - copy content and cell metadata
+     *   - ['style', 'rangeMetadata'] - copy formatting and range metadata
+     *   - ['content', 'style', 'cellMetadata', 'rangeMetadata'] - same as 'all'
      * @default 'all'
      */
-    include?: "all" | ("content" | "style" | "metadata")[];
+    include?: "all" | CopyCellsIncludePart[];
     /**
      * The type of the content to copy
      * value: Copy the value from the source to the target,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/formula-engine",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "module": "./dist/mjs/lib.mjs",
   "scripts": {
     "test": "bun test",