@lotics/xlsx 0.1.0

package/src/excel_cf_icons.ts

@@ -0,0 +1,108 @@
+/**
+ * Inline SVG icons for conditional formatting icon sets.
+ * Each icon is a small 16x16 SVG returned as a data URI.
+ */
+
+const SVG_PREFIX = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">';
+const SVG_SUFFIX = "</svg>";
+
+function svg(body: string): string {
+  return `data:image/svg+xml,${encodeURIComponent(SVG_PREFIX + body + SVG_SUFFIX)}`;
+}
+
+// Arrow icons
+const arrowUp = (color: string) => svg(`<path d="M8 2l5 8H3z" fill="${color}"/>`);
+const arrowRight = (color: string) => svg(`<path d="M2 4h8l-4 8z" fill="${color}" transform="rotate(-90 8 8)"/>`);
+const arrowDown = (color: string) => svg(`<path d="M8 14l5-8H3z" fill="${color}"/>`);
+const arrowUpRight = (color: string) => svg(`<path d="M4 12L12 4M12 4H6M12 4v6" stroke="${color}" stroke-width="2" fill="none"/>`);
+const arrowDownRight = (color: string) => svg(`<path d="M4 4L12 12M12 12H6M12 12V6" stroke="${color}" stroke-width="2" fill="none"/>`);
+
+// Circle/traffic light icons
+const circle = (color: string) => svg(`<circle cx="8" cy="8" r="6" fill="${color}"/>`);
+
+// Flag icons
+const flag = (color: string) => svg(`<path d="M3 2v12M3 2h8l-2 3 2 3H3" fill="${color}" stroke="${color}" stroke-width="1"/>`);
+
+// Star icons
+const star = (color: string) => svg(
+  `<path d="M8 1l2.2 4.5 5 .7-3.6 3.5.9 5L8 12.5 3.5 14.7l.9-5L0.8 6.2l5-.7z" fill="${color}"/>`,
+);
+const starEmpty = svg(
+  `<path d="M8 1l2.2 4.5 5 .7-3.6 3.5.9 5L8 12.5 3.5 14.7l.9-5L0.8 6.2l5-.7z" fill="none" stroke="#999" stroke-width="1"/>`,
+);
+
+// Diamond icons
+const diamond = (color: string) => svg(`<path d="M8 1L15 8L8 15L1 8z" fill="${color}"/>`);
+
+// Triangle icons
+const triangleUp = (color: string) => svg(`<path d="M8 3l5 10H3z" fill="${color}"/>`);
+const triangleDash = (color: string) => svg(`<rect x="2" y="6" width="12" height="4" rx="1" fill="${color}"/>`);
+const triangleDown = (color: string) => svg(`<path d="M8 13l5-10H3z" fill="${color}"/>`);
+
+// Quarter icons (pie chart segments)
+const quarter0 = svg(`<circle cx="8" cy="8" r="6" fill="none" stroke="#666" stroke-width="1.5"/>`);
+const quarter1 = svg(`<circle cx="8" cy="8" r="6" fill="none" stroke="#666" stroke-width="1.5"/><path d="M8 2a6 6 0 0 1 6 6H8z" fill="#666"/>`);
+const quarter2 = svg(`<circle cx="8" cy="8" r="6" fill="none" stroke="#666" stroke-width="1.5"/><path d="M8 2a6 6 0 0 1 0 12V2z" fill="#666"/>`);
+const quarter3 = svg(`<circle cx="8" cy="8" r="6" fill="none" stroke="#666" stroke-width="1.5"/><path d="M8 2a6 6 0 0 1 0 12A6 6 0 0 1 2 8h6z" fill="#666"/>`);
+const quarter4 = svg(`<circle cx="8" cy="8" r="6" fill="#666"/>`);
+
+// Box icons (rating bars)
+const box = (fill: boolean) => fill
+  ? svg(`<rect x="1" y="4" width="14" height="8" rx="1" fill="#666"/>`)
+  : svg(`<rect x="1" y="4" width="14" height="8" rx="1" fill="none" stroke="#999" stroke-width="1"/>`);
+
+// Sign icons
+const signTriangle = (color: string) => svg(`<path d="M8 2l6.5 12H1.5z" fill="${color}"/>`);
+const signCircle = (color: string) => svg(`<circle cx="8" cy="8" r="7" fill="${color}"/>`);
+
+// Symbol icons (check/exclamation/X)
+const symbolCheck = (color: string) => svg(`<circle cx="8" cy="8" r="7" fill="${color}"/><path d="M4.5 8l2 2 5-5" stroke="white" stroke-width="2" fill="none"/>`);
+const symbolExcl = (color: string) => svg(`<circle cx="8" cy="8" r="7" fill="${color}"/><text x="8" y="12" text-anchor="middle" fill="white" font-size="11" font-weight="bold">!</text>`);
+const symbolX = (color: string) => svg(`<circle cx="8" cy="8" r="7" fill="${color}"/><path d="M5 5l6 6M11 5l-6 6" stroke="white" stroke-width="2"/>`);
+
+// =============================================================================
+// Icon set definitions
+// =============================================================================
+
+type IconSetDef = string[];
+
+const ICON_SETS: Record<string, IconSetDef> = {
+  // 3-icon sets
+  "3Arrows": [arrowDown("#F44336"), arrowRight("#FFC107"), arrowUp("#4CAF50")],
+  "3ArrowsGray": [arrowDown("#666"), arrowRight("#999"), arrowUp("#333")],
+  "3Flags": [flag("#F44336"), flag("#FFC107"), flag("#4CAF50")],
+  "3Signs": [diamond("#F44336"), signTriangle("#FFC107"), signCircle("#4CAF50")],
+  "3Stars": [starEmpty, star("#FFC107"), star("#FFC107")],
+  "3Symbols": [symbolX("#F44336"), symbolExcl("#FFC107"), symbolCheck("#4CAF50")],
+  "3Symbols2": [symbolX("#F44336"), symbolExcl("#FFC107"), symbolCheck("#4CAF50")],
+  "3TrafficLights1": [circle("#F44336"), circle("#FFC107"), circle("#4CAF50")],
+  "3TrafficLights2": [circle("#F44336"), circle("#FFC107"), circle("#4CAF50")],
+  "3Triangles": [triangleDown("#F44336"), triangleDash("#FFC107"), triangleUp("#4CAF50")],
+
+  // 4-icon sets
+  "4Arrows": [arrowDown("#F44336"), arrowDownRight("#FF9800"), arrowUpRight("#FFC107"), arrowUp("#4CAF50")],
+  "4ArrowsGray": [arrowDown("#666"), arrowDownRight("#888"), arrowUpRight("#AAA"), arrowUp("#333")],
+  "4Rating": [box(false), box(true), box(true), box(true)],
+  "4RedToBlack": [circle("#000"), circle("#666"), circle("#FF9800"), circle("#F44336")],
+  "4TrafficLights": [circle("#000"), circle("#F44336"), circle("#FFC107"), circle("#4CAF50")],
+
+  // 5-icon sets
+  "5Arrows": [arrowDown("#F44336"), arrowDownRight("#FF9800"), arrowRight("#FFC107"), arrowUpRight("#8BC34A"), arrowUp("#4CAF50")],
+  "5ArrowsGray": [arrowDown("#666"), arrowDownRight("#777"), arrowRight("#888"), arrowUpRight("#999"), arrowUp("#333")],
+  "5Boxes": [box(false), box(true), box(true), box(true), box(true)],
+  "5Quarters": [quarter0, quarter1, quarter2, quarter3, quarter4],
+  "5Rating": [box(false), box(true), box(true), box(true), box(true)],
+
+  // NoIcons - empty set
+  NoIcons: [],
+};
+
+/**
+ * Get the SVG data URI for a specific icon in an icon set.
+ * Returns undefined if the icon set or index is invalid.
+ */
+export function getCfIcon(iconSet: string, index: number): string | undefined {
+  const icons = ICON_SETS[iconSet];
+  if (!icons || index < 0 || index >= icons.length) return undefined;
+  return icons[index];
+}

