@rowsncolumns/utils 9.3.0 → 9.5.0

package/dist/cjs/table-names.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Excel's rules for a table name (Table Design → Table Name / "Rename an Excel table"):
+ *
+ * - starts with a letter, an underscore (`_`) or a backslash (`\`);
+ * - the rest is letters, digits, periods (`.`) and underscores — no spaces;
+ * - is not a cell reference (`A1`, `R1C1`, `XFD1048576`) and not the lone `C` / `R` shortcuts;
+ * - is at most 255 characters;
+ * - is unique across the workbook, compared case-insensitively — against the other tables AND the
+ *   defined names (Excel refuses a table named like an existing defined name, and a defined name
+ *   spelled like an existing table).
+ *
+ * Both engines create and rename tables through these checks (the rnc store mirrors them in Rust and
+ * surfaces the same messages through its `rejections` channel), and the table editor's validation
+ * schema shows the same text under the name field.
+ */
+export declare const TABLE_NAME_MAX_LENGTH = 255;
+export declare const TABLE_NAME_REQUIRED_MESSAGE = "Enter a table name.";
+export declare const TABLE_NAME_TOO_LONG_MESSAGE = "Table names can't be longer than 255 characters.";
+export declare const TABLE_NAME_SPACES_MESSAGE = "Table names can't contain spaces.";
+export declare const TABLE_NAME_LEADING_CHAR_MESSAGE = "Table names must start with a letter, an underscore (_) or a backslash (\\).";
+export declare const TABLE_NAME_INVALID_CHAR_MESSAGE = "Table names can only contain letters, numbers, periods (.) and underscores (_).";
+export declare const TABLE_NAME_CELL_REFERENCE_MESSAGE = "Table names can't be a cell reference such as A1 or R1C1.";
+export declare const tableNameDuplicateMessage: (existing: string) => string;
+export declare const tableNameDefinedNameMessage: (existing: string) => string;
+/** `create-table` with an `id` an existing table already holds is refused on both engines (#668 T-56). */
+export declare const tableIdDuplicateMessage: (id: string | number) => string;
+export declare const definedNameTableNameMessage: (existing: string) => string;
+/** True when `name` reads as a cell reference in either A1 or R1C1 notation. */
+export declare const isCellReferenceLikeName: (name: string) => boolean;
+/**
+ * The reason `name` is not an acceptable table name, or `undefined` when it is. `existingNames` are
+ * the OTHER tables' names in the workbook (leave the table being renamed out of it) and
+ * `existingDefinedNames` the workbook's defined names; duplicates against either are detected
+ * case-insensitively, the way Excel compares names.
+ */
+export declare const validateTableName: (name: string, existingNames?: Iterable<string> | null, existingDefinedNames?: Iterable<string> | null) => string | undefined;
+export declare const isValidTableName: (name: string, existingNames?: Iterable<string> | null, existingDefinedNames?: Iterable<string> | null) => boolean;
+/**
+ * The reason a defined name `name` cannot be created or renamed to — it is spelled like one of
+ * `tableNames` (case-insensitive) — or `undefined` when no table holds it. Excel keeps tables and
+ * defined names in one namespace.
+ */
+export declare const validateDefinedNameAgainstTables: (name: string, tableNames?: Iterable<string> | null) => string | undefined;
+/**
+ * The default name for a new table: `Table1`, `Table2`, … — the LOWEST number no existing table
+ * uses (case-insensitive), so a deleted table's number is reissued and the result never collides.
+ * `format` localises the pattern (`(n) => \`Tabelle${n}\``).
+ */
+export declare const getNextTableName: (existingNames: Iterable<string>, format?: (index: number) => string) => string;
+/**
+ * The name for a copy of table `base`: `Sales2`, `Sales3`, … — the LOWEST number no existing table
+ * uses (case-insensitive), the way Excel names the table on a duplicated sheet.
+ */
+export declare const getNextTableCopyName: (base: string, existingNames: Iterable<string>) => string;
+//# sourceMappingURL=table-names.d.ts.map

