@rowsncolumns/utils 9.6.2 → 9.6.3

package/dist/esm/autocorrect.js

@@ -0,0 +1,76 @@
+export const DEFAULT_AUTOCORRECT_OPTIONS = {
+    capitalizeSentences: true,
+    replaceText: true,
+};
+/** The symbol entries of Office's built-in AutoCorrect list, longest first where they overlap. */
+export const AUTOCORRECT_REPLACEMENTS = [
+    [/\(c\)/gi, "©"],
+    [/\(r\)/gi, "®"],
+    [/\(tm\)/gi, "™"],
+    [/\(e\)/gi, "€"],
+    [/\.\.\./g, "…"],
+    [/<=>/g, "⇔"],
+    [/==>/g, "⇒"],
+    [/<==/g, "⇐"],
+    [/-->/g, "→"],
+    [/<--/g, "←"],
+];
+/**
+ * Abbreviations a period ends without ending the sentence, as Office's AutoCorrect exceptions list
+ * keeps them: the word after `e.g.` or `approx.` stays as typed.
+ */
+const SENTENCE_EXCEPTIONS = new Set([
+    "approx",
+    "co",
+    "dept",
+    "dr",
+    "etc",
+    "fig",
+    "inc",
+    "incl",
+    "jr",
+    "ltd",
+    "mr",
+    "mrs",
+    "ms",
+    "no",
+    "sr",
+    "st",
+    "vs",
+]);
+/** A sentence end (`.`, `!`, `?`), the space after it and the next word's first character. */
+const SENTENCE_START = /(\S*)([.!?])(\s+)(\S)/g;
+const capitalizeSentences = (text) => text.replace(SENTENCE_START, (match, word, end, space, letter) => {
+    const upper = letter.toUpperCase();
+    // Only a lower-case letter changes (not a digit, a symbol or a capital).
+    if (upper === letter || letter !== letter.toLowerCase())
+        return match;
+    if (end === ".") {
+        const bare = word.toLowerCase();
+        // `e.g.` / `i.e.` (a period inside the word) and the listed abbreviations.
+        if (bare.includes(".") || SENTENCE_EXCEPTIONS.has(bare))
+            return match;
+    }
+    return `${word}${end}${space}${upper}`;
+});
+const replaceText = (text) => AUTOCORRECT_REPLACEMENTS.reduce((current, [pattern, replacement]) => current.replace(pattern, replacement), text);
+/** An entry AutoCorrect leaves as typed: a formula, or a number. */
+const isAutoCorrectExempt = (text) => text.startsWith("=") || (text.trim() !== "" && Number.isFinite(Number(text)));
+/** A whole entry that is a web or email address, which the engines turn into a link. */
+const LINK_ENTRY = /^(?:(?:https?|ftp):\/\/|mailto:|www\.)\S+$|^[^\s@]+@[^\s@]+\.[^\s@]+$/i;
+const isLinkEntry = (text) => LINK_ENTRY.test(text.trim());
+/**
+ * The entry after AutoCorrect. `lengthPreserving` keeps the text the same length (only
+ * capitalisation), for an entry whose rich-text runs index into it.
+ */
+export const applyAutoCorrect = ({ text, options = DEFAULT_AUTOCORRECT_OPTIONS, lengthPreserving = false, }) => {
+    if (isAutoCorrectExempt(text) || isLinkEntry(text)) {
+        return text;
+    }
+    let next = text;
+    if (options.replaceText && !lengthPreserving)
+        next = replaceText(next);
+    if (options.capitalizeSentences)
+        next = capitalizeSentences(next);
+    return next;
+};

package/dist/esm/index.d.ts

@@ -34,4 +34,6 @@ export * from "./sparkline-groups";
 export * from "./rich-text-html";
 export * from "./clipboard-html-sanitize";
 export * from "./rich-text-links";
+export * from "./insert-date-time";
+export * from "./autocorrect";
 //# 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,qBAAqB,CAAC;AACpC,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,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,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,qBAAqB,CAAC;AACpC,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,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}

package/dist/esm/index.js

@@ -34,3 +34,5 @@ export * from "./sparkline-groups";
 export * from "./rich-text-html";
 export * from "./clipboard-html-sanitize";
 export * from "./rich-text-links";
+export * from "./insert-date-time";
+export * from "./autocorrect";

package/dist/esm/insert-date-time.d.ts

