@idevs/corelib 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-05-24
+
+### Added
+- **Csi/UI port — batch 1/4** (primitives from PowerACC):
+  - `helpers/windowHelper.ts` — `isSmallDevice()` responsive media-query check.
+  - `helpers/processQueryButtons.ts` — `addProcessQueryButtons()` factory for paired Query/Clear toolbar buttons.
+  - `types/gridEditableMode.ts` — `GridEditableMode` discriminated union (`Full` / `Off` / `Some`).
+  - `formatters/formatterHelper.ts` — `customerCodeFormatter`, `isNumericTemplate`, `isNumericInput` (filename fixes the original `Formater` typo).
+- 22 new unit tests covering the three modules above.
+
 ## [1.1.0] - 2026-05-23
 
 ### Added

package/dist/formatters/formatterHelper.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Apply a pattern mask to a value.
+ * - '0' and 'x' placeholders both consume the next alphanumeric character from
+ *   the value; they differ only in their padding char when the value is shorter
+ *   ('0' pads with '0', 'x' pads with a space).
+ * - All other pattern characters are literal separators copied through.
+ *
+ * Early-return guard: the input is first stripped of non-alphanumerics. If the
+ * pattern is composed entirely of '0' characters (no separators, e.g. "0000")
+ * AND the stripped value is not a pure digit string, the original value is
+ * returned untouched. That covers two cases:
+ *   - the stripped value contains a letter (e.g. "AB12")
+ *   - the stripped value is empty (raw input was empty or separators-only)
+ * Numeric masks that contain separators (e.g. "0000-00000-0") do NOT trigger
+ * this guard — this is the inherited behavior from the original PowerACC
+ * implementation.
+ */
+export declare function customerCodeFormatter(value: string, pattern: string): string;
+/**
+ * True when the pattern, after removing all '0' characters, contains only
+ * digits, whitespace, or the common separators (`. _ -`). In practice this
+ * means the pattern has no 'x' (letter) placeholders. Note: patterns
+ * consisting solely of separators (e.g. "-") or solely of literal digits
+ * (e.g. "123") also return true; the check is "no letter placeholders",
+ * not "has at least one '0' placeholder".
+ */
+export declare function isNumericTemplate(pattern: string): boolean;
+/** True when the value consists of digits once common separators (- _ . space) are stripped. */
+export declare function isNumericInput(value: string): boolean;
+//# sourceMappingURL=formatterHelper.d.ts.map

package/dist/formatters/formatterHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatterHelper.d.ts","sourceRoot":"","sources":["../../src/formatters/formatterHelper.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAwB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/formatters/formatterHelper.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customerCodeFormatter = customerCodeFormatter;
+exports.isNumericTemplate = isNumericTemplate;
+exports.isNumericInput = isNumericInput;
+const ALPHANUMERIC_STRIP = /[^0-9a-zA-Z]/g;
+const DIGITS_ONLY = /^\d+$/;
+const NUMERIC_TEMPLATE_RESIDUE = /^[0-9\s._-]+$/;
+const COMMON_SEPARATORS = /[\s._-]/g;
+/**
+ * Apply a pattern mask to a value.
+ * - '0' and 'x' placeholders both consume the next alphanumeric character from
+ *   the value; they differ only in their padding char when the value is shorter
+ *   ('0' pads with '0', 'x' pads with a space).
+ * - All other pattern characters are literal separators copied through.
+ *
+ * Early-return guard: the input is first stripped of non-alphanumerics. If the
+ * pattern is composed entirely of '0' characters (no separators, e.g. "0000")
+ * AND the stripped value is not a pure digit string, the original value is
+ * returned untouched. That covers two cases:
+ *   - the stripped value contains a letter (e.g. "AB12")
+ *   - the stripped value is empty (raw input was empty or separators-only)
+ * Numeric masks that contain separators (e.g. "0000-00000-0") do NOT trigger
+ * this guard — this is the inherited behavior from the original PowerACC
+ * implementation.
+ */
+function customerCodeFormatter(value, pattern) {
+    const cleanValue = value.replace(ALPHANUMERIC_STRIP, '');
+    const isAllZerosPattern = pattern.replace(/[^0-9]/g, '') === '0'.repeat(pattern.length);
+    const isNumericValue = DIGITS_ONLY.test(cleanValue);
+    if (isAllZerosPattern && !isNumericValue) {
+        return value;
+    }
+    let result = '';
+    let valueIndex = 0;
+    for (let i = 0; i < pattern.length; i++) {
+        const patternChar = pattern.charAt(i);
+        if (patternChar === '0' || patternChar === 'x') {
+            if (valueIndex < cleanValue.length) {
+                result += cleanValue.charAt(valueIndex++);
+            }
+            else {
+                result += patternChar === '0' ? '0' : ' ';
+            }
+        }
+        else {
+            result += patternChar;
+        }
+    }
+    return result;
+}
+/**
+ * True when the pattern, after removing all '0' characters, contains only
+ * digits, whitespace, or the common separators (`. _ -`). In practice this
+ * means the pattern has no 'x' (letter) placeholders. Note: patterns
+ * consisting solely of separators (e.g. "-") or solely of literal digits
+ * (e.g. "123") also return true; the check is "no letter placeholders",
+ * not "has at least one '0' placeholder".
+ */
+function isNumericTemplate(pattern) {
+    return NUMERIC_TEMPLATE_RESIDUE.test(pattern.replace(/0/g, ''));
+}
+/** True when the value consists of digits once common separators (- _ . space) are stripped. */
+function isNumericInput(value) {
+    return DIGITS_ONLY.test(value.replace(COMMON_SEPARATORS, ''));
+}
+//# sourceMappingURL=formatterHelper.js.map

