@svgrid/grid 2.6.21 → 2.7.0

package/src/filtering/normalize-fast-path.test.ts

@@ -0,0 +1,104 @@
+/**
+ * Equivalence tests for `normalizeForFilter`'s ASCII fast path.
+ *
+ * The function NFD-decomposes, strips combining marks, then lowercases. It runs
+ * once per cell per filter - 100,000 times for a one-column filter on a 100k
+ * grid - and a CPU profile of a browser filter put 15.5% of the whole operation
+ * inside it, more than any other single function.
+ *
+ * For a pure-ASCII string the first two steps are provably no-ops: ASCII is
+ * already in NFD, and the combining-marks block (U+0300..U+036F) contains no
+ * ASCII. So the fast path returns `lowercase(s)` directly.
+ *
+ * "Provably" is doing a lot of work in that sentence, so the first test checks
+ * it exhaustively over every ASCII code point rather than trusting the argument.
+ */
+import { describe, expect, it } from 'vitest'
+import { normalizeForFilter } from './excel-filters'
+
+/** The original implementation, verbatim, as the oracle. */
+const DIACRITIC_RE = /[̀-ͯ]/g
+function reference(s: string, locale?: string | ReadonlyArray<string>): string {
+  if (!s) return ''
+  const stripped = s.normalize('NFD').replace(DIACRITIC_RE, '')
+  return locale
+    ? stripped.toLocaleLowerCase(locale as string | string[])
+    : stripped.toLowerCase()
+}
+
+describe('normalizeForFilter - ASCII fast path equivalence', () => {
+  it('matches on every single ASCII code point', () => {
+    for (let code = 0; code < 128; code++) {
+      const ch = String.fromCharCode(code)
+      expect(normalizeForFilter(ch), `code point ${code}`).toBe(reference(ch))
+    }
+  })
+
+  it('matches on every ASCII code point under a Turkish locale', () => {
+    // Turkish is the locale that makes ASCII lowercasing locale-dependent:
+    // 'I'.toLocaleLowerCase('tr') is 'ı', not 'i'. The fast path must still
+    // route through toLocaleLowerCase rather than assuming ASCII is safe.
+    for (let code = 0; code < 128; code++) {
+      const ch = String.fromCharCode(code)
+      expect(normalizeForFilter(ch, 'tr'), `code point ${code}`).toBe(reference(ch, 'tr'))
+    }
+  })
+
+  const CASES: Array<[string, string]> = [
+    ['empty', ''],
+    ['plain ascii', 'Hello World'],
+    ['ascii with digits and punctuation', 'ABC-123_x.y,z!'],
+    ['precomposed accents', 'café CAFÉ Café'],
+    ['decomposed accents', 'café'],
+    ['mixed ascii and accents', 'naive naïve NAÏVE'],
+    ['german sharp s', 'straße STRASSE'],
+    ['greek', 'ΣΊΣΥΦΟΣ σίσυφος'],
+    ['cyrillic', 'Привет МИР'],
+    ['cjk', '日本語テキスト'],
+    ['emoji', 'grid 🚀 test'],
+    ['combining marks alone', '̀́̂'],
+    ['ascii then combining mark', 'áb'],
+    ['turkish dotted capital', 'İstanbul ISTANBUL'],
+    ['ligature', 'file flow'],
+    ['fullwidth', 'ＡＢＣ'],
+    ['nbsp and control chars', 'a b\tc\nd'],
+    ['long ascii', 'x'.repeat(500)],
+    ['long with one non-ascii at the end', 'x'.repeat(500) + 'é'],
+  ]
+
+  for (const [name, input] of CASES) {
+    it(`matches: ${name}`, () => {
+      expect(normalizeForFilter(input)).toBe(reference(input))
+    })
+    it(`matches with locale: ${name}`, () => {
+      expect(normalizeForFilter(input, 'tr')).toBe(reference(input, 'tr'))
+      expect(normalizeForFilter(input, 'de')).toBe(reference(input, 'de'))
+    })
+  }
+
+  it('matches across randomised mixed-script strings', () => {
+    let seed = 7
+    const rand = () => {
+      seed = (seed * 1103515245 + 12345) & 0x7fffffff
+      return seed / 0x7fffffff
+    }
+    const pools = [
+      'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 -_.',
+      'áéíóúàèìòùâêîôûäëïöüñçÁÉÍÓÚÑÇ',
+      '̀́̂̃̈',
+      'ΑΒΓΔαβγδ',
+      'абвгдАБВГД',
+      '日本語中文한국어',
+    ]
+    for (let trial = 0; trial < 300; trial++) {
+      let s = ''
+      const len = 1 + Math.floor(rand() * 20)
+      for (let i = 0; i < len; i++) {
+        const pool = pools[Math.floor(rand() * pools.length)]!
+        s += pool[Math.floor(rand() * pool.length)]
+      }
+      expect(normalizeForFilter(s), s).toBe(reference(s))
+      expect(normalizeForFilter(s, 'tr'), s).toBe(reference(s, 'tr'))
+    }
+  })
+})

