@gravionlabs/helix-ag-grid 22.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GravionLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @gravionlabs/helix-ag-grid
+
+AG Grid helpers for Helix applications: locale-aware value formatters, robust
+number parsing for editable cells, and shared cell styles.
+
+## Installation
+
+```bash
+npm install @gravionlabs/helix-ag-grid
+```
+
+Peer dependencies: `@angular/core >=22`, `ag-grid-angular >=33`, `ag-grid-community >=33`.
+
+The package ships a prebuilt stylesheet; add it to your global styles:
+
+```json
+// angular.json
+"styles": ["node_modules/@gravionlabs/helix-ag-grid/styles.css", "src/styles.scss"]
+```
+
+## Formatters
+
+`Intl`-based value formatters for column definitions:
+
+| Export | Formats |
+| --- | --- |
+| `numberFormatter` / `rawNumberFormatter` / `intlNumberFormatter` | Numbers (grouped, raw, or custom `Intl.NumberFormat` options) |
+| `currencyFormatter` | Currency values |
+| `cetDateFormatter` / `cetTimeFormatter` / `cetDateTimeFormatter` | Dates/times in CET |
+
+```ts
+import { currencyFormatter } from '@gravionlabs/helix-ag-grid';
+
+const columnDefs: ColDef[] = [
+  { field: 'price', valueFormatter: currencyFormatter('EUR') },
+];
+```
+
+See `AgGridFormatterParams` for the accepted parameter shape.
+
+## Parsers
+
+Number parsing for cell editing:
+
+- `parseNumber(value, options?)` / `parseNumberValue` — parse localized number strings (`ParseNumberOptions` controls locale/precision behavior).
+- `numberValueParser` — drop-in `valueParser` for numeric columns.
+- `coerceValue` — general value coercion helper.
+
+## Cell Styles
+
+- `numberCellStyle` — right-aligned tabular style for numeric columns.
+
+## Development
+
+```bash
+ng build ag-grid
+ng test ag-grid
+```
+
+## License
+
+MIT

package/fesm2022/gravionlabs-helix-ag-grid.mjs

