@svgrid/enterprise 3.0.1 → 3.0.3

package/dist/SvSheetTextToColumns.svelte

@@ -0,0 +1,172 @@
+<script lang="ts">
+  /**
+   * Excel's Convert Text to Columns Wizard, the delimited page: pick the
+   * delimiter (guessed from the column first), see the split in a preview,
+   * Finish writes the fields into the columns to the right of the source
+   * inside one batch, so the whole split is one Ctrl+Z.
+   */
+  import { useSheetText } from './sheet-text'
+  import { untrack } from 'svelte'
+  import { SvModal } from '@svgrid/grid'
+  import type { GridCommandContext } from '@svgrid/grid/shortcuts'
+  import type { Workbook } from './sheet/workbook'
+  import { textToColumns, guessDelimiter } from './sheet/transforms'
+  import { colToLetters } from './sheet/address'
+
+  type Props = {
+    open?: boolean
+    workbook: Workbook
+    cmd: () => GridCommandContext | null
+    /** Called after the split, so the shell repaints and refocuses. */
+    onDone: (message: string) => void
+    onClose?: () => void
+  }
+
+  let { open = $bindable(false), workbook, cmd, onDone, onClose }: Props = $props()
+  const t = useSheetText()
+
+  const DELIMITERS = [
+    { id: 'tab', label: 'textToColumns.tab', sep: '\t' },
+    { id: 'semicolon', label: 'textToColumns.semicolon', sep: ';' },
+    { id: 'comma', label: 'textToColumns.comma', sep: ',' },
+    { id: 'space', label: 'textToColumns.space', sep: ' ' },
+    { id: 'other', label: 'textToColumns.other', sep: '' },
+  ] as const
+  type DelimiterId = (typeof DELIMITERS)[number]['id']
+
+  let delimiter = $state<DelimiterId>('comma')
+  let other = $state('|')
+  let collapse = $state(false)
+  let trim = $state(true)
+  let column = $state<{ index: number; top: number; texts: string[] }>({ index: 0, top: 0, texts: [] })
+
+  const separator = $derived(
+    delimiter === 'other' ? other : DELIMITERS.find((d) => d.id === delimiter)!.sep,
+  )
+  const preview = $derived.by(() =>
+    textToColumns(column.texts.slice(0, 6), {
+      delimiters: separator ? [separator] : [','],
+      collapse,
+      trim,
+    }),
+  )
+
+  /**
+   * The column under the selection, from the selection's first row (a
+   * whole-column selection starts at the top) down to the last used row.
+   */
+  $effect(() => {
+    if (!open) return
+    untrack(prepare)
+  })
+
+  function prepare() {
+    const c = cmd()
+    const range = c?.ranges[c.ranges.length - 1]
+    const left = range ? range[1] : (c?.activeCell?.colIndex ?? 0)
+    const top = range ? range[0] : (c?.activeCell?.rowIndex ?? 0)
+    const bottom = Math.max(workbook.rowCount(workbook.active) - 1, top)
+    const texts = Array.from({ length: bottom - top + 1 }, (_, i) => workbook.getRaw(workbook.active, top + i, left))
+    column = { index: left, top, texts }
+    const guess = guessDelimiter(texts.filter((t) => t !== ''))
+    const known = DELIMITERS.find((d) => d.sep === guess && d.id !== 'other')
+    if (known) delimiter = known.id
+    else if (guess) { delimiter = 'other'; other = guess }
+  }
+
+  function finish() {
+    const c = cmd()
+    if (!c) return
+    const { rows, width } = textToColumns(column.texts, {
+      delimiters: separator ? [separator] : [','],
+      collapse,
+      trim,
+    })
+    c.batch(() => {
+      rows.forEach((fields, r) => {
+        for (let i = 0; i < width; i += 1) {
+          c.setCellValue(column.top + r, column.index + i, fields[i] ?? '')
+        }
+      })
+    })
+    open = false
+    c.setSelection(column.top, column.index)
+    c.extendSelection(column.top + rows.length - 1, column.index + width - 1)
+    onDone(t('textToColumns.done', { rows: rows.length, columns: width }))
+    onClose?.()
+  }
+
+  function close() {
+    open = false
+    onClose?.()
+  }
+</script>
+
+<SvModal bind:open onClose={onClose} title={t('textToColumns.title')} size="md">
+  <div class="sv-sheet-dialog" role="group" aria-label={t('textToColumns.group')}>
+    <p class="lead">{t('textToColumns.lead')}</p>
+    <fieldset class="group">
+      <legend>{t('textToColumns.delimiters')}</legend>
+      {#each DELIMITERS as d (d.id)}
+        <label class="check">
+          <input type="radio" name="sheet-delimiter" value={d.id} bind:group={delimiter} />
+          {t(d.label)}
+          {#if d.id === 'other'}
+            <input class="other" type="text" maxlength="1" bind:value={other} aria-label={t('textToColumns.otherDelimiter')} />
+          {/if}
+        </label>
+      {/each}
+    </fieldset>
+    <div class="checks">
+      <label class="check"><input type="checkbox" bind:checked={collapse} /> {t('textToColumns.collapse')}</label>
+      <label class="check"><input type="checkbox" bind:checked={trim} /> {t('textToColumns.trim')}</label>
+    </div>
+    <div class="preview" aria-label={t('textToColumns.preview')}>
+      <table>
+        <tbody>
+          {#each preview.rows as fields, i (i)}
+            <tr>{#each fields as field, j (j)}<td>{field}</td>{/each}</tr>
+          {/each}
+        </tbody>
+      </table>
+    </div>
+    <p class="status">
+      {t('textToColumns.status', { rows: column.texts.length, from: colToLetters(column.index), count: preview.width, unit: t(preview.width === 1 ? 'textToColumns.column' : 'textToColumns.columns') })}
+    </p>
+  </div>
+  {#snippet footer()}
+    <div class="sv-sheet-dialog-buttons">
+      <button type="button" class="btn primary" onclick={finish} disabled={column.texts.length === 0}>{t('textToColumns.finish')}</button>
+      <button type="button" class="btn" onclick={close}>{t('cancel')}</button>
+    </div>
+  {/snippet}
+</SvModal>
+
+<style>
+  .lead { margin: 0; }
+  .group {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px 16px;
+    margin: 0;
+    padding: 6px 10px 8px;
+    border: 1px solid var(--sg-border, #d1d1d1);
+    border-radius: var(--sg-radius, 3px);
+  }
+  .group legend { padding: 0 4px; font-weight: 600; }
+  .other { width: 32px !important; height: 22px !important; padding: 0 4px !important; text-align: center; }
+  .preview {
+    max-height: 150px;
+    overflow: auto;
+    border: 1px solid var(--sg-border, #d1d1d1);
+    border-radius: var(--sg-radius, 3px);
+    background: var(--sg-bg, #fff);
+  }
+  .preview table { border-collapse: collapse; font-size: 12px; }
+  .preview td {
+    padding: 3px 8px;
+    border-right: 1px solid var(--sg-border, #e5e5e5);
+    border-bottom: 1px solid var(--sg-border, #e5e5e5);
+    white-space: nowrap;
+  }
+</style>

package/dist/SvSheetTextToColumns.svelte.d.ts

@@ -0,0 +1,13 @@
+import type { GridCommandContext } from '@svgrid/grid/shortcuts';
+import type { Workbook } from './sheet/workbook.js';
+type Props = {
+    open?: boolean;
+    workbook: Workbook;
+    cmd: () => GridCommandContext | null;
+    /** Called after the split, so the shell repaints and refocuses. */
+    onDone: (message: string) => void;
+    onClose?: () => void;
+};
+declare const SvSheetTextToColumns: import("svelte").Component<Props, {}, "open">;
+type SvSheetTextToColumns = ReturnType<typeof SvSheetTextToColumns>;
+export default SvSheetTextToColumns;

package/dist/SvSheetValidationAlert.svelte

@@ -0,0 +1,85 @@
+<script lang="ts">
+  /**
+   * The box Excel shows when an entry breaks a validation rule. Stop: the
+   * message, Retry (the cell reopens with the entry) and Cancel. Warning:
+   * the message, "Continue?", Yes (the entry lands anyway), No (retry) and
+   * Cancel. Enter takes the first button, Escape cancels.
+   */
+  import { useSheetText } from './sheet-text'
+  import { SvModal } from '@svgrid/grid'
+
+  type Props = {
+    open?: boolean
+    alert: { style: 'stop' | 'warning'; title: string; message: string } | null
+    onRetry: () => void
+    /** Warning only: keep the entry. */
+    onAccept: () => void
+    onCancel: () => void
+  }
+
+  let { open = $bindable(false), alert, onRetry, onAccept, onCancel }: Props = $props()
+  const t = useSheetText()
+  let first = $state<HTMLButtonElement | null>(null)
+
+  $effect(() => {
+    if (!open) return
+    queueMicrotask(() => first?.focus())
+  })
+
+  function done(fn: () => void) {
+    open = false
+    fn()
+  }
+</script>
+
+<SvModal bind:open onClose={onCancel} title={alert?.title ?? t('dataValidationTitle')} size="sm">
+  <div class="sv-sheet-dialog alert" role="alertdialog" aria-describedby="sv-sheet-validation-message">
+    <span class="mark" class:warning={alert?.style === 'warning'} aria-hidden="true">{alert?.style === 'warning' ? '!' : '×'}</span>
+    <div>
+      <p id="sv-sheet-validation-message" class="message">{alert?.message}</p>
+      {#if alert?.style === 'warning'}<p class="message">{t('validationContinue')}</p>{/if}
+    </div>
+  </div>
+  {#snippet footer()}
+    <div class="sv-sheet-dialog-buttons">
+      {#if alert?.style === 'warning'}
+        <button bind:this={first} type="button" class="btn primary" onclick={() => done(onAccept)}>{t('yes')}</button>
+        <button type="button" class="btn" onclick={() => done(onRetry)}>{t('no')}</button>
+      {:else}
+        <button bind:this={first} type="button" class="btn primary" onclick={() => done(onRetry)}>{t('retry')}</button>
+      {/if}
+      <button type="button" class="btn" onclick={() => done(onCancel)}>{t('cancel')}</button>
+    </div>
+  {/snippet}
+</SvModal>
+
+<style>
+  .alert {
+    flex-direction: row;
+    align-items: flex-start;
+    gap: 14px;
+    min-width: 300px;
+    max-width: 420px;
+  }
+  .mark {
+    flex: 0 0 auto;
+    width: 32px;
+    height: 32px;
+    display: grid;
+    place-items: center;
+    font-size: 20px;
+    font-weight: 700;
+    line-height: 1;
+    color: var(--sg-on-accent, #fff);
+    background: var(--sg-danger, #c42b1c);
+    border-radius: 50%;
+  }
+  .mark.warning {
+    color: #242424;
+    background: var(--sg-warning, #f2c811);
+  }
+  .message {
+    margin: 0 0 6px;
+    white-space: pre-wrap;
+  }
+</style>

package/dist/SvSheetValidationAlert.svelte.d.ts

@@ -0,0 +1,15 @@
+type Props = {
+    open?: boolean;
+    alert: {
+        style: 'stop' | 'warning';
+        title: string;
+        message: string;
+    } | null;
+    onRetry: () => void;
+    /** Warning only: keep the entry. */
+    onAccept: () => void;
+    onCancel: () => void;
+};
+declare const SvSheetValidationAlert: import("svelte").Component<Props, {}, "open">;
+type SvSheetValidationAlert = ReturnType<typeof SvSheetValidationAlert>;
+export default SvSheetValidationAlert;

package/dist/advanced-filter-enable.js

@@ -1,7 +1,7 @@
 /**
  * Advanced Filter (Pro): register the expression compiler with the grid.
  *
- * Same shape as `pivot-enable.ts` - idempotent flag, register, soft-gate nudge.
+ * Same shape as `pivot-enable.ts` - idempotent flag, register, unlicensed nudge.
  * The grid owns the filter state and the pipeline slot; this supplies the
  * compiler that turns an expression into a row predicate.
  */

package/dist/alerts/alert-engine.d.ts

@@ -19,6 +19,12 @@ export type AlertEngine<TData> = {
     evaluate(rows: ReadonlyArray<TData>): AlertEvent[];
     /** Prev -> next pass: fires `relativeChange` plus `dataChange` edges. */
     evaluateTransition(prev: ReadonlyArray<TData>, next: ReadonlyArray<TData>): AlertEvent[];
+    /**
+     * Scheduled pass for one rule: every row matching its predicate now, with
+     * no edge memory, since the point of a schedule is the standing list at
+     * that moment. Aggregate rules answer with one event or none.
+     */
+    evaluateScheduled(ruleId: string, rows: ReadonlyArray<TData>): AlertEvent[];
     /** Would editing `(row, columnId) -> nextValue` trip a validation rule? */
     validateEdit(row: TData, columnId: string, nextValue: unknown): ValidateEditResult;
     /**

package/dist/alerts/alert-engine.js

@@ -26,21 +26,23 @@ function defaultMessage(rule) {
 }
 export function createAlertEngine(options) {
     let rules = options.rules;
-    const getValue = options.getValue;
     const now = options.now ?? (() => Date.now());
     // Edge memory: keys currently satisfying a `dataChange`/aggregate predicate.
     const active = new Set();
+    // Read off `options` at use, not once here: the overlay hands in getters
+    // for its `getValue` and `locale` props so a change after mount reaches
+    // the next evaluation.
     const ctxFor = (row, rows, prev) => ({
         row,
         prev,
         rows,
-        getValue,
+        getValue: options.getValue,
         locale: options.locale,
     });
     const val = (row, columnId) => columnId == null
         ? undefined
-        : getValue
-            ? getValue(row, columnId)
+        : options.getValue
+            ? options.getValue(row, columnId)
             : row?.[columnId];
     // A representative column for the message `{value}`/`{column}` tokens: the
     // rule's explicit target, else the first column its predicate references.
@@ -172,6 +174,21 @@ export function createAlertEngine(options) {
             }
             return events;
         },
+        evaluateScheduled(ruleId, rows) {
+            const rule = activeRules().find((r) => r.id === ruleId);
+            if (!rule)
+                return [];
+            if (rule.scope === 'aggregate')
+                return evaluateAggregate(rule, rows);
+            const events = [];
+            for (const row of rows) {
+                if (!evaluatePredicate(rule.predicate, ctxFor(row, rows)))
+                    continue;
+                const source = primaryColumn(rule);
+                events.push(buildEvent(rule, { row, rowId: options.getRowId(row), columnId: rule.scope === 'cell' ? source : undefined, value: val(row, source) }));
+            }
+            return events;
+        },
         validateEdit(row, columnId, nextValue) {
             const candidate = { ...row, [columnId]: nextValue };
             const events = [];

package/dist/alerts/alert-formats.js

@@ -24,6 +24,7 @@ export function rulesToConditionalFormats(rules, ctx = {}) {
                 when: ({ row }) => evaluatePredicate(rule.predicate, { row, getValue: ctx.getValue, locale: ctx.locale }),
                 ...(style.background ? { background: style.background } : {}),
                 ...(style.color ? { color: style.color } : {}),
+                ...(style.icon ? { icon: style.icon } : {}),
             });
         }
     }
@@ -51,6 +52,7 @@ export function toConditionalFormats(events, getRowId) {
                 when: ({ row }) => getRowId(row) === rowId,
                 ...(style.background ? { background: style.background } : {}),
                 ...(style.color ? { color: style.color } : {}),
+                ...(style.icon ? { icon: style.icon } : {}),
             });
         }
     }

package/dist/alerts/alert-types.d.ts

@@ -40,7 +40,7 @@ export type AlertActionKind = 'toast' | 'badge' | 'cellFlash' | 'highlight' | 'p
 export type AlertActionStyle = {
     background?: string;
     color?: string;
-    /** A short glyph/emoji shown as a badge. */
+    /** A short glyph/emoji drawn before the cell value while the rule matches. */
     icon?: string;
 };
 export type AlertAction = {

package/dist/alerts.d.ts

@@ -1,2 +1,2 @@
-/** Turn on the alerts feature (soft-gated). Idempotent. */
+/** Turn on the alerts feature (runs without a key, with the watermark and the console notice). Idempotent. */
 export declare function enableAlerts(): void;

package/dist/alerts.js

@@ -3,7 +3,7 @@
  *
  * Unlike the scheduler/board *views*, alerts are an overlay the consumer mounts
  * next to the grid (`<SvGridAlerts>`), so there is no renderer to register with
- * the grid. `enableAlerts()` exists only to keep the Pro soft-gate consistent
+ * the grid. `enableAlerts()` exists only to keep the evaluation behaviour consistent
  * with the rest of Enterprise: it works without a license key but nudges once in
  * the console when unlicensed.
  *
@@ -18,7 +18,7 @@
 import { isLicenseKeySet } from './license.js';
 import { emitUnlicensedNudge } from './watermark.js';
 let enabled = false;
-/** Turn on the alerts feature (soft-gated). Idempotent. */
+/** Turn on the alerts feature (runs without a key, with the watermark and the console notice). Idempotent. */
 export function enableAlerts() {
     if (enabled)
         return;

package/dist/board.js

@@ -4,8 +4,8 @@
  * ships the `board` prop and its config types for free; the *renderer*
  * (SvGridBoard) is Pro and plugs in through the grid's `registerBoardView` seam.
  *
- * Soft-gated like the rest of Enterprise: it works without a license key but the
- * grid shows the "unlicensed" watermark + a one-time console nudge.
+ * Like the rest of Enterprise it runs without a license key during the
+ * evaluation; the grid shows the watermark and a one-time console notice.
  *
  * ```ts
  * import { setLicenseKey, enableBoardView } from '@svgrid/enterprise'

package/dist/bulk-edit.d.ts

@@ -6,8 +6,10 @@
  * so the rules below live in one readable place rather than inside markup.
  */
 export type BulkEditField = {
-    /** Column id, which is what the write is addressed by. */
+    /** Column id, which is what a local write is addressed by. */
     id: string;
+    /** The row field behind the column, which is what a datasource write is keyed by. */
+    field: string;
     /** Header text, or the column id when the header is not a plain string. */
     label: string;
     /** The column's editor type, mapped to a form control by the drawer. */

package/dist/bulk-edit.js

@@ -33,7 +33,7 @@ export function bulkEditableFields(ctx) {
                 ? { value: o.value, label: String(o.label ?? o.value) }
                 : { value: o, label: String(o) })
             : undefined;
-        out.push({ id: column.id, label, editorType: String(def.editorType ?? 'text'), options });
+        out.push({ id: column.id, field: String(def.field), label, editorType: String(def.editorType ?? 'text'), options });
     }
     return out;
 }