package/src/flex-render.ts

@@ -1,3 +1,3 @@
-/// <reference types="svelte" />
-
-export { default as FlexRender } from './FlexRender.svelte'
+/// <reference types="svelte" />
+
+export { default as FlexRender } from './FlexRender.svelte'

package/src/form-field.ts

@@ -1,127 +1,127 @@
-import type { Validator } from './validators'
-
-/**
- * Field descriptor for <SvForm> and the headless `createForm` core. Kept in a
- * plain `.ts` module so the core can import the type without pulling in the
- * `.svelte` component (which would create a `.svelte.ts` -> `.svelte` import
- * cycle Vite's dev import-analysis fails to resolve).
- */
-export type FormFieldType =
-  | 'text' | 'email' | 'tel' | 'textarea' | 'number' | 'password'
-  | 'select' | 'multiselect' | 'checkbox' | 'switch' | 'date' | 'color' | 'rating'
-  | 'radio' | 'slider' | 'tags' | 'phone' | 'country' | 'mask'
-  | 'datetime' | 'time' | 'daterange' | 'combobox' | 'file'
-  | 'array'
-
-export type FormField = {
-  name: string
-  label: string
-  type?: FormFieldType
-  required?: boolean
-  /** Show the field but block edits (still submitted, unlike hidden fields). */
-  readonly?: boolean
-  /** Helper text shown under the control (distinct from a validation error). */
-  help?: string
-  placeholder?: string
-  /**
-   * Options for select/combobox/radio/multiselect. A function makes them CASCADE:
-   * the list is derived from the current form values (e.g. cities for the picked
-   * country). Pair with `dependsOn` so the child clears when the parent changes.
-   */
-  options?:
-    | Array<{ value: string | number; label: string; color?: string }>
-    | ((values: Record<string, any>) => Array<{ value: string | number; label: string; color?: string }>)
-  /** Field name(s) this one depends on; when a parent changes, this field's value
-   *  is cleared (cascading selects). */
-  dependsOn?: string | string[]
-  /** Mask pattern for `type: 'mask'` (`#`=digit, `A`=letter, `*`=alnum). */
-  mask?: string
-  /** Numeric bounds for `type: 'number'` / `'slider'`. */
-  min?: number
-  max?: number
-  step?: number
-  precision?: number
-  /** Text affixes for `type: 'number'` (e.g. `$` / `%`). */
-  prefix?: string
-  suffix?: string
-  /** Remote option loader for `type: 'combobox'` (debounced typeahead). The
-   *  current form `values` are passed so it can depend on other fields. */
-  loadOptions?: (query: string, values: Record<string, any>) => Promise<Array<{ value: string | number; label: string }>>
-  /** File input hints for `type: 'file'`. */
-  accept?: string
-  multiple?: boolean
-  /**
-   * Derive this field's value from the other form values (e.g. a total). A
-   * computed field is read-only, recomputes reactively, is not user-validated,
-   * and its derived value is included in the submitted payload.
-   */
-  computed?: (values: Record<string, any>) => any
-  /** Declarative validation rules (see `rules` - email/pattern/min/compare...). */
-  rules?: ReadonlyArray<Validator>
-  /** Return an error message, or null/undefined when valid. */
-  validate?: (value: any, values: Record<string, any>) => string | null | undefined
-  /**
-   * Async validator (e.g. "is this username taken?"). Runs after the sync checks
-   * pass, debounced (`asyncDebounce`, default 300ms) and stale-guarded so only the
-   * latest result wins. While it runs, `form.isValidating(name)` is true and the
-   * field shows a checking indicator. Submit waits for all async validators.
-   */
-  asyncValidate?: (value: any, values: Record<string, any>) => Promise<string | null | undefined>
-  /** Debounce (ms) before `asyncValidate` runs on edit. Default 300. */
-  asyncDebounce?: number
-  /** Span full width in the grid. */
-  full?: boolean
-  /** Columns to span (generalizes `full`); `2`+ widens the field in a grid. */
-  span?: number
-  /**
-   * Show the field only when this is `true` / returns `true` (default: always).
-   * A field derived from other values, e.g. `visible: (v) => v.hasAddress`.
-   * Hidden fields are skipped in validation and excluded from the submitted values.
-   */
-  visible?: boolean | ((values: Record<string, any>) => boolean)
-  /** Disable the field, statically or derived from other values. */
-  disabled?: boolean | ((values: Record<string, any>) => boolean)
-  /**
-   * For `type: 'array'` - the fields of each repeatable item. The value is an
-   * array of item objects; each item's fields validate against that item (so
-   * cross-field rules within a row work). `required`/`minItems`/`maxItems` gate
-   * the array length.
-   */
-  itemFields?: ReadonlyArray<FormField>
-  /** Label for the "add item" button of an array field. Default "+ Add". */
-  addLabel?: string
-  /** Min / max item count for an array field. */
-  minItems?: number
-  maxItems?: number
-}
-
-/**
- * A group of fields rendered as a titled fieldset - and, when `<SvForm stepper>`
- * is set, as one step of a wizard. Use in place of a plain `FormField` inside the
- * `fields` array; the schema may freely mix flat fields and sections.
- */
-export type FormSection = {
-  section: string
-  description?: string
-  fields: ReadonlyArray<FormField>
-  /** Column count for this section's grid (defaults to the form's `columns`). */
-  columns?: number
-}
-
-/** An entry in a form schema: either a single field or a titled section/step. */
-export type FormEntry = FormField | FormSection
-
-/** Narrow a schema entry to a section (has a `fields` array). */
-export function isFormSection(e: FormEntry): e is FormSection {
-  return Array.isArray((e as FormSection).fields)
-}
-
-/** Flatten a mixed schema (fields + sections) to the flat list of fields. */
-export function flattenFields(entries: ReadonlyArray<FormEntry>): FormField[] {
-  const out: FormField[] = []
-  for (const e of entries) {
-    if (isFormSection(e)) out.push(...e.fields)
-    else out.push(e)
-  }
-  return out
-}
+import type { Validator } from './validators'
+
+/**
+ * Field descriptor for <SvForm> and the headless `createForm` core. Kept in a
+ * plain `.ts` module so the core can import the type without pulling in the
+ * `.svelte` component (which would create a `.svelte.ts` -> `.svelte` import
+ * cycle Vite's dev import-analysis fails to resolve).
+ */
+export type FormFieldType =
+  | 'text' | 'email' | 'tel' | 'textarea' | 'number' | 'password'
+  | 'select' | 'multiselect' | 'checkbox' | 'switch' | 'date' | 'color' | 'rating'
+  | 'radio' | 'slider' | 'tags' | 'phone' | 'country' | 'mask'
+  | 'datetime' | 'time' | 'daterange' | 'combobox' | 'file'
+  | 'array'
+
+export type FormField = {
+  name: string
+  label: string
+  type?: FormFieldType
+  required?: boolean
+  /** Show the field but block edits (still submitted, unlike hidden fields). */
+  readonly?: boolean
+  /** Helper text shown under the control (distinct from a validation error). */
+  help?: string
+  placeholder?: string
+  /**
+   * Options for select/combobox/radio/multiselect. A function makes them CASCADE:
+   * the list is derived from the current form values (e.g. cities for the picked
+   * country). Pair with `dependsOn` so the child clears when the parent changes.
+   */
+  options?:
+    | Array<{ value: string | number; label: string; color?: string }>
+    | ((values: Record<string, any>) => Array<{ value: string | number; label: string; color?: string }>)
+  /** Field name(s) this one depends on; when a parent changes, this field's value
+   *  is cleared (cascading selects). */
+  dependsOn?: string | string[]
+  /** Mask pattern for `type: 'mask'` (`#`=digit, `A`=letter, `*`=alnum). */
+  mask?: string
+  /** Numeric bounds for `type: 'number'` / `'slider'`. */
+  min?: number
+  max?: number
+  step?: number
+  precision?: number
+  /** Text affixes for `type: 'number'` (e.g. `$` / `%`). */
+  prefix?: string
+  suffix?: string
+  /** Remote option loader for `type: 'combobox'` (debounced typeahead). The
+   *  current form `values` are passed so it can depend on other fields. */
+  loadOptions?: (query: string, values: Record<string, any>) => Promise<Array<{ value: string | number; label: string }>>
+  /** File input hints for `type: 'file'`. */
+  accept?: string
+  multiple?: boolean
+  /**
+   * Derive this field's value from the other form values (e.g. a total). A
+   * computed field is read-only, recomputes reactively, is not user-validated,
+   * and its derived value is included in the submitted payload.
+   */
+  computed?: (values: Record<string, any>) => any
+  /** Declarative validation rules (see `rules` - email/pattern/min/compare...). */
+  rules?: ReadonlyArray<Validator>
+  /** Return an error message, or null/undefined when valid. */
+  validate?: (value: any, values: Record<string, any>) => string | null | undefined
+  /**
+   * Async validator (e.g. "is this username taken?"). Runs after the sync checks
+   * pass, debounced (`asyncDebounce`, default 300ms) and stale-guarded so only the
+   * latest result wins. While it runs, `form.isValidating(name)` is true and the
+   * field shows a checking indicator. Submit waits for all async validators.
+   */
+  asyncValidate?: (value: any, values: Record<string, any>) => Promise<string | null | undefined>
+  /** Debounce (ms) before `asyncValidate` runs on edit. Default 300. */
+  asyncDebounce?: number
+  /** Span full width in the grid. */
+  full?: boolean
+  /** Columns to span (generalizes `full`); `2`+ widens the field in a grid. */
+  span?: number
+  /**
+   * Show the field only when this is `true` / returns `true` (default: always).
+   * A field derived from other values, e.g. `visible: (v) => v.hasAddress`.
+   * Hidden fields are skipped in validation and excluded from the submitted values.
+   */
+  visible?: boolean | ((values: Record<string, any>) => boolean)
+  /** Disable the field, statically or derived from other values. */
+  disabled?: boolean | ((values: Record<string, any>) => boolean)
+  /**
+   * For `type: 'array'` - the fields of each repeatable item. The value is an
+   * array of item objects; each item's fields validate against that item (so
+   * cross-field rules within a row work). `required`/`minItems`/`maxItems` gate
+   * the array length.
+   */
+  itemFields?: ReadonlyArray<FormField>
+  /** Label for the "add item" button of an array field. Default "+ Add". */
+  addLabel?: string
+  /** Min / max item count for an array field. */
+  minItems?: number
+  maxItems?: number
+}
+
+/**
+ * A group of fields rendered as a titled fieldset - and, when `<SvForm stepper>`
+ * is set, as one step of a wizard. Use in place of a plain `FormField` inside the
+ * `fields` array; the schema may freely mix flat fields and sections.
+ */
+export type FormSection = {
+  section: string
+  description?: string
+  fields: ReadonlyArray<FormField>
+  /** Column count for this section's grid (defaults to the form's `columns`). */
+  columns?: number
+}
+
+/** An entry in a form schema: either a single field or a titled section/step. */
+export type FormEntry = FormField | FormSection
+
+/** Narrow a schema entry to a section (has a `fields` array). */
+export function isFormSection(e: FormEntry): e is FormSection {
+  return Array.isArray((e as FormSection).fields)
+}
+
+/** Flatten a mixed schema (fields + sections) to the flat list of fields. */
+export function flattenFields(entries: ReadonlyArray<FormEntry>): FormField[] {
+  const out: FormField[] = []
+  for (const e of entries) {
+    if (isFormSection(e)) out.push(...e.fields)
+    else out.push(e)
+  }
+  return out
+}