package/dist/formatters/formatterHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatterHelper.js","sourceRoot":"","sources":["../../src/formatters/formatterHelper.ts"],"names":[],"mappings":";;AAsBA,sDAwBC;AAUD,8CAEC;AAGD,wCAEC;AA/DD,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAC1C,MAAM,WAAW,GAAG,OAAO,CAAA;AAC3B,MAAM,wBAAwB,GAAG,eAAe,CAAA;AAChD,MAAM,iBAAiB,GAAG,UAAU,CAAA;AAEpC;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,qBAAqB,CAAC,KAAa,EAAE,OAAe;IAClE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;IACxD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACvF,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAEnD,IAAI,iBAAiB,IAAI,CAAC,cAAc,EAAE,CAAC;QACzC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACrC,IAAI,WAAW,KAAK,GAAG,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;YAC/C,IAAI,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;YAC3C,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,WAAW,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YAC3C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,WAAW,CAAA;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,gGAAgG;AAChG,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAA;AAC/D,CAAC"}

package/dist/formatters/index.d.ts

@@ -1,2 +1,3 @@
 export * from './formatters';
+export * from './formatterHelper';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA"}

package/dist/formatters/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./formatters"), exports);
+__exportStar(require("./formatterHelper"), exports);
 //# sourceMappingURL=index.js.map

package/dist/formatters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,oDAAiC"}

package/dist/helpers/index.d.ts

@@ -2,4 +2,6 @@ export * from './dialogHelper';
 export * from './gridHelper';
 export * from './excelExportHelper';
 export { doExportPdf } from './pdfExportHelper';
+export * from './processQueryButtons';
+export * from './windowHelper';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA"}

package/dist/helpers/index.js

@@ -20,4 +20,6 @@ __exportStar(require("./gridHelper"), exports);
 __exportStar(require("./excelExportHelper"), exports);
 var pdfExportHelper_1 = require("./pdfExportHelper");
 Object.defineProperty(exports, "doExportPdf", { enumerable: true, get: function () { return pdfExportHelper_1.doExportPdf; } });
+__exportStar(require("./processQueryButtons"), exports);
+__exportStar(require("./windowHelper"), exports);
 //# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,+CAA4B;AAC5B,sDAAmC;AACnC,qDAA+C;AAAtC,8GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,+CAA4B;AAC5B,sDAAmC;AACnC,qDAA+C;AAAtC,8GAAA,WAAW,OAAA;AACpB,wDAAqC;AACrC,iDAA8B"}

package/dist/helpers/processQueryButtons.d.ts