@@ -0,0 +1,249 @@
+/**
+ * AG Grid `cellStyle` callback that right-aligns numeric cells and colours
+ * truthy (non-zero, non-null, non-undefined) values with the helix success
+ * colour (`--h-green-500`).
+ *
+ * @example
+ * ```ts
+ * columnDefs = [{ field: 'amount', cellStyle: numberCellStyle }];
+ * ```
+ */
+function numberCellStyle(params) {
+    return params.value
+        ? { textAlign: 'right', color: 'var(--h-green-500)' }
+        : { textAlign: 'right' };
+}
+
+// ── Number formatters ──────────────────────────────────────────────────────
+/**
+ * Formats a numeric cell value using the system locale (`toLocaleString`).
+ * Returns `''` for `null`, `undefined`, or `NaN`.
+ *
+ * @example
+ * ```ts
+ * { field: 'amount', valueFormatter: numberFormatter }
+ * ```
+ */
+function numberFormatter(params) {
+    const v = params.value;
+    if (v == null || Number.isNaN(v))
+        return '';
+    return v.toLocaleString();
+}
+/**
+ * Returns the raw string representation of a number without any locale
+ * formatting. Returns `''` for `null` or `undefined`.
+ *
+ * @example
+ * ```ts
+ * { field: 'id', valueFormatter: rawNumberFormatter }
+ * ```
+ */
+function rawNumberFormatter(params) {
+    const v = params.value;
+    if (v == null)
+        return '';
+    return v.toString();
+}
+/**
+ * Formats a number using a caller-supplied `Intl.NumberFormat` instance,
+ * allowing full control over locale, currency, fraction digits, etc.
+ * Returns `''` for `null` or `undefined`.
+ *
+ * @example
+ * ```ts
+ * const fmt = new Intl.NumberFormat('de-DE', { minimumFractionDigits: 2 });
+ * { field: 'price', valueFormatter: (p) => intlNumberFormatter(p, fmt) }
+ * ```
+ */
+function intlNumberFormatter(params, numberFormat) {
+    const v = params.value;
+    if (v == null || Number.isNaN(v))
+        return '';
+    return numberFormat.format(v);
+}
+/**
+ * Factory that returns a currency formatter closure using `Intl.NumberFormat`
+ * with `style: 'currency'`. Defaults to EUR / de-DE.
+ * Returns `''` for `null`, `undefined`, or `NaN`.
+ *
+ * @example
+ * ```ts
+ * { field: 'revenue', valueFormatter: currencyFormatter() }           // '1.234,50 €'
+ * { field: 'price',   valueFormatter: currencyFormatter('USD','en-US') } // '$99.90'
+ * ```
+ */
+function currencyFormatter(currencyCode = 'EUR', locale = 'de-DE') {
+    const fmt = new Intl.NumberFormat(locale, { style: 'currency', currency: currencyCode });
+    return (params) => {
+        const v = params.value;
+        if (v == null || Number.isNaN(v))
+            return '';
+        return fmt.format(v);
+    };
+}
+function toDate(value) {
+    if (value == null)
+        return null;
+    const d = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+const cetDateFormat = new Intl.DateTimeFormat('de-DE', {
+    timeZone: 'Europe/Berlin',
+    day: '2-digit',
+    month: '2-digit',
+    year: 'numeric',
+});
+const cetDateTimeFormat = new Intl.DateTimeFormat('de-DE', {
+    timeZone: 'Europe/Berlin',
+    day: '2-digit',
+    month: '2-digit',
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+});
+const cetTimeFormat = new Intl.DateTimeFormat('de-DE', {
+    timeZone: 'Europe/Berlin',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+});
+/**
+ * Formats a `Date` or ISO string as a CET date: `'15.06.2024'`.
+ * Returns `''` for `null`, `undefined`, or invalid dates.
+ *
+ * @example
+ * ```ts
+ * { field: 'date', valueFormatter: cetDateFormatter }
+ * ```
+ */
+function cetDateFormatter(params) {
+    const d = toDate(params.value);
+    return d ? cetDateFormat.format(d) : '';
+}
+/**
+ * Formats a `Date` or ISO string as a CET date-time: `'15.06.2024 12:30:00'`.
+ * Returns `''` for `null`, `undefined`, or invalid dates.
+ *
+ * @example
+ * ```ts
+ * { field: 'updatedAt', valueFormatter: cetDateTimeFormatter }
+ * ```
+ */
+function cetDateTimeFormatter(params) {
+    const d = toDate(params.value);
+    if (!d)
+        return '';
+    // Intl formats date and time parts separated by ', ' in de-DE — replace with ' '
+    return cetDateTimeFormat.format(d).replace(', ', ' ');
+}
+/**
+ * Formats a `Date` or ISO string as a CET time: `'12:30'`.
+ * Returns `''` for `null`, `undefined`, or invalid dates.
+ *
+ * @example
+ * ```ts
+ * { field: 'startTime', valueFormatter: cetTimeFormatter }
+ * ```
+ */
+function cetTimeFormatter(params) {
+    const d = toDate(params.value);
+    return d ? cetTimeFormat.format(d) : '';
+}
+
+/**
+ * Validates a number against optional `min`/`max` bounds.
+ * Returns `null` if the value is `null`, `undefined`, `NaN`, or out of bounds.
+ *
+ * @example
+ * ```ts
+ * coerceValue(5, { min: 0, max: 10 })  // → 5
+ * coerceValue(15, { max: 10 })         // → null
+ * coerceValue(null)                    // → null
+ * ```
+ */
+function coerceValue(value, options) {
+    if (value == null || Number.isNaN(value))
+        return null;
+    if (options?.min != null && value < options.min)
+        return null;
+    if (options?.max != null && value > options.max)
+        return null;
+    return value;
+}
+/**
+ * Locale-aware string-to-number parser.
+ * Handles thousand separators and decimal commas for the given locale.
+ * Returns `null` for empty, `null`, or `undefined` input.
+ *
+ * @example
+ * ```ts
+ * parseNumber('1.234,56', 'de-DE') // → 1234.56
+ * parseNumber('1,234.56', 'en-US') // → 1234.56
+ * ```
+ */
+function parseNumber(value, locale, options) {
+    if (value == null || value.trim() === '')
+        return null;
+    // Derive separators from the locale
+    const parts = new Intl.NumberFormat(locale).formatToParts(1234.5);
+    const group = parts.find((p) => p.type === 'group')?.value ?? '';
+    const decimal = parts.find((p) => p.type === 'decimal')?.value ?? '.';
+    const normalised = value.trim().replaceAll(group, '').replace(decimal, '.');
+    const n = Number.parseFloat(normalised);
+    return coerceValue(n, options);
+}
+/**
+ * Smart string-to-number parser that detects the decimal separator
+ * automatically:
+ * - Strings containing a comma (e.g. `'1.234,56'` from spreadsheet paste)
+ *   are parsed as German locale (`de-DE`).
+ * - All other strings (e.g. `'3.14'` from keyboard input) are parsed with
+ *   `parseFloat`.
+ *
+ * Returns `null` for empty, `null`, or `undefined` input.
+ *
+ * @example
+ * ```ts
+ * parseNumberValue('42')        // → 42
+ * parseNumberValue('3.14')      // → 3.14
+ * parseNumberValue('1.234,56')  // → 1234.56  (German paste)
+ * parseNumberValue(null)        // → null
+ * parseNumberValue('5', { min: 10 }) // → null (out of bounds)
+ * ```
+ */
+function parseNumberValue(value, options) {
+    if (value == null || value.trim() === '')
+        return null;
+    const hasComma = value.includes(',');
+    if (hasComma) {
+        return parseNumber(value, 'de-DE', options);
+    }
+    const n = Number.parseFloat(value.trim());
+    return coerceValue(n, options);
+}
+/**
+ * AG Grid `valueParser` adapter — wraps `parseNumberValue` to read
+ * `params.newValue`. Drop-in for any editable numeric column.
+ *
+ * @example
+ * ```ts
+ * { field: 'quantity', editable: true, valueParser: numberValueParser }
+ * // or with bounds:
+ * { field: 'pct', editable: true, valueParser: (p) => numberValueParser(p, { min: 0, max: 100 }) }
+ * ```
+ */
+function numberValueParser(params, options) {
+    return parseNumberValue(params.newValue, options);
+}
+
+const HELIX_AG_GRID_VERSION = '0.1.0';
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { HELIX_AG_GRID_VERSION, cetDateFormatter, cetDateTimeFormatter, cetTimeFormatter, coerceValue, currencyFormatter, intlNumberFormatter, numberCellStyle, numberFormatter, numberValueParser, parseNumber, parseNumberValue, rawNumberFormatter };
+//# sourceMappingURL=gravionlabs-helix-ag-grid.mjs.map

package/fesm2022/gravionlabs-helix-ag-grid.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gravionlabs-helix-ag-grid.mjs","sources":["../../../projects/ag-grid/src/lib/cell-styles/cell-styles.ts","../../../projects/ag-grid/src/lib/formatters/ag-grid-formatters.ts","../../../projects/ag-grid/src/lib/parsers/number-parsers.ts","../../../projects/ag-grid/src/public-api.ts","../../../projects/ag-grid/src/gravionlabs-helix-ag-grid.ts"],"sourcesContent":["import type { CellClassParams, CellStyle } from 'ag-grid-community';\n\n/**\n * AG Grid `cellStyle` callback that right-aligns numeric cells and colours\n * truthy (non-zero, non-null, non-undefined) values with the helix success\n * colour (`--h-green-500`).\n *\n * @example\n * ```ts\n * columnDefs = [{ field: 'amount', cellStyle: numberCellStyle }];\n * ```\n */\nexport function numberCellStyle(params: CellClassParams): CellStyle {\n  return params.value\n    ? { textAlign: 'right', color: 'var(--h-green-500)' }\n    : { textAlign: 'right' };\n}\n","import type { ValueFormatterParams } from 'ag-grid-community';\n\n/** Type alias for AG Grid's `ValueFormatterParams`, used by all formatter functions. */\nexport type AgGridFormatterParams<TData = unknown, TValue = unknown> = ValueFormatterParams<\n  TData,\n  TValue\n>;\n\n// ── Number formatters ──────────────────────────────────────────────────────\n\n/**\n * Formats a numeric cell value using the system locale (`toLocaleString`).\n * Returns `''` for `null`, `undefined`, or `NaN`.\n *\n * @example\n * ```ts\n * { field: 'amount', valueFormatter: numberFormatter }\n * ```\n */\nexport function numberFormatter(\n  params: AgGridFormatterParams<unknown, number | null | undefined>,\n): string {\n  const v = params.value;\n  if (v == null || Number.isNaN(v)) return '';\n  return v.toLocaleString();\n}\n\n/**\n * Returns the raw string representation of a number without any locale\n * formatting. Returns `''` for `null` or `undefined`.\n *\n * @example\n * ```ts\n * { field: 'id', valueFormatter: rawNumberFormatter }\n * ```\n */\nexport function rawNumberFormatter(\n  params: AgGridFormatterParams<unknown, number | null | undefined>,\n): string {\n  const v = params.value;\n  if (v == null) return '';\n  return v.toString();\n}\n\n/**\n * Formats a number using a caller-supplied `Intl.NumberFormat` instance,\n * allowing full control over locale, currency, fraction digits, etc.\n * Returns `''` for `null` or `undefined`.\n *\n * @example\n * ```ts\n * const fmt = new Intl.NumberFormat('de-DE', { minimumFractionDigits: 2 });\n * { field: 'price', valueFormatter: (p) => intlNumberFormatter(p, fmt) }\n * ```\n */\nexport function intlNumberFormatter(\n  params: AgGridFormatterParams<unknown, number | null | undefined>,\n  numberFormat: Intl.NumberFormat,\n): string {\n  const v = params.value;\n  if (v == null || Number.isNaN(v)) return '';\n  return numberFormat.format(v);\n}\n\n/**\n * Factory that returns a currency formatter closure using `Intl.NumberFormat`\n * with `style: 'currency'`. Defaults to EUR / de-DE.\n * Returns `''` for `null`, `undefined`, or `NaN`.\n *\n * @example\n * ```ts\n * { field: 'revenue', valueFormatter: currencyFormatter() }           // '1.234,50 €'\n * { field: 'price',   valueFormatter: currencyFormatter('USD','en-US') } // '$99.90'\n * ```\n */\nexport function currencyFormatter(\n  currencyCode = 'EUR',\n  locale = 'de-DE',\n): (params: AgGridFormatterParams<unknown, number | null | undefined>) => string {\n  const fmt = new Intl.NumberFormat(locale, { style: 'currency', currency: currencyCode });\n  return (params) => {\n    const v = params.value;\n    if (v == null || Number.isNaN(v)) return '';\n    return fmt.format(v);\n  };\n}\n\n// ── CET date formatters ────────────────────────────────────────────────────\n\ntype DateInput = Date | string | null | undefined;\n\nfunction toDate(value: DateInput): Date | null {\n  if (value == null) return null;\n  const d = value instanceof Date ? value : new Date(value);\n  return Number.isNaN(d.getTime()) ? null : d;\n}\n\nconst cetDateFormat = new Intl.DateTimeFormat('de-DE', {\n  timeZone: 'Europe/Berlin',\n  day: '2-digit',\n  month: '2-digit',\n  year: 'numeric',\n});\n\nconst cetDateTimeFormat = new Intl.DateTimeFormat('de-DE', {\n  timeZone: 'Europe/Berlin',\n  day: '2-digit',\n  month: '2-digit',\n  year: 'numeric',\n  hour: '2-digit',\n  minute: '2-digit',\n  second: '2-digit',\n  hour12: false,\n});\n\nconst cetTimeFormat = new Intl.DateTimeFormat('de-DE', {\n  timeZone: 'Europe/Berlin',\n  hour: '2-digit',\n  minute: '2-digit',\n  hour12: false,\n});\n\n/**\n * Formats a `Date` or ISO string as a CET date: `'15.06.2024'`.\n * Returns `''` for `null`, `undefined`, or invalid dates.\n *\n * @example\n * ```ts\n * { field: 'date', valueFormatter: cetDateFormatter }\n * ```\n */\nexport function cetDateFormatter(params: AgGridFormatterParams<unknown, DateInput>): string {\n  const d = toDate(params.value);\n  return d ? cetDateFormat.format(d) : '';\n}\n\n/**\n * Formats a `Date` or ISO string as a CET date-time: `'15.06.2024 12:30:00'`.\n * Returns `''` for `null`, `undefined`, or invalid dates.\n *\n * @example\n * ```ts\n * { field: 'updatedAt', valueFormatter: cetDateTimeFormatter }\n * ```\n */\nexport function cetDateTimeFormatter(params: AgGridFormatterParams<unknown, DateInput>): string {\n  const d = toDate(params.value);\n  if (!d) return '';\n  // Intl formats date and time parts separated by ', ' in de-DE — replace with ' '\n  return cetDateTimeFormat.format(d).replace(', ', ' ');\n}\n\n/**\n * Formats a `Date` or ISO string as a CET time: `'12:30'`.\n * Returns `''` for `null`, `undefined`, or invalid dates.\n *\n * @example\n * ```ts\n * { field: 'startTime', valueFormatter: cetTimeFormatter }\n * ```\n */\nexport function cetTimeFormatter(params: AgGridFormatterParams<unknown, DateInput>): string {\n  const d = toDate(params.value);\n  return d ? cetTimeFormat.format(d) : '';\n}\n","import type { ValueParserParams } from 'ag-grid-community';\n\n/** Bounds for number validation. */\nexport interface ParseNumberOptions {\n  min?: number;\n  max?: number;\n}\n\n/**\n * Validates a number against optional `min`/`max` bounds.\n * Returns `null` if the value is `null`, `undefined`, `NaN`, or out of bounds.\n *\n * @example\n * ```ts\n * coerceValue(5, { min: 0, max: 10 })  // → 5\n * coerceValue(15, { max: 10 })         // → null\n * coerceValue(null)                    // → null\n * ```\n */\nexport function coerceValue(\n  value: number | null | undefined,\n  options?: ParseNumberOptions,\n): number | null {\n  if (value == null || Number.isNaN(value)) return null;\n  if (options?.min != null && value < options.min) return null;\n  if (options?.max != null && value > options.max) return null;\n  return value;\n}\n\n/**\n * Locale-aware string-to-number parser.\n * Handles thousand separators and decimal commas for the given locale.\n * Returns `null` for empty, `null`, or `undefined` input.\n *\n * @example\n * ```ts\n * parseNumber('1.234,56', 'de-DE') // → 1234.56\n * parseNumber('1,234.56', 'en-US') // → 1234.56\n * ```\n */\nexport function parseNumber(\n  value: string | null | undefined,\n  locale: string,\n  options?: ParseNumberOptions,\n): number | null {\n  if (value == null || value.trim() === '') return null;\n\n  // Derive separators from the locale\n  const parts = new Intl.NumberFormat(locale).formatToParts(1234.5);\n  const group = parts.find((p) => p.type === 'group')?.value ?? '';\n  const decimal = parts.find((p) => p.type === 'decimal')?.value ?? '.';\n\n  const normalised = value.trim().replaceAll(group, '').replace(decimal, '.');\n\n  const n = Number.parseFloat(normalised);\n  return coerceValue(n, options);\n}\n\n/**\n * Smart string-to-number parser that detects the decimal separator\n * automatically:\n * - Strings containing a comma (e.g. `'1.234,56'` from spreadsheet paste)\n *   are parsed as German locale (`de-DE`).\n * - All other strings (e.g. `'3.14'` from keyboard input) are parsed with\n *   `parseFloat`.\n *\n * Returns `null` for empty, `null`, or `undefined` input.\n *\n * @example\n * ```ts\n * parseNumberValue('42')        // → 42\n * parseNumberValue('3.14')      // → 3.14\n * parseNumberValue('1.234,56')  // → 1234.56  (German paste)\n * parseNumberValue(null)        // → null\n * parseNumberValue('5', { min: 10 }) // → null (out of bounds)\n * ```\n */\nexport function parseNumberValue(\n  value: string | null | undefined,\n  options?: ParseNumberOptions,\n): number | null {\n  if (value == null || value.trim() === '') return null;\n\n  const hasComma = value.includes(',');\n  if (hasComma) {\n    return parseNumber(value, 'de-DE', options);\n  }\n\n  const n = Number.parseFloat(value.trim());\n  return coerceValue(n, options);\n}\n\n/**\n * AG Grid `valueParser` adapter — wraps `parseNumberValue` to read\n * `params.newValue`. Drop-in for any editable numeric column.\n *\n * @example\n * ```ts\n * { field: 'quantity', editable: true, valueParser: numberValueParser }\n * // or with bounds:\n * { field: 'pct', editable: true, valueParser: (p) => numberValueParser(p, { min: 0, max: 100 }) }\n * ```\n */\nexport function numberValueParser(\n  params: ValueParserParams,\n  options?: ParseNumberOptions,\n): number | null {\n  return parseNumberValue(params.newValue as string | null | undefined, options);\n}\n","export const HELIX_AG_GRID_VERSION = '0.1.0';\n\nexport { numberCellStyle } from './lib/cell-styles/cell-styles';\n\nexport type { AgGridFormatterParams } from './lib/formatters/ag-grid-formatters';\nexport {\n  cetDateFormatter,\n  cetDateTimeFormatter,\n  cetTimeFormatter,\n  currencyFormatter,\n  intlNumberFormatter,\n  numberFormatter,\n  rawNumberFormatter,\n} from './lib/formatters/ag-grid-formatters';\n\nexport type { ParseNumberOptions } from './lib/parsers/number-parsers';\nexport {\n  coerceValue,\n  numberValueParser,\n  parseNumber,\n  parseNumberValue,\n} from './lib/parsers/number-parsers';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@gravionlabs/helix-ag-grid",
+  "version": "22.0.0",
+  "description": "Helix AG Grid helpers for Angular — value formatters, number parsers, and cell styles.",
+  "license": "MIT",
+  "keywords": [
+    "helix",
+    "angular",
+    "ag-grid"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GravionLabs/helix.git",
+    "directory": "projects/ag-grid"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=22",
+    "ag-grid-angular": ">=33",
+    "ag-grid-community": ">=33"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "module": "fesm2022/gravionlabs-helix-ag-grid.mjs",
+  "typings": "types/gravionlabs-helix-ag-grid.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/gravionlabs-helix-ag-grid.d.ts",
+      "default": "./fesm2022/gravionlabs-helix-ag-grid.mjs"
+    },
+    "./styles.css": "./styles.css"
+  },
+  "type": "module"
+}