package/src/grid-messages.ts

@@ -78,10 +78,27 @@ export type GridMessages = {
   menuRemoveRow: string
   menuRemoveColumn: string
   menuEditComment: string
+  // Selection bar
+  selectionBarLabel: string
+  selectionBarCount: string
+  selectionBarClear: string
+  selectionBarMore: string
+  selectionBarSelectAll: string
+  selectionBarEditFields: string
+  // Bulk edit dialog
+  bulkEditTitle: string
+  bulkEditLead: string
+  bulkEditMixed: string
+  bulkEditApply: string
+  bulkEditCancel: string
+  bulkEditNoFields: string
   chartRange: string
   // Upsell notes (enterprise views not installed)
   pivotUpsellTitle: string
   pivotUpsellBody: string
+  /** Shared licensing line under every Enterprise upsell note. */
+  upsellLicense: string
+  upsellLicenseLink: string
 }
 
 /** English defaults - the literal strings the grid shipped before localization. */
@@ -124,6 +141,20 @@ export const defaultGridMessages: GridMessages = {
   menuRemoveRow: 'Remove row',
   menuRemoveColumn: 'Remove column',
   menuEditComment: 'Edit comment',
+  selectionBarLabel: 'Selection actions',
+  /** Label beside the count CHIP, which carries the number itself. */
+  selectionBarCount: 'selected',
+  selectionBarClear: 'Clear selection',
+  selectionBarMore: 'More actions',
+  selectionBarSelectAll: 'Select all',
+  selectionBarEditFields: 'Edit fields',
+  bulkEditTitle: 'Edit fields',
+  bulkEditLead:
+    'Changes apply to all {count} selected items. Fields you leave alone keep their existing values.',
+  bulkEditMixed: 'Multiple values',
+  bulkEditApply: 'Apply to {count} items',
+  bulkEditCancel: 'Cancel',
+  bulkEditNoFields: 'No editable fields on this grid.',
   opContains: 'Contains',
   opNotContains: 'Not contains',
   opEquals: 'Equals',
@@ -143,6 +174,9 @@ export const defaultGridMessages: GridMessages = {
   chartRange: 'Chart selected range',
   pivotUpsellTitle: 'Pivot mode',
   pivotUpsellBody: 'Pivot mode is an Enterprise feature. Install @svgrid/enterprise and call enablePivot() to use it.',
+  upsellLicense:
+    'A license key is required for production use. Without one the feature still works, but the grid renders an unlicensed watermark.',
+  upsellLicenseLink: 'View licensing',
 }
 
 /**