package/dist/cjs/table-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-names.d.ts","sourceRoot":"","sources":["../../table-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAYzC,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,2BAA2B,qDAA0E,CAAC;AACnH,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAC7E,eAAO,MAAM,+BAA+B,iFACoC,CAAC;AACjF,eAAO,MAAM,+BAA+B,oFACuC,CAAC;AACpF,eAAO,MAAM,iCAAiC,8DACe,CAAC;AAC9D,eAAO,MAAM,yBAAyB,GAAI,UAAU,MAAM,WACkC,CAAC;AAC7F,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,WACmD,CAAC;AAChH,0GAA0G;AAC1G,eAAO,MAAM,uBAAuB,GAAI,IAAI,MAAM,GAAG,MAAM,WACK,CAAC;AACjE,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,WACkD,CAAC;AAmB/G,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,OAGzB,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,gBAAgB,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,EACvC,uBAAuB,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,KAC7C,MAAM,GAAG,SA4BX,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,gBAAgB,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,EACvC,uBAAuB,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,KAC7C,OACyE,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,EACZ,aAAa,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,KACnC,MAAM,GAAG,SAGX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,QAAQ,CAAC,MAAM,CAAC,EAC/B,SAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,MAAmC,KAC7D,MAUF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,eAAe,QAAQ,CAAC,MAAM,CAAC,KAC9B,MAUF,CAAC"}