package/styles.css

@@ -0,0 +1,81 @@
+/*
+ * AG Grid Theme — Helix
+ *
+ * Apply the `.helix-ag-grid` class to the ag-grid host element to get a
+ * look and feel consistent with the Helix / PrimeNG design system.
+ *
+ * Token reference:
+ *   --helix-*   design tokens defined in @gravionlabs/helix styles.css
+ *   --p-*       PrimeNG Aura tokens injected at runtime by ThemeService
+ *
+ * Approach: https://www.ag-grid.com/javascript-data-grid/theming-css/#overriding-theme-parameters-with-custom-properties
+ */
+
+.helix-ag-grid {
+  /* ── Colours ──────────────────────────────────────────────────────────── */
+  --ag-background-color: var(--helix-surface-card);
+  --ag-foreground-color: var(--h-text-color);
+  --ag-text-color: var(--ag-foreground-color);
+  --ag-accent-color: var(--h-primary-color);
+  --ag-invalid-color: var(--h-form-field-invalid-border-color);
+  --ag-border-color: var(--helix-border);
+  --ag-wrapper-border: none;
+  --ag-row-border: solid 1px var(--helix-border);
+  --ag-odd-row-background-color: color-mix(
+    in srgb,
+    transparent,
+    var(--helix-border) 10%
+  );
+  --ag-row-hover-color: var(--helix-surface-hover);
+
+  /* ── Typography ───────────────────────────────────────────────────────── */
+  --ag-font-family: "Lato", sans-serif;
+  --ag-font-size: 0.75rem;
+
+  /* ── Header ───────────────────────────────────────────────────────────── */
+  --ag-header-background-color: var(--helix-surface-card);
+  --ag-header-font-family: "Lato", sans-serif;
+  --ag-header-font-weight: 500;
+  --ag-header-font-size: 0.75rem;
+  --ag-header-text-color: var(--h-primary-color);
+
+  /* ── Cells ────────────────────────────────────────────────────────────── */
+  --ag-cell-text-color: var(--h-text-color);
+  --ag-cell-horizontal-padding: 1ch;
+
+  /* ── Input ────────────────────────────────────────────────────────────── */
+  --ag-input-background-color: var(--ag-background-color);
+  --ag-input-border: solid 1px var(--ag-border-color);
+
+  /* ── Drag & drop ──────────────────────────────────────────────────────── */
+  --ag-column-drop-cell-background-color: color-mix(
+    in srgb,
+    transparent,
+    var(--ag-foreground-color) 7%
+  );
+  --ag-column-drop-cell-border: solid 1px
+    color-mix(in srgb, transparent, var(--ag-foreground-color) 13%);
+
+  /* ── Inner element overrides ──────────────────────────────────────────── */
+  .ag-root-wrapper,
+  .ag-measurement-container,
+  .ag-apply-theme-variables {
+    --ag-row-height: 2rem;
+  }
+
+  .ag-cell {
+    line-height: 1.85rem;
+    -webkit-font-smoothing: antialiased;
+  }
+
+  .ag-dnd-ghost {
+    font-family: "Lato", sans-serif;
+    font-size: 0.75rem;
+    font-weight: 500;
+    color: var(--h-primary-color);
+  }
+
+  .ag-paging-panel {
+    block-size: 3em;
+  }
+}

