@svgrid/grid 1.2.34 → 2.0.0

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/fuzzy.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest'
+import { fuzzyScore, fuzzyMatch } from './fuzzy'
+
+describe('fuzzyScore', () => {
+  it('matches a subsequence, rejects a non-subsequence', () => {
+    expect(fuzzyScore('New invoice', 'ni')).not.toBeNull()
+    expect(fuzzyScore('New invoice', 'niv')).not.toBeNull()
+    expect(fuzzyScore('New invoice', 'xyz')).toBeNull()
+    expect(fuzzyScore('New invoice', 'ivn')).toBeNull() // out of order
+  })
+
+  it('is case-insensitive and returns 0 for an empty query', () => {
+    expect(fuzzyMatch('Export CSV', 'EXPORT')).toBe(true)
+    expect(fuzzyScore('anything', '')).toBe(0)
+  })
+
+  it('scores a contiguous / prefix match higher than a scattered one', () => {
+    const prefix = fuzzyScore('Settings', 'set')!
+    const scattered = fuzzyScore('Silent tester', 'set')!
+    expect(prefix).toBeGreaterThan(scattered)
+  })
+
+  it('rewards word-boundary starts', () => {
+    const boundary = fuzzyScore('Open file', 'of')! // O..f (word starts)
+    const inner = fuzzyScore('Profile', 'of')! // ...of.. inside a word
+    expect(boundary).toBeGreaterThan(inner)
+  })
+
+  it('filters a list to matches only', () => {
+    const cmds = ['New invoice', 'New order', 'Export invoices', 'Delete invoice']
+    const ranked = cmds
+      .map((c) => ({ c, s: fuzzyScore(c, 'inv') }))
+      .filter((x) => x.s !== null)
+      .sort((a, b) => b.s! - a.s!)
+      .map((x) => x.c)
+    expect(ranked).toHaveLength(3) // "New order" has no 'inv' subsequence
+    expect(ranked).not.toContain('New order')
+    expect(ranked).toContain('New invoice')
+  })
+})

package/src/fuzzy.ts

@@ -0,0 +1,39 @@
+/**
+ * fuzzy - a tiny subsequence fuzzy matcher for command palettes / quick filters.
+ * `fuzzyScore(text, query)` returns a score (higher = better) when every query
+ * character appears in order in `text`, or `null` when it doesn't. Contiguous
+ * runs, word-boundary starts and early matches score higher. Case-insensitive,
+ * pure, dependency-free.
+ */
+const BOUNDARY = /[\s\-_/.]/
+
+export function fuzzyScore(text: string, query: string): number | null {
+  const q = query.trim().toLowerCase()
+  if (!q) return 0
+  const t = text.toLowerCase()
+  let from = 0
+  let score = 0
+  let run = 0
+  let prev = -2
+  for (const ch of q) {
+    const idx = t.indexOf(ch, from)
+    if (idx < 0) return null
+    if (idx === prev + 1) {
+      run += 1
+      score += 5 + run * 2 // contiguous run
+    } else {
+      run = 0
+      score += 1
+    }
+    if (idx === 0 || BOUNDARY.test(t[idx - 1] ?? '')) score += 8 // word start
+    score += Math.max(0, 3 - Math.floor(idx / 4)) // earliness
+    prev = idx
+    from = idx + 1
+  }
+  return score
+}
+
+/** Whether `query` fuzzy-matches `text`. */
+export function fuzzyMatch(text: string, query: string): boolean {
+  return fuzzyScore(text, query) !== null
+}

package/src/grid-select.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from 'vitest'
+import { filterGridRows } from './grid-select'
+
+const rows = [
+  { id: 1, name: 'Ada Lovelace', email: 'ada@x.io' },
+  { id: 2, name: 'Alan Turing', email: 'alan@x.io' },
+  { id: 3, name: 'Grace Hopper', email: 'grace@x.io' },
+]
+
+describe('filterGridRows', () => {
+  it('returns every row for a blank query', () => {
+    expect(filterGridRows(rows, ['name', 'email'], '')).toHaveLength(3)
+    expect(filterGridRows(rows, ['name'], '   ')).toHaveLength(3)
+  })
+
+  it('matches a substring in any of the given fields (case-insensitive)', () => {
+    expect(filterGridRows(rows, ['name', 'email'], 'grace').map((r) => r.id)).toEqual([3])
+    expect(filterGridRows(rows, ['name', 'email'], 'ALAN').map((r) => r.id)).toEqual([2])
+    // "a" appears in every name -> all 3
+    expect(filterGridRows(rows, ['name'], 'a')).toHaveLength(3)
+  })
+
+  it('only searches the fields it is given', () => {
+    // 'x.io' is in email but we only search name -> no matches
+    expect(filterGridRows(rows, ['name'], 'x.io')).toHaveLength(0)
+    expect(filterGridRows(rows, ['email'], 'x.io')).toHaveLength(3)
+  })
+})

package/src/grid-select.ts

@@ -0,0 +1,20 @@
+/**
+ * grid-select - pure helper behind <SvGridSelect>: filter option rows by a
+ * free-text query across a set of fields (case-insensitive substring match).
+ * Framework-free + pure so it is unit-tested directly.
+ */
+export type Row = Record<string, unknown>
+
+/** Rows where ANY of `fields` contains `query` (case-insensitive). Blank query
+ *  returns every row. */
+export function filterGridRows<T extends Row>(
+  rows: ReadonlyArray<T>,
+  fields: ReadonlyArray<string>,
+  query: string,
+): T[] {
+  const q = query.trim().toLowerCase()
+  if (!q) return [...rows]
+  return rows.filter((row) =>
+    fields.some((f) => String(row[f] ?? '').toLowerCase().includes(q)),
+  )
+}