@@ -0,0 +1,10 @@
+import type { ToolButton } from '@serenity-is/corelib';
+export type ProcessQueryOptions = {
+    onClick: (isQuery: boolean) => void;
+};
+/**
+ * Factory for a paired "Query" / "Clear" toolbar button group.
+ * `onClick(true)` fires for Query, `onClick(false)` for Clear.
+ */
+export declare function addProcessQueryButtons(opt: ProcessQueryOptions): ToolButton[];
+//# sourceMappingURL=processQueryButtons.d.ts.map

package/dist/helpers/processQueryButtons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processQueryButtons.d.ts","sourceRoot":"","sources":["../../src/helpers/processQueryButtons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,UAAU,EAAE,CAkB7E"}

package/dist/helpers/processQueryButtons.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addProcessQueryButtons = addProcessQueryButtons;
+/**
+ * Factory for a paired "Query" / "Clear" toolbar button group.
+ * `onClick(true)` fires for Query, `onClick(false)` for Clear.
+ */
+function addProcessQueryButtons(opt) {
+    return [
+        {
+            title: 'Query',
+            hint: 'Process query',
+            cssClass: 'process-query-button text-blue',
+            icon: 'bi bi-search',
+            separator: true,
+            onClick: () => opt.onClick(true),
+        },
+        {
+            title: 'Clear',
+            hint: 'Clear query',
+            cssClass: 'clear-query-button text-red',
+            icon: 'bi bi-ban',
+            onClick: () => opt.onClick(false),
+        },
+    ];
+}
+//# sourceMappingURL=processQueryButtons.js.map

package/dist/helpers/processQueryButtons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processQueryButtons.js","sourceRoot":"","sources":["../../src/helpers/processQueryButtons.ts"],"names":[],"mappings":";;AAUA,wDAkBC;AAtBD;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,GAAwB;IAC7D,OAAO;QACL;YACE,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,gCAAgC;YAC1C,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;SACjC;QACD;YACE,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,6BAA6B;YACvC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;SAClC;KACF,CAAA;AACH,CAAC"}

package/dist/helpers/windowHelper.d.ts

@@ -0,0 +1,2 @@
+export declare function isSmallDevice(): boolean;
+//# sourceMappingURL=windowHelper.d.ts.map

package/dist/helpers/windowHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowHelper.d.ts","sourceRoot":"","sources":["../../src/helpers/windowHelper.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/helpers/windowHelper.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSmallDevice = isSmallDevice;
+const SMALL_DEVICE_QUERY = 'only screen and (max-width: 768px)';
+function isSmallDevice() {
+    return window.matchMedia(SMALL_DEVICE_QUERY).matches;
+}
+//# sourceMappingURL=windowHelper.js.map

package/dist/helpers/windowHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowHelper.js","sourceRoot":"","sources":["../../src/helpers/windowHelper.ts"],"names":[],"mappings":";;AAEA,sCAEC;AAJD,MAAM,kBAAkB,GAAG,oCAAoC,CAAA;AAE/D,SAAgB,aAAa;IAC3B,OAAO,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAA;AACtD,CAAC"}

package/dist/types/gridEditableMode.d.ts

@@ -0,0 +1,9 @@
+export type GridEditableMode = {
+    mode: 'Full';
+} | {
+    mode: 'Off';
+} | {
+    mode: 'Some';
+    status: string;
+};
+//# sourceMappingURL=gridEditableMode.d.ts.map

package/dist/types/gridEditableMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridEditableMode.d.ts","sourceRoot":"","sources":["../../src/types/gridEditableMode.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/types/gridEditableMode.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=gridEditableMode.js.map

package/dist/types/gridEditableMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridEditableMode.js","sourceRoot":"","sources":["../../src/types/gridEditableMode.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from './common';
 export * from './export';
+export * from './gridEditableMode';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,oBAAoB,CAAA"}

package/dist/types/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
 __exportStar(require("./export"), exports);
+__exportStar(require("./gridEditableMode"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,2CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,2CAAwB;AACxB,qDAAkC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idevs/corelib",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Extended library components and utilities for Serenity Framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",