package/types/gravionlabs-helix-ag-grid.d.ts

@@ -0,0 +1,158 @@
+import { CellClassParams, CellStyle, ValueFormatterParams, ValueParserParams } from 'ag-grid-community';
+
+/**
+ * AG Grid `cellStyle` callback that right-aligns numeric cells and colours
+ * truthy (non-zero, non-null, non-undefined) values with the helix success
+ * colour (`--h-green-500`).
+ *
+ * @example
+ * ```ts
+ * columnDefs = [{ field: 'amount', cellStyle: numberCellStyle }];
+ * ```
+ */
+declare function numberCellStyle(params: CellClassParams): CellStyle;
+
+/** Type alias for AG Grid's `ValueFormatterParams`, used by all formatter functions. */
+type AgGridFormatterParams<TData = unknown, TValue = unknown> = ValueFormatterParams<TData, TValue>;
+/**
+ * Formats a numeric cell value using the system locale (`toLocaleString`).
+ * Returns `''` for `null`, `undefined`, or `NaN`.
+ *
+ * @example
+ * ```ts
+ * { field: 'amount', valueFormatter: numberFormatter }
+ * ```
+ */
+declare function numberFormatter(params: AgGridFormatterParams<unknown, number | null | undefined>): string;
+/**
+ * Returns the raw string representation of a number without any locale
+ * formatting. Returns `''` for `null` or `undefined`.
+ *
+ * @example
+ * ```ts
+ * { field: 'id', valueFormatter: rawNumberFormatter }
+ * ```
+ */
+declare function rawNumberFormatter(params: AgGridFormatterParams<unknown, number | null | undefined>): string;
+/**
+ * Formats a number using a caller-supplied `Intl.NumberFormat` instance,
+ * allowing full control over locale, currency, fraction digits, etc.
+ * Returns `''` for `null` or `undefined`.
+ *
+ * @example
+ * ```ts
+ * const fmt = new Intl.NumberFormat('de-DE', { minimumFractionDigits: 2 });
+ * { field: 'price', valueFormatter: (p) => intlNumberFormatter(p, fmt) }
+ * ```
+ */
+declare function intlNumberFormatter(params: AgGridFormatterParams<unknown, number | null | undefined>, numberFormat: Intl.NumberFormat): string;
+/**
+ * Factory that returns a currency formatter closure using `Intl.NumberFormat`
+ * with `style: 'currency'`. Defaults to EUR / de-DE.
+ * Returns `''` for `null`, `undefined`, or `NaN`.
+ *
+ * @example
+ * ```ts
+ * { field: 'revenue', valueFormatter: currencyFormatter() }           // '1.234,50 €'
+ * { field: 'price',   valueFormatter: currencyFormatter('USD','en-US') } // '$99.90'
+ * ```
+ */
+declare function currencyFormatter(currencyCode?: string, locale?: string): (params: AgGridFormatterParams<unknown, number | null | undefined>) => string;
+type DateInput = Date | string | null | undefined;
+/**
+ * Formats a `Date` or ISO string as a CET date: `'15.06.2024'`.
+ * Returns `''` for `null`, `undefined`, or invalid dates.
+ *
+ * @example
+ * ```ts
+ * { field: 'date', valueFormatter: cetDateFormatter }
+ * ```
+ */
+declare function cetDateFormatter(params: AgGridFormatterParams<unknown, DateInput>): string;
+/**
+ * Formats a `Date` or ISO string as a CET date-time: `'15.06.2024 12:30:00'`.
+ * Returns `''` for `null`, `undefined`, or invalid dates.
+ *
+ * @example
+ * ```ts
+ * { field: 'updatedAt', valueFormatter: cetDateTimeFormatter }
+ * ```
+ */
+declare function cetDateTimeFormatter(params: AgGridFormatterParams<unknown, DateInput>): string;
+/**
+ * Formats a `Date` or ISO string as a CET time: `'12:30'`.
+ * Returns `''` for `null`, `undefined`, or invalid dates.
+ *
+ * @example
+ * ```ts
+ * { field: 'startTime', valueFormatter: cetTimeFormatter }
+ * ```
+ */
+declare function cetTimeFormatter(params: AgGridFormatterParams<unknown, DateInput>): string;
+
+/** Bounds for number validation. */
+interface ParseNumberOptions {
+    min?: number;
+    max?: number;
+}
+/**
+ * Validates a number against optional `min`/`max` bounds.
+ * Returns `null` if the value is `null`, `undefined`, `NaN`, or out of bounds.
+ *
+ * @example
+ * ```ts
+ * coerceValue(5, { min: 0, max: 10 })  // → 5
+ * coerceValue(15, { max: 10 })         // → null
+ * coerceValue(null)                    // → null
+ * ```
+ */
+declare function coerceValue(value: number | null | undefined, options?: ParseNumberOptions): number | null;
+/**
+ * Locale-aware string-to-number parser.
+ * Handles thousand separators and decimal commas for the given locale.
+ * Returns `null` for empty, `null`, or `undefined` input.
+ *
+ * @example
+ * ```ts
+ * parseNumber('1.234,56', 'de-DE') // → 1234.56
+ * parseNumber('1,234.56', 'en-US') // → 1234.56
+ * ```
+ */
+declare function parseNumber(value: string | null | undefined, locale: string, options?: ParseNumberOptions): number | null;
+/**
+ * Smart string-to-number parser that detects the decimal separator
+ * automatically:
+ * - Strings containing a comma (e.g. `'1.234,56'` from spreadsheet paste)
+ *   are parsed as German locale (`de-DE`).
+ * - All other strings (e.g. `'3.14'` from keyboard input) are parsed with
+ *   `parseFloat`.
+ *
+ * Returns `null` for empty, `null`, or `undefined` input.
+ *
+ * @example
+ * ```ts
+ * parseNumberValue('42')        // → 42
+ * parseNumberValue('3.14')      // → 3.14
+ * parseNumberValue('1.234,56')  // → 1234.56  (German paste)
+ * parseNumberValue(null)        // → null
+ * parseNumberValue('5', { min: 10 }) // → null (out of bounds)
+ * ```
+ */
+declare function parseNumberValue(value: string | null | undefined, options?: ParseNumberOptions): number | null;
+/**
+ * AG Grid `valueParser` adapter — wraps `parseNumberValue` to read
+ * `params.newValue`. Drop-in for any editable numeric column.
+ *
+ * @example
+ * ```ts
+ * { field: 'quantity', editable: true, valueParser: numberValueParser }
+ * // or with bounds:
+ * { field: 'pct', editable: true, valueParser: (p) => numberValueParser(p, { min: 0, max: 100 }) }
+ * ```
+ */
+declare function numberValueParser(params: ValueParserParams, options?: ParseNumberOptions): number | null;
+
+declare const HELIX_AG_GRID_VERSION = "0.1.0";
+
+export { HELIX_AG_GRID_VERSION, cetDateFormatter, cetDateTimeFormatter, cetTimeFormatter, coerceValue, currencyFormatter, intlNumberFormatter, numberCellStyle, numberFormatter, numberValueParser, parseNumber, parseNumberValue, rawNumberFormatter };
+export type { AgGridFormatterParams, ParseNumberOptions };