package/dist/cjs/table-names.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextTableCopyName = exports.getNextTableName = exports.validateDefinedNameAgainstTables = exports.isValidTableName = exports.validateTableName = exports.isCellReferenceLikeName = exports.definedNameTableNameMessage = exports.tableIdDuplicateMessage = exports.tableNameDefinedNameMessage = exports.tableNameDuplicateMessage = exports.TABLE_NAME_CELL_REFERENCE_MESSAGE = exports.TABLE_NAME_INVALID_CHAR_MESSAGE = exports.TABLE_NAME_LEADING_CHAR_MESSAGE = exports.TABLE_NAME_SPACES_MESSAGE = exports.TABLE_NAME_TOO_LONG_MESSAGE = exports.TABLE_NAME_REQUIRED_MESSAGE = exports.TABLE_NAME_MAX_LENGTH = void 0;
+var tslib_1 = require("tslib");
+/**
+ * Excel's rules for a table name (Table Design → Table Name / "Rename an Excel table"):
+ *
+ * - starts with a letter, an underscore (`_`) or a backslash (`\`);
+ * - the rest is letters, digits, periods (`.`) and underscores — no spaces;
+ * - is not a cell reference (`A1`, `R1C1`, `XFD1048576`) and not the lone `C` / `R` shortcuts;
+ * - is at most 255 characters;
+ * - is unique across the workbook, compared case-insensitively — against the other tables AND the
+ *   defined names (Excel refuses a table named like an existing defined name, and a defined name
+ *   spelled like an existing table).
+ *
+ * Both engines create and rename tables through these checks (the rnc store mirrors them in Rust and
+ * surfaces the same messages through its `rejections` channel), and the table editor's validation
+ * schema shows the same text under the name field.
+ */
+exports.TABLE_NAME_MAX_LENGTH = 255;
+// Built with `RegExp` (not literals) so the `u` flag survives the CJS build's ES5 target.
+var LEADING_CHAR = new RegExp("^[\\p{L}_\\\\]", "u");
+var BODY_CHARS = new RegExp("^[\\p{L}\\p{N}._]*$", "u");
+/** `A1`-style — up to three ASCII column letters then a row number. */
+var A1_REFERENCE = /^[A-Za-z]{1,3}\d+$/;
+/** `R1C1`-style — `R`/`C` each followed by an optional index (`RC`, `R1C`, `R1C1`). */
+var R1C1_REFERENCE = /^[Rr]\d*[Cc]\d*$/;
+/** `C` and `R` alone select the active cell's column / row in the Name Box. */
+var RESERVED_SHORTCUT = /^[CcRr]$/;
+exports.TABLE_NAME_REQUIRED_MESSAGE = "Enter a table name.";
+exports.TABLE_NAME_TOO_LONG_MESSAGE = "Table names can't be longer than ".concat(exports.TABLE_NAME_MAX_LENGTH, " characters.");
+exports.TABLE_NAME_SPACES_MESSAGE = "Table names can't contain spaces.";
+exports.TABLE_NAME_LEADING_CHAR_MESSAGE = "Table names must start with a letter, an underscore (_) or a backslash (\\).";
+exports.TABLE_NAME_INVALID_CHAR_MESSAGE = "Table names can only contain letters, numbers, periods (.) and underscores (_).";
+exports.TABLE_NAME_CELL_REFERENCE_MESSAGE = "Table names can't be a cell reference such as A1 or R1C1.";
+var tableNameDuplicateMessage = function (existing) {
+    return "A table named \"".concat(existing, "\" already exists in this workbook. Table names must be unique.");
+};
+exports.tableNameDuplicateMessage = tableNameDuplicateMessage;
+var tableNameDefinedNameMessage = function (existing) {
+    return "A defined name \"".concat(existing, "\" already exists in this workbook. Table names and defined names must be unique.");
+};
+exports.tableNameDefinedNameMessage = tableNameDefinedNameMessage;
+/** `create-table` with an `id` an existing table already holds is refused on both engines (#668 T-56). */
+var tableIdDuplicateMessage = function (id) {
+    return "A table with the id \"".concat(id, "\" already exists in this workbook.");
+};
+exports.tableIdDuplicateMessage = tableIdDuplicateMessage;
+var definedNameTableNameMessage = function (existing) {
+    return "A table named \"".concat(existing, "\" already exists in this workbook. Table names and defined names must be unique.");
+};
+exports.definedNameTableNameMessage = definedNameTableNameMessage;
+/** The entry of `names` that equals `name` case-insensitively, the way Excel compares names. */
+var findNameCollision = function (name, names) {
+    var e_1, _a;
+    if (!names) {
+        return undefined;
+    }
+    var lower = name.toLowerCase();
+    try {
+        for (var names_1 = tslib_1.__values(names), names_1_1 = names_1.next(); !names_1_1.done; names_1_1 = names_1.next()) {
+            var existing = names_1_1.value;
+            if (existing.toLowerCase() === lower) {
+                return existing;
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (names_1_1 && !names_1_1.done && (_a = names_1.return)) _a.call(names_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return undefined;
+};
+/** True when `name` reads as a cell reference in either A1 or R1C1 notation. */
+var isCellReferenceLikeName = function (name) {
+    return A1_REFERENCE.test(name) ||
+        R1C1_REFERENCE.test(name) ||
+        RESERVED_SHORTCUT.test(name);
+};
+exports.isCellReferenceLikeName = isCellReferenceLikeName;
+/**
+ * The reason `name` is not an acceptable table name, or `undefined` when it is. `existingNames` are
+ * the OTHER tables' names in the workbook (leave the table being renamed out of it) and
+ * `existingDefinedNames` the workbook's defined names; duplicates against either are detected
+ * case-insensitively, the way Excel compares names.
+ */
+var validateTableName = function (name, existingNames, existingDefinedNames) {
+    if (!name) {
+        return exports.TABLE_NAME_REQUIRED_MESSAGE;
+    }
+    if (name.length > exports.TABLE_NAME_MAX_LENGTH) {
+        return exports.TABLE_NAME_TOO_LONG_MESSAGE;
+    }
+    if (/\s/.test(name)) {
+        return exports.TABLE_NAME_SPACES_MESSAGE;
+    }
+    if (!LEADING_CHAR.test(name)) {
+        return exports.TABLE_NAME_LEADING_CHAR_MESSAGE;
+    }
+    if (!BODY_CHARS.test(name.slice(1))) {
+        return exports.TABLE_NAME_INVALID_CHAR_MESSAGE;
+    }
+    if ((0, exports.isCellReferenceLikeName)(name)) {
+        return exports.TABLE_NAME_CELL_REFERENCE_MESSAGE;
+    }
+    var duplicate = findNameCollision(name, existingNames);
+    if (duplicate !== undefined) {
+        return (0, exports.tableNameDuplicateMessage)(duplicate);
+    }
+    var definedName = findNameCollision(name, existingDefinedNames);
+    if (definedName !== undefined) {
+        return (0, exports.tableNameDefinedNameMessage)(definedName);
+    }
+    return undefined;
+};
+exports.validateTableName = validateTableName;
+var isValidTableName = function (name, existingNames, existingDefinedNames) {
+    return (0, exports.validateTableName)(name, existingNames, existingDefinedNames) === undefined;
+};
+exports.isValidTableName = isValidTableName;
+/**
+ * The reason a defined name `name` cannot be created or renamed to — it is spelled like one of
+ * `tableNames` (case-insensitive) — or `undefined` when no table holds it. Excel keeps tables and
+ * defined names in one namespace.
+ */
+var validateDefinedNameAgainstTables = function (name, tableNames) {
+    var table = findNameCollision(name, tableNames);
+    return table === undefined ? undefined : (0, exports.definedNameTableNameMessage)(table);
+};
+exports.validateDefinedNameAgainstTables = validateDefinedNameAgainstTables;
+/**
+ * The default name for a new table: `Table1`, `Table2`, … — the LOWEST number no existing table
+ * uses (case-insensitive), so a deleted table's number is reissued and the result never collides.
+ * `format` localises the pattern (`(n) => \`Tabelle${n}\``).
+ */
+var getNextTableName = function (existingNames, format) {
+    var e_2, _a;
+    if (format === void 0) { format = function (index) { return "Table".concat(index); }; }
+    var taken = new Set();
+    try {
+        for (var existingNames_1 = tslib_1.__values(existingNames), existingNames_1_1 = existingNames_1.next(); !existingNames_1_1.done; existingNames_1_1 = existingNames_1.next()) {
+            var name_1 = existingNames_1_1.value;
+            taken.add(name_1.toLowerCase());
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (existingNames_1_1 && !existingNames_1_1.done && (_a = existingNames_1.return)) _a.call(existingNames_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    var index = 1;
+    while (taken.has(format(index).toLowerCase())) {
+        index++;
+    }
+    return format(index);
+};
+exports.getNextTableName = getNextTableName;
+/**
+ * The name for a copy of table `base`: `Sales2`, `Sales3`, … — the LOWEST number no existing table
+ * uses (case-insensitive), the way Excel names the table on a duplicated sheet.
+ */
+var getNextTableCopyName = function (base, existingNames) {
+    var e_3, _a;
+    var taken = new Set();
+    try {
+        for (var existingNames_2 = tslib_1.__values(existingNames), existingNames_2_1 = existingNames_2.next(); !existingNames_2_1.done; existingNames_2_1 = existingNames_2.next()) {
+            var name_2 = existingNames_2_1.value;
+            taken.add(name_2.toLowerCase());
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (existingNames_2_1 && !existingNames_2_1.done && (_a = existingNames_2.return)) _a.call(existingNames_2);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    var index = 2;
+    while (taken.has("".concat(base).concat(index).toLowerCase())) {
+        index++;
+    }
+    return "".concat(base).concat(index);
+};
+exports.getNextTableCopyName = getNextTableCopyName;

package/dist/cjs/table-styles.d.ts

@@ -32,6 +32,15 @@ export type BandingProperties = {
     secondBandBorder?: Maybe<Borders>;
     totalRowColor?: Maybe<Color>;
     totalRowBorder?: Maybe<Borders>;
+    /**
+     * Fill of the table's first / last column when the table shows them (`TableView.showFirstColumn`
+     * / `showLastColumn` — Excel's Table Design → First Column / Last Column). Every built-in style
+     * emphasises those columns in bold; only the Dark styles add a fill.
+     */
+    firstColumnColor?: Maybe<Color>;
+    lastColumnColor?: Maybe<Color>;
+    /** Excel's `totalRow` style element bolds the totals row. */
+    totalRowBold?: Maybe<boolean>;
 };
 export type BandedDefinition = {
     rowProperties?: Maybe<BandingProperties>;

package/dist/cjs/table-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-styles.d.ts","sourceRoot":"","sources":["../../table-styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAG5C,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAExC,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,cAAc,GACd,aAAa,GACb,QAAQ,CAAC;AAGb,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,WAAW,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,cAAc,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,gBAAgB,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,UAAU;IACjB,mBAAmB,EAAE,MAAM,GAAG,SAAS;IACvC,cAAc,EAAE,MAAM,GAAG,SAAS;IAClC,cAAc,EAAE,gBAAgB,GAAG,SAAS;CAC7C,CAAC;AAKF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,gBAAgB,OAAO,GAAG,SAAS,EACnC,mBAAmB,OAAO,GAAG,SAAS,KACrC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAmV/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,YAAY,UAAU,EACtB,gBAAgB,OAAO,GAAG,SAAS,EACnC,mBAAmB,OAAO,GAAG,SAAS,KACrC,gBAAgB,GAAG,SAcrB,CAAC"}
+{"version":3,"file":"table-styles.d.ts","sourceRoot":"","sources":["../../table-styles.ts"],"names":[],"mappings":"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"}

package/dist/cjs/table-styles.js

@@ -12,10 +12,12 @@ var colorIndexes = [1, 4, 5, 6, 7, 8, 9];
  * Get table border styles map with all table themes and their banded definitions
  */
 var getTableBorderStyles = function (showRowStripes, showColumnStripes) {
+    var e_1, _a, e_2, _b;
+    var _c, _d, _e, _f, _g, _h, _j, _k, _l;
     var runningLightIndex = 1;
     var runningMediumIndex = 1;
     var runningDarkIndex = 1;
-    return new Map([
+    var styles = new Map([
         [
             "Light",
             tslib_1.__spreadArray(tslib_1.__spreadArray(tslib_1.__spreadArray([
@@ -280,6 +282,10 @@ var getTableBorderStyles = function (showRowStripes, showColumnStripes) {
             tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(colorIndexes.map(function (value) {
                 var firstTint = value - 1 === 0 ? 0.25 : -0.25;
                 var secondTint = value - 1 === 0 ? 0.5 : 0;
+                var edgeColumnColor = {
+                    theme: value,
+                    tint: value - 1 === 0 ? 0.15 : -0.5,
+                };
                 return [
                     ("TableStyleDark" + runningDarkIndex++),
                     firstTint,
@@ -295,6 +301,8 @@ var getTableBorderStyles = function (showRowStripes, showColumnStripes) {
                                 theme: value,
                                 tint: secondTint,
                             },
+                            firstColumnColor: edgeColumnColor,
+                            lastColumnColor: edgeColumnColor,
                         },
                         columnProperties: showColumnStripes
                             ? {
@@ -309,6 +317,10 @@ var getTableBorderStyles = function (showRowStripes, showColumnStripes) {
             })), false), tslib_1.__read([1, 5, 7, 9].map(function (value) {
                 var firstTint = value - 1 === 0 ? -0.35 : 0.6;
                 var secondTint = value - 1 === 0 ? -0.15 : 0.8;
+                var edgeColumnColor = {
+                    theme: value - 1,
+                    tint: value - 1 === 0 ? -0.5 : 0.4,
+                };
                 return [
                     ("TableStyleDark" + runningDarkIndex++),
                     firstTint,
@@ -324,6 +336,8 @@ var getTableBorderStyles = function (showRowStripes, showColumnStripes) {
                                 theme: value - 1,
                                 tint: secondTint,
                             },
+                            firstColumnColor: edgeColumnColor,
+                            lastColumnColor: edgeColumnColor,
                         },
                         columnProperties: showColumnStripes
                             ? {
@@ -338,6 +352,44 @@ var getTableBorderStyles = function (showRowStripes, showColumnStripes) {
             })), false),
         ],
     ]);
+    try {
+        // Excel's built-in table styles bold the totals row and rule it with a double top border in
+        // the style's accent colour — the header border's colour, else the header fill's, else the
+        // stripe border's.
+        for (var _m = tslib_1.__values(styles.values()), _o = _m.next(); !_o.done; _o = _m.next()) {
+            var entries = _o.value;
+            try {
+                for (var entries_1 = (e_2 = void 0, tslib_1.__values(entries)), entries_1_1 = entries_1.next(); !entries_1_1.done; entries_1_1 = entries_1.next()) {
+                    var _p = tslib_1.__read(entries_1_1.value, 4), bandDefinition = _p[3];
+                    var rows = bandDefinition === null || bandDefinition === void 0 ? void 0 : bandDefinition.rowProperties;
+                    if (!rows)
+                        continue;
+                    rows.totalRowBold = true;
+                    var accent = (_j = (_h = (_e = (_d = (_c = rows.headerBorder) === null || _c === void 0 ? void 0 : _c.top) === null || _d === void 0 ? void 0 : _d.color) !== null && _e !== void 0 ? _e : (_g = (_f = rows.headerBorder) === null || _f === void 0 ? void 0 : _f.bottom) === null || _g === void 0 ? void 0 : _g.color) !== null && _h !== void 0 ? _h : rows.headerColor) !== null && _j !== void 0 ? _j : (_l = (_k = rows.firstBandBorder) === null || _k === void 0 ? void 0 : _k.bottom) === null || _l === void 0 ? void 0 : _l.color;
+                    if (accent && !rows.totalRowBorder) {
+                        rows.totalRowBorder = {
+                            top: { width: 1, style: "double", color: accent },
+                        };
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (entries_1_1 && !entries_1_1.done && (_b = entries_1.return)) _b.call(entries_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_o && !_o.done && (_a = _m.return)) _a.call(_m);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return styles;
 };
 exports.getTableBorderStyles = getTableBorderStyles;
 /**

package/dist/cjs/table-totals.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Excel's table totals row: the `totalsRowFunction` values a `<tableColumn>` carries
+ * (ECMA-376 `ST_TotalsRowFunction`), the hidden-row-aware `SUBTOTAL` number each one
+ * writes into the totals cell, and the structured-reference formula for it.
+ */
+export declare const TOTALS_ROW_FUNCTIONS: readonly ["none", "average", "count", "countNums", "max", "min", "sum", "stdDev", "var", "custom"];
+export type TotalsRowFunction = (typeof TOTALS_ROW_FUNCTIONS)[number];
+/**
+ * `SUBTOTAL` function numbers of the 101–111 family (ignore rows hidden by a filter),
+ * as Excel writes them into a totals-row cell. `none` and `custom` have none.
+ */
+export declare const TOTALS_ROW_FUNCTION_SUBTOTAL: Readonly<Partial<Record<TotalsRowFunction, number>>>;
+export declare const isTotalsRowFunction: (value: unknown) => value is TotalsRowFunction;
+/**
+ * Escape a column name for use inside a structured reference: `[`, `]`, `#`
+ * and `'` are prefixed with `'`, as Excel does (`Sales[Amount '[est']]`).
+ */
+export declare const escapeStructuredColumnName: (name: string) => string;
+/**
+ * The totals-row formula for `fn` over a table column, qualified with the table
+ * name so it evaluates from any engine and matches what Excel writes:
+ * `=SUBTOTAL(109,Sales[Amount])`. `undefined` for `none` / `custom`.
+ */
+export declare const getTotalsRowFormula: (fn: TotalsRowFunction, tableName: string, columnName: string) => string | undefined;
+/**
+ * Recognise the aggregation a totals-row formula uses. Both the hidden-row-aware
+ * (1xx) and plain (1–11) `SUBTOTAL` numbers map to the same function; anything
+ * else is `none`.
+ */
+export declare const getTotalsRowFunctionFromFormula: (formula: string | null | undefined) => TotalsRowFunction;
+//# sourceMappingURL=table-totals.d.ts.map

package/dist/cjs/table-totals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-totals.d.ts","sourceRoot":"","sources":["../../table-totals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,oGAWvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAU3C,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,OAAO,KACb,KAAK,IAAI,iBAEiD,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,WACnB,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,IAAI,iBAAiB,EACrB,WAAW,MAAM,EACjB,YAAY,MAAM,KACjB,MAAM,GAAG,SAQX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAC1C,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,KACjC,iBAcF,CAAC"}

package/dist/cjs/table-totals.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTotalsRowFunctionFromFormula = exports.getTotalsRowFormula = exports.escapeStructuredColumnName = exports.isTotalsRowFunction = exports.TOTALS_ROW_FUNCTION_SUBTOTAL = exports.TOTALS_ROW_FUNCTIONS = void 0;
+var tslib_1 = require("tslib");
+/**
+ * Excel's table totals row: the `totalsRowFunction` values a `<tableColumn>` carries
+ * (ECMA-376 `ST_TotalsRowFunction`), the hidden-row-aware `SUBTOTAL` number each one
+ * writes into the totals cell, and the structured-reference formula for it.
+ */
+exports.TOTALS_ROW_FUNCTIONS = [
+    "none",
+    "average",
+    "count",
+    "countNums",
+    "max",
+    "min",
+    "sum",
+    "stdDev",
+    "var",
+    "custom",
+];
+/**
+ * `SUBTOTAL` function numbers of the 101–111 family (ignore rows hidden by a filter),
+ * as Excel writes them into a totals-row cell. `none` and `custom` have none.
+ */
+exports.TOTALS_ROW_FUNCTION_SUBTOTAL = {
+    average: 101,
+    countNums: 102,
+    count: 103,
+    max: 104,
+    min: 105,
+    stdDev: 107,
+    sum: 109,
+    var: 110,
+};
+var isTotalsRowFunction = function (value) {
+    return typeof value === "string" &&
+        exports.TOTALS_ROW_FUNCTIONS.includes(value);
+};
+exports.isTotalsRowFunction = isTotalsRowFunction;
+/**
+ * Escape a column name for use inside a structured reference: `[`, `]`, `#`
+ * and `'` are prefixed with `'`, as Excel does (`Sales[Amount '[est']]`).
+ */
+var escapeStructuredColumnName = function (name) {
+    return name.replace(/(['\[\]#])/g, "'$1");
+};
+exports.escapeStructuredColumnName = escapeStructuredColumnName;
+/**
+ * The totals-row formula for `fn` over a table column, qualified with the table
+ * name so it evaluates from any engine and matches what Excel writes:
+ * `=SUBTOTAL(109,Sales[Amount])`. `undefined` for `none` / `custom`.
+ */
+var getTotalsRowFormula = function (fn, tableName, columnName) {
+    var subtotal = exports.TOTALS_ROW_FUNCTION_SUBTOTAL[fn];
+    if (subtotal === undefined) {
+        return undefined;
+    }
+    return "=SUBTOTAL(".concat(subtotal, ",").concat(tableName, "[").concat((0, exports.escapeStructuredColumnName)(columnName), "])");
+};
+exports.getTotalsRowFormula = getTotalsRowFormula;
+/**
+ * Recognise the aggregation a totals-row formula uses. Both the hidden-row-aware
+ * (1xx) and plain (1–11) `SUBTOTAL` numbers map to the same function; anything
+ * else is `none`.
+ */
+var getTotalsRowFunctionFromFormula = function (formula) {
+    var _a;
+    if (!formula) {
+        return "none";
+    }
+    var match = /^\s*=\s*SUBTOTAL\s*\(\s*(\d{1,3})\s*,/i.exec(formula);
+    if (!match) {
+        return "none";
+    }
+    var number = Number(match[1]);
+    var normalized = number > 100 ? number - 100 : number;
+    var found = Object.entries(exports.TOTALS_ROW_FUNCTION_SUBTOTAL).find(function (_a) {
+        var _b = tslib_1.__read(_a, 2), subtotal = _b[1];
+        return subtotal - 100 === normalized;
+    });
+    return (_a = found === null || found === void 0 ? void 0 : found[0]) !== null && _a !== void 0 ? _a : "none";
+};
+exports.getTotalsRowFunctionFromFormula = getTotalsRowFunctionFromFormula;

package/dist/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../array.ts","../../cell-data-helpers.ts","../../color.ts","../../colors.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../excel-number-format.ts","../../formatter.ts","../../formula-locale.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../keyboard.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../selection.ts","../../shared-string-canonical.ts","../../sheet-span.ts","../../sort.ts","../../string.ts","../../table-styles.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts","../../formula-locale/formula-locale-data.generated.ts"],"version":"5.8.3"}
+{"root":["../../array.ts","../../cell-data-helpers.ts","../../color.ts","../../colors.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../excel-number-format.ts","../../formatter.ts","../../formula-locale.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../keyboard.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../rich-text-html.ts","../../rich-text-links.ts","../../selection.ts","../../shared-string-canonical.ts","../../sheet-span.ts","../../sort.ts","../../sparkline-groups.ts","../../string.ts","../../table-names.ts","../../table-styles.ts","../../table-totals.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts","../../formula-locale/formula-locale-data.generated.ts"],"version":"5.8.3"}

package/dist/esm/index.d.ts

@@ -25,4 +25,9 @@ export * from "./shared-string-canonical";
 export * from "./keyboard";
 export * from "./sheet-span";
 export * from "./formula-locale";
+export * from "./table-names";
+export * from "./table-totals";
+export * from "./sparkline-groups";
+export * from "./rich-text-html";
+export * from "./rich-text-links";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/esm/index.js

@@ -25,3 +25,8 @@ export * from "./shared-string-canonical";
 export * from "./keyboard";
 export * from "./sheet-span";
 export * from "./formula-locale";
+export * from "./table-names";
+export * from "./table-totals";
+export * from "./sparkline-groups";
+export * from "./rich-text-html";
+export * from "./rich-text-links";

package/dist/esm/rich-text-html.d.ts

@@ -0,0 +1,82 @@
+import type { TextFormat, TextFormatRun } from "@rowsncolumns/common-types";
+/**
+ * Clipboard HTML → the engine's native rich-text shape.
+ *
+ * Google Sheets and Excel both put a cell's mixed formatting into `text/html`
+ * — Google as `<span style="…">` / `<a href>` runs inside a `<td>` (wrapped in
+ * `<google-sheets-html-origin>`), Excel as `<b>` / `<font color>` /
+ * `<font class="fontN">` (class rules in `<head><style>`) / `<span style>` /
+ * `<a href>` inside a `<td>`. This module is the ONE converter every paste
+ * target uses (the grid's cell paste in `spreadsheet-state/api/parse-html`,
+ * the formula bar and the in-cell editor in `ui/editor-pm`), so a rich cell
+ * lands identically wherever it is pasted:
+ *
+ * - `text` — the full text, whitespace normalized like `extractTextContent`
+ *   (source-newlines collapse to a space, `<br>` / block boundaries become
+ *   `\n`, outer whitespace trimmed).
+ * - `runs` — `TextFormatRun`s RELATIVE to `baseFormat` (only the properties a
+ *   segment changes), adjacent equal segments merged, empty formats dropped —
+ *   the same normal form `extractTextFormatRuns` produces from the editor.
+ *   `undefined` when the text is uniformly formatted (then `baseFormat`
+ *   already says everything).
+ * - `links` — every `<a href>` in document order, as `[start, end)` spans.
+ *   A link is also carried on its run as `format.link` (Google Sheets keeps
+ *   several links per cell), and the engines promote the first run link to the
+ *   cell-level `hyperlink` on commit (Excel keeps one link per cell).
+ * - `hyperlink` — the cell-level link: an anchor wrapping the whole text
+ *   (Excel), else the first link.
+ * - `baseFormat` — the container's own formatting (the `<td>` class / inline
+ *   style), i.e. the CELL-level text format of the source cell.
+ *
+ * Styles are read from the inline `style`, the tag semantics and
+ * `getComputedStyle` (the element must be mounted — see
+ * {@link mountClipboardHtml}) so Excel's class-based `<font class="fontN">`
+ * runs resolve. `<a>` elements read inline styles only: a browser's UA sheet
+ * would otherwise paint every pasted link `-webkit-link` blue.
+ */
+export type RichTextLink = {
+    startIndex: number;
+    endIndex: number;
+    uri: string;
+};
+export type ParsedRichText = {
+    text: string;
+    runs: TextFormatRun[] | undefined;
+    links: RichTextLink[];
+    hyperlink: string | undefined;
+    baseFormat: TextFormat;
+    /** Mixed formatting or at least one link — the reasons to prefer runs over flat text. */
+    isRich: boolean;
+};
+/**
+ * Parse an HTML clipboard payload into a hidden, mounted sandbox so
+ * `getComputedStyle` resolves the payload's own `<style>` rules (Excel's
+ * `.fontN` / `.xlNN` classes). Callers must `cleanup()` when done.
+ */
+export declare const mountClipboardHtml: (clipboardValue: string) => {
+    root: HTMLDivElement;
+    cleanup: () => void;
+};
+export declare const cssColorToHex: (value: string | null | undefined) => string | undefined;
+/** CSS font-size → points. `pt` verbatim, `px` at 96dpi, `em`/`rem` on a 16px base. */
+export declare const cssFontSizeToPt: (value: string | null | undefined) => number | undefined;
+/**
+ * Convert a mounted element (a clipboard `<td>`, or the sandbox wrapper for
+ * table-less HTML) into the engine's rich-text shape. See the module doc.
+ */
+export declare const htmlElementToRichText: (root: HTMLElement) => ParsedRichText;
+/**
+ * The element a single-cell clipboard payload's text lives in: the lone
+ * `<td>`/`<th>` of a one-cell table (Excel / Google Sheets), or the mounted
+ * wrapper for table-less HTML. `undefined` for a multi-cell table — that is a
+ * grid paste, not a rich-text one.
+ */
+export declare const findSingleClipboardCell: (root: HTMLElement) => HTMLElement | undefined;
+/**
+ * One-shot helper for the editor targets: mount the clipboard HTML, convert
+ * the single cell it carries, clean up. `undefined` when the payload is a
+ * multi-cell table or carries no formatting/links worth keeping (the caller
+ * then falls back to its plain-text handling).
+ */
+export declare const clipboardHtmlToRichText: (html: string) => ParsedRichText | undefined;
+//# sourceMappingURL=rich-text-html.d.ts.map

package/dist/esm/rich-text-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text-html.d.ts","sourceRoot":"","sources":["../../rich-text-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,yFAAyF;IACzF,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAgGF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,MAAM;;;CAmBxD,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAC/B,MAAM,GAAG,SAkBX,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAC/B,MAAM,GAAG,SAoBX,CAAC;AA+SF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,WAAW,KAAG,cA+DzD,CAAC;AAgBF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,WAAW,KAChB,WAAW,GAAG,SAShB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,KACX,cAAc,GAAG,SAkBnB,CAAC"}