package/src/excel_cf_types.ts

@@ -0,0 +1,67 @@
+export interface ParsedConditionalFormat {
+  ref: string;
+  rules: ParsedCfRule[];
+}
+
+export type ParsedCfRule =
+  | ParsedColorScaleRule
+  | ParsedDataBarRule
+  | ParsedIconSetRule
+  | ParsedStyleRule;
+
+export interface CfThreshold {
+  type: "percentile" | "percent" | "num" | "min" | "max" | "formula" | "autoMin" | "autoMax";
+  value?: number;
+}
+
+export interface ParsedColorScaleRule {
+  ruleType: "colorScale";
+  priority: number;
+  /** Excel's <cfRule stopIfTrue="1">: when this rule matches a cell, lower-
+   *  priority rules on the same cell are skipped. */
+  stopIfTrue?: boolean;
+  colors: string[];
+}
+
+export interface ParsedDataBarRule {
+  ruleType: "dataBar";
+  priority: number;
+  stopIfTrue?: boolean;
+  color: string;
+  minLength: number;
+  maxLength: number;
+  showValue: boolean;
+}
+
+export interface ParsedIconSetRule {
+  ruleType: "iconSet";
+  priority: number;
+  stopIfTrue?: boolean;
+  iconSet: string;
+  thresholds: CfThreshold[];
+  showValue: boolean;
+  reverse: boolean;
+}
+
+export interface ParsedStyleRule {
+  ruleType: "style";
+  priority: number;
+  stopIfTrue?: boolean;
+  type: "cellIs" | "containsText" | "top10" | "aboveAverage" | "timePeriod" | "expression";
+  operator?: string;
+  formulae?: unknown[];
+  text?: string;
+  rank?: number;
+  percent?: boolean;
+  bottom?: boolean;
+  aboveAverage?: boolean;
+  timePeriod?: string;
+  style?: ParsedCfStyle;
+}
+
+export interface ParsedCfStyle {
+  fontBold?: boolean;
+  fontItalic?: boolean;
+  fontColor?: string;
+  backgroundColor?: string;
+}