@@ -0,0 +1,17 @@
+/** What Excel's Ctrl+; and Ctrl+Shift+; type into a cell. */
+export type InsertedDateTimeKind = "date" | "time";
+/**
+ * The text Excel's Ctrl+; (the date) and Ctrl+Shift+; (the time) type, as the
+ * locale writes a short date or a time to the minute: en-US `11/3/2026` and
+ * `2:05 PM`, de-DE `3.11.2026` and `14:05`. It is the text a person would type,
+ * so committing it lets the date parser give the cell the matching Short Date
+ * or Time format ("Keyboard shortcuts in Excel", support.microsoft.com:
+ * "Enter the current date: Ctrl+Semicolon", "Enter the current time:
+ * Ctrl+Shift+Colon").
+ */
+export declare const formatInsertedDateTime: ({ kind, date, locale, }: {
+    kind: InsertedDateTimeKind;
+    date?: Date;
+    locale?: string;
+}) => string;
+//# sourceMappingURL=insert-date-time.d.ts.map

package/dist/esm/insert-date-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-date-time.d.ts","sourceRoot":"","sources":["../../insert-date-time.ts"],"names":[],"mappings":"AAQA,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAKnD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAAI,yBAIpC;IACD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,MAWH,CAAC"}

package/dist/esm/insert-date-time.js

@@ -0,0 +1,21 @@
+import { toSerial } from "./date";
+import { ssfFormat } from "./formatter";
+import { getCurrentLocale, getDefaultDateFormat, getDefaultTimeFormat, } from "./locale";
+/** ICU's narrow and plain no-break spaces (`2:05\u202fPM`), which a person types as a space. */
+const NO_BREAK_SPACES = /[\u00a0\u202f]/g;
+/**
+ * The text Excel's Ctrl+; (the date) and Ctrl+Shift+; (the time) type, as the
+ * locale writes a short date or a time to the minute: en-US `11/3/2026` and
+ * `2:05 PM`, de-DE `3.11.2026` and `14:05`. It is the text a person would type,
+ * so committing it lets the date parser give the cell the matching Short Date
+ * or Time format ("Keyboard shortcuts in Excel", support.microsoft.com:
+ * "Enter the current date: Ctrl+Semicolon", "Enter the current time:
+ * Ctrl+Shift+Colon").
+ */
+export const formatInsertedDateTime = ({ kind, date = new Date(), locale = getCurrentLocale(), }) => {
+    const serial = toSerial(date);
+    const text = kind === "date"
+        ? ssfFormat(getDefaultDateFormat(locale), Math.floor(serial), locale)
+        : ssfFormat(getDefaultTimeFormat(locale, "minute"), serial - Math.floor(serial), locale);
+    return text.replace(NO_BREAK_SPACES, " ");
+};

package/dist/esm/sparkline-groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sparkline-groups.d.ts","sourceRoot":"","sources":["../../sparkline-groups.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sparkline-groups.d.ts","sourceRoot":"","sources":["../../sparkline-groups.ts"],"names":[],"mappings":"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"}

package/dist/esm/sparkline-groups.js

@@ -31,6 +31,7 @@ const OPTION_KEYS = {
     min: "min",
     minaxistype: "minaxistype",
     maxaxistype: "maxaxistype",
+    group: "group",
 };
 /** Emission order of `buildSparklineFormula` — the XLSX importers' order, so a group written here
  * and a group read from a workbook produce byte-identical formulas. */
@@ -59,6 +60,7 @@ const OPTION_ORDER = [
     "min",
     "minaxistype",
     "maxaxistype",
+    "group",
 ];
 const SPARKLINE_HEAD = /^\s*=\s*SPARKLINE\s*\(/i;
 export const isSparklineFormula = (formula) => typeof formula === "string" && SPARKLINE_HEAD.test(formula);

package/dist/esm/table-style-presets.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by scripts/gen-table-style-presets.mjs from ECMA-376 presetTableStyles.xml — do not edit.
+ *
+ * Excel's built-in table styles, element by element. Colours stay theme + tint references so
+ * they resolve through the workbook theme.
+ */
+import type { TableStyleElements } from "./table-styles";
+export declare const TABLE_STYLE_PRESETS: Readonly<Record<string, TableStyleElements>>;
+//# sourceMappingURL=table-style-presets.d.ts.map

package/dist/esm/table-style-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-style-presets.d.ts","sourceRoot":"","sources":["../../table-style-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CA2iB5E,CAAC"}