@svgrid/enterprise 3.0.2 → 3.1.0

package/dist/SvSheetPasteSpecial.svelte

@@ -6,6 +6,7 @@
    * took and applies the choice through `planPaste` / `resolvePasteCell`;
    * this component only asks the question.
    */
+  import { useSheetText } from './sheet-text'
   import { SvModal } from '@svgrid/grid'
   import type { PasteSpecialOptions, PasteWhat, PasteOperation } from './sheet/paste-special'
 
@@ -19,6 +20,7 @@
   }
 
   let { open = $bindable(false), hasClipboard, onPaste, onClose }: Props = $props()
+  const t = useSheetText()
 
   let what = $state<PasteWhat>('all')
   let operation = $state<PasteOperation>('none')
@@ -26,17 +28,17 @@
   let transpose = $state(false)
 
   const WHAT: ReadonlyArray<{ value: PasteWhat; label: string }> = [
-    { value: 'all', label: 'All' },
-    { value: 'formulas', label: 'Formulas' },
-    { value: 'values', label: 'Values' },
-    { value: 'formats', label: 'Formats' },
+    { value: 'all', label: 'pasteSpecial.all' },
+    { value: 'formulas', label: 'pasteSpecial.formulas' },
+    { value: 'values', label: 'pasteSpecial.values' },
+    { value: 'formats', label: 'pasteSpecial.formats' },
   ]
   const OPERATIONS: ReadonlyArray<{ value: PasteOperation; label: string }> = [
-    { value: 'none', label: 'None' },
-    { value: 'add', label: 'Add' },
-    { value: 'subtract', label: 'Subtract' },
-    { value: 'multiply', label: 'Multiply' },
-    { value: 'divide', label: 'Divide' },
+    { value: 'none', label: 'pasteSpecial.none' },
+    { value: 'add', label: 'pasteSpecial.add' },
+    { value: 'subtract', label: 'pasteSpecial.subtract' },
+    { value: 'multiply', label: 'pasteSpecial.multiply' },
+    { value: 'divide', label: 'pasteSpecial.divide' },
   ]
 
   function ok() {
@@ -51,34 +53,34 @@
   }
 </script>
 
-<SvModal bind:open onClose={onClose} title="Paste Special" size="sm">
-  <div class="sv-sheet-dialog" role="group" aria-label="Paste Special">
+<SvModal bind:open onClose={onClose} title={t('pasteSpecial.title')} size="sm">
+  <div class="sv-sheet-dialog" role="group" aria-label={t('pasteSpecial.title')}>
     {#if !hasClipboard}
-      <p class="status">Nothing has been copied from the sheet yet. Copy a range first, then Paste Special.</p>
+      <p class="status">{t('pasteSpecial.empty')}</p>
     {/if}
     <div class="columns">
       <fieldset class="group">
-        <legend>Paste</legend>
+        <legend>{t('pasteSpecial.paste')}</legend>
         {#each WHAT as choice (choice.value)}
-          <label class="check"><input type="radio" name="sheet-paste-what" value={choice.value} bind:group={what} /> {choice.label}</label>
+          <label class="check"><input type="radio" name="sheet-paste-what" value={choice.value} bind:group={what} /> {t(choice.label)}</label>
         {/each}
       </fieldset>
       <fieldset class="group">
-        <legend>Operation</legend>
+        <legend>{t('pasteSpecial.operation')}</legend>
         {#each OPERATIONS as choice (choice.value)}
-          <label class="check"><input type="radio" name="sheet-paste-op" value={choice.value} bind:group={operation} /> {choice.label}</label>
+          <label class="check"><input type="radio" name="sheet-paste-op" value={choice.value} bind:group={operation} /> {t(choice.label)}</label>
         {/each}
       </fieldset>
     </div>
     <div class="checks">
-      <label class="check"><input type="checkbox" bind:checked={skipBlanks} /> Skip blanks</label>
-      <label class="check"><input type="checkbox" bind:checked={transpose} /> Transpose</label>
+      <label class="check"><input type="checkbox" bind:checked={skipBlanks} /> {t('pasteSpecial.skipBlanks')}</label>
+      <label class="check"><input type="checkbox" bind:checked={transpose} /> {t('pasteSpecial.transpose')}</label>
     </div>
   </div>
   {#snippet footer()}
     <div class="sv-sheet-dialog-buttons">
-      <button type="button" class="btn primary" onclick={ok} disabled={!hasClipboard}>OK</button>
-      <button type="button" class="btn" onclick={close}>Cancel</button>
+      <button type="button" class="btn primary" onclick={ok} disabled={!hasClipboard}>{t('ok')}</button>
+      <button type="button" class="btn" onclick={close}>{t('cancel')}</button>
     </div>
   {/snippet}
 </SvModal>

package/dist/SvSheetPivot.svelte

@@ -0,0 +1,220 @@
+<script lang="ts">
+  /**
+   * Excel's Create PivotTable dialog with its field list folded in: the
+   * source block, where the result goes, and which field is a row, a column
+   * or a measure. Opened by Insert > PivotTable, and again by Refresh on a
+   * cell inside a pivot, which is how one is changed.
+   */
+  import { SvModal } from '@svgrid/grid'
+  import { useSheetText } from './sheet-text'
+  import { parseRangeText, rangeText } from './sheet/protection'
+  import { parseA1, formatA1 } from './sheet/address'
+  import {
+    SHEET_PIVOT_AGGS, ALL_VALUES,
+    type SheetPivot, type SheetPivotAgg, type SheetPivotValue, type SheetPivotFilter,
+  } from './sheet/pivot-range'
+  import type { Rect } from './sheet/format-store'
+
+  type Props = {
+    open?: boolean
+    /** The pivot as it stands, new or being edited. */
+    pivot: SheetPivot
+    /** The source's field names, read from its header row. */
+    fields: ReadonlyArray<string>
+    /**
+     * The values each field carries, for the Filters area's value list.
+     * The dialog has the definition, not the cells, so the shell reads
+     * them off the source.
+     */
+    valuesOf?: (field: string) => ReadonlyArray<string>
+    existing?: boolean
+    onApply: (pivot: SheetPivot) => void
+    onDelete?: () => void
+    onClose?: () => void
+  }
+
+  let { open = $bindable(false), pivot, fields, valuesOf, existing = false, onApply, onDelete, onClose }: Props = $props()
+  const t = useSheetText()
+
+  let source = $state('')
+  let target = $state('')
+  let rows = $state<string[]>([])
+  let cols = $state<string[]>([])
+  let values = $state<SheetPivotValue[]>([])
+  let filters = $state<SheetPivotFilter[]>([])
+  let grandTotalRow = $state(true)
+  let rowSubtotals = $state(true)
+  let error = $state('')
+  let first = $state<HTMLInputElement | null>(null)
+
+  $effect(() => {
+    if (!open) return
+    source = rangeText([pivot.source])
+    target = formatA1({ sheet: null, row: pivot.target.row, col: pivot.target.col, rowAbs: false, colAbs: false })
+    rows = [...pivot.rows]
+    cols = [...pivot.cols]
+    values = pivot.values.map((v) => ({ ...v }))
+    filters = (pivot.filters ?? []).map((f) => ({ ...f }))
+    grandTotalRow = pivot.grandTotalRow !== false
+    rowSubtotals = pivot.rowSubtotals !== false
+    error = ''
+    queueMicrotask(() => first?.focus())
+  })
+
+  /** Where a field sits now: down the rows, across the columns, or a measure. */
+  function placeOf(field: string): Placement {
+    if (rows.includes(field)) return 'rows'
+    if (cols.includes(field)) return 'cols'
+    if (values.some((v) => v.field === field)) return 'values'
+    if (filters.some((f) => f.field === field)) return 'filters'
+    return 'none'
+  }
+
+  type Placement = 'none' | 'rows' | 'cols' | 'values' | 'filters'
+
+  function place(field: string, to: Placement) {
+    rows = rows.filter((f) => f !== field)
+    cols = cols.filter((f) => f !== field)
+    values = values.filter((v) => v.field !== field)
+    filters = filters.filter((f) => f.field !== field)
+    if (to === 'rows') rows = [...rows, field]
+    else if (to === 'cols') cols = [...cols, field]
+    else if (to === 'values') values = [...values, { field, agg: 'sum' }]
+    else if (to === 'filters') filters = [...filters, { field, value: '' }]
+  }
+
+  function setFilter(field: string, value: string) {
+    filters = filters.map((f) => (f.field === field ? { ...f, value } : f))
+  }
+
+  function setAgg(field: string, agg: SheetPivotAgg) {
+    values = values.map((v) => (v.field === field ? { ...v, agg } : v))
+  }
+
+  function ok() {
+    const rects = parseRangeText(source)
+    const block = rects && rects.length === 1 ? rects[0]! : null
+    const at = parseA1(target.trim())
+    if (!block || !at || at.row === null) { error = t('pivot.badRange'); return }
+    if (!values.length) { error = t('pivot.needValue'); return }
+    const next: SheetPivot = {
+      ...pivot,
+      source: block as Rect,
+      target: { row: at.row, col: at.col },
+      rows: [...rows],
+      cols: [...cols],
+      values: values.map((v) => ({ ...v })),
+      ...(filters.length ? { filters: filters.map((f) => ({ ...f })) } : { filters: [] }),
+      grandTotalRow,
+      rowSubtotals,
+    }
+    if (!next.filters?.length) delete next.filters
+    open = false
+    onApply(next)
+    onClose?.()
+  }
+
+  function close() {
+    open = false
+    onClose?.()
+  }
+</script>
+
+<SvModal bind:open onClose={onClose} title={t('pivot.title')} size="md">
+  <form class="sv-sheet-dialog" onsubmit={(e) => { e.preventDefault(); ok() }}>
+    <label class="field">
+      <span>{t('pivot.source')}</span>
+      <input type="text" bind:this={first} bind:value={source} spellcheck="false" placeholder={t('pivot.sourcePlaceholder')} />
+    </label>
+    <label class="field">
+      <span>{t('pivot.target')}</span>
+      <input type="text" bind:value={target} spellcheck="false" placeholder={t('pivot.targetPlaceholder')} />
+    </label>
+    <div class="fields">
+      <div class="head">
+        <span>{t('pivot.field')}</span>
+        <span>{t('pivot.place')}</span>
+        <span>{t('pivot.summarise')}</span>
+      </div>
+      {#each fields as field (field)}
+        {@const place_ = placeOf(field)}
+        <div class="row">
+          <span class="name" title={field}>{field}</span>
+          <select value={place_} onchange={(e) => place(field, e.currentTarget.value as Placement)}>
+            <option value="none">{t('pivot.place.none')}</option>
+            <option value="rows">{t('pivot.place.rows')}</option>
+            <option value="cols">{t('pivot.place.cols')}</option>
+            <option value="values">{t('pivot.place.values')}</option>
+            <option value="filters">{t('pivot.place.filters')}</option>
+          </select>
+          {#if place_ === 'values'}
+            {@const agg = values.find((v) => v.field === field)?.agg ?? 'sum'}
+            <select value={agg} onchange={(e) => setAgg(field, e.currentTarget.value as SheetPivotAgg)}>
+              {#each SHEET_PIVOT_AGGS as id (id)}<option value={id}>{t(`pivot.agg.${id}`)}</option>{/each}
+            </select>
+          {:else if place_ === 'filters'}
+            {@const chosen = filters.find((f) => f.field === field)?.value ?? ''}
+            <select value={chosen} onchange={(e) => setFilter(field, e.currentTarget.value)} aria-label={t('pivot.filterValue', { field })}>
+              <option value="">{ALL_VALUES}</option>
+              {#each valuesOf?.(field) ?? [] as value (value)}<option value={value}>{value}</option>{/each}
+            </select>
+          {:else}
+            <span class="dash">&mdash;</span>
+          {/if}
+        </div>
+      {/each}
+    </div>
+    <div class="checks">
+      <label class="check"><input type="checkbox" bind:checked={grandTotalRow} /> {t('pivot.grandTotal')}</label>
+      <label class="check"><input type="checkbox" bind:checked={rowSubtotals} /> {t('pivot.subtotals')}</label>
+    </div>
+    {#if error}<p class="error">{error}</p>{/if}
+    <p class="hint">{t('pivot.hint')}</p>
+  </form>
+  {#snippet footer()}
+    <div class="sv-sheet-dialog-buttons">
+      {#if existing && onDelete}
+        <button type="button" class="btn" onclick={() => { open = false; onDelete?.() }}>{t('delete')}</button>
+      {/if}
+      <span class="spacer"></span>
+      <button type="button" class="btn primary" onclick={ok}>{t('ok')}</button>
+      <button type="button" class="btn" onclick={close}>{t('cancel')}</button>
+    </div>
+  {/snippet}
+</SvModal>
+
+<style>
+  .spacer { flex: 1; }
+  .error { margin: 4px 0 0; color: var(--sg-danger, #c42b1c); font-size: 12px; }
+  .fields {
+    margin-top: 8px;
+    max-height: 220px;
+    overflow: auto;
+    border: 1px solid var(--sg-border, #d1d1d1);
+    border-radius: var(--sg-radius, 4px);
+  }
+  .head,
+  .row {
+    display: grid;
+    grid-template-columns: 1fr 120px 130px;
+    gap: 8px;
+    align-items: center;
+    padding: 4px 8px;
+  }
+  .head {
+    position: sticky;
+    top: 0;
+    background: var(--sg-header-bg, #f3f3f3);
+    color: var(--sg-muted, #616161);
+    font-size: 11px;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+  }
+  .row + .row { border-top: 1px solid var(--sg-border, #ececec); }
+  .name {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+  .dash { color: var(--sg-muted, #9a9a9a); text-align: center; }
+</style>

package/dist/SvSheetPivot.svelte.d.ts

@@ -0,0 +1,21 @@
+import { type SheetPivot } from './sheet/pivot-range.js';
+type Props = {
+    open?: boolean;
+    /** The pivot as it stands, new or being edited. */
+    pivot: SheetPivot;
+    /** The source's field names, read from its header row. */
+    fields: ReadonlyArray<string>;
+    /**
+     * The values each field carries, for the Filters area's value list.
+     * The dialog has the definition, not the cells, so the shell reads
+     * them off the source.
+     */
+    valuesOf?: (field: string) => ReadonlyArray<string>;
+    existing?: boolean;
+    onApply: (pivot: SheetPivot) => void;
+    onDelete?: () => void;
+    onClose?: () => void;
+};
+declare const SvSheetPivot: import("svelte").Component<Props, {}, "open">;
+type SvSheetPivot = ReturnType<typeof SvSheetPivot>;
+export default SvSheetPivot;

package/dist/SvSheetProtectSheet.svelte

@@ -0,0 +1,81 @@
+<script lang="ts">
+  /**
+   * Excel's Protect Sheet dialog, without the password: the "allow all
+   * users of this worksheet to" list, each entry a kind of change that
+   * stays open once the sheet is protected. OK protects with what is
+   * ticked; the shell keeps the list per sheet, so Unprotect and Protect
+   * again offer the same ticks.
+   */
+  import { useSheetText } from './sheet-text'
+  import { SvModal } from '@svgrid/grid'
+  import { PROTECTION_PERMISSIONS, type ProtectionAllow, type ProtectionPermission } from './sheet/protection'
+
+  type Props = {
+    open?: boolean
+    /** The sheet's list as it stands, what the ticks open on. */
+    allow: ProtectionAllow
+    onApply: (allow: ProtectionAllow) => void
+    onClose?: () => void
+  }
+
+  let { open = $bindable(false), allow, onApply, onClose }: Props = $props()
+  const t = useSheetText()
+
+  let ticks = $state<Record<ProtectionPermission, boolean>>({} as Record<ProtectionPermission, boolean>)
+  let first = $state<HTMLInputElement | null>(null)
+
+  $effect(() => {
+    if (!open) return
+    const next = {} as Record<ProtectionPermission, boolean>
+    for (const key of PROTECTION_PERMISSIONS) next[key] = Boolean(allow[key])
+    ticks = next
+    queueMicrotask(() => first?.focus())
+  })
+
+  function ok() {
+    const next: ProtectionAllow = {}
+    for (const key of PROTECTION_PERMISSIONS) if (ticks[key]) next[key] = true
+    open = false
+    onApply(next)
+    onClose?.()
+  }
+
+  function close() {
+    open = false
+    onClose?.()
+  }
+</script>
+
+<SvModal bind:open onClose={onClose} title={t('protectSheet.title')} size="sm">
+  <form class="sv-sheet-dialog" onsubmit={(e) => { e.preventDefault(); ok() }}>
+    <div class="lead">{t('protectSheet.lead')}</div>
+    <div class="checks column" role="group" aria-label={t('protectSheet.lead')}>
+      {#each PROTECTION_PERMISSIONS as key, i (key)}
+        <label class="check">
+          {#if i === 0}
+            <input bind:this={first} type="checkbox" bind:checked={ticks[key]} />
+          {:else}
+            <input type="checkbox" bind:checked={ticks[key]} />
+          {/if}
+          {t(`protectSheet.${key}`)}
+        </label>
+      {/each}
+    </div>
+    <p class="hint">{t('protectSheet.hint')}</p>
+  </form>
+  {#snippet footer()}
+    <div class="sv-sheet-dialog-buttons">
+      <button type="button" class="btn primary" onclick={ok}>{t('ok')}</button>
+      <button type="button" class="btn" onclick={close}>{t('cancel')}</button>
+    </div>
+  {/snippet}
+</SvModal>
+
+<style>
+  .checks.column {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+    padding: 4px 0;
+  }
+</style>

package/dist/SvSheetProtectSheet.svelte.d.ts

@@ -0,0 +1,11 @@
+import { type ProtectionAllow } from './sheet/protection.js';
+type Props = {
+    open?: boolean;
+    /** The sheet's list as it stands, what the ticks open on. */
+    allow: ProtectionAllow;
+    onApply: (allow: ProtectionAllow) => void;
+    onClose?: () => void;
+};
+declare const SvSheetProtectSheet: import("svelte").Component<Props, {}, "open">;
+type SvSheetProtectSheet = ReturnType<typeof SvSheetProtectSheet>;
+export default SvSheetProtectSheet;

package/dist/SvSheetRemoveDuplicates.svelte

@@ -6,6 +6,7 @@
    * rows they vacated go blank, in one batch, so it is one Ctrl+Z; the
    * sentence Excel's dialog ends on is handed back for the status bar.
    */
+  import { useSheetText } from './sheet-text'
   import { untrack } from 'svelte'
   import { SvModal } from '@svgrid/grid'
   import type { GridCommandContext } from '@svgrid/grid/shortcuts'
@@ -22,6 +23,7 @@
   }
 
   let { open = $bindable(false), workbook, cmd, onDone, onClose }: Props = $props()
+  const t = useSheetText()
 
   type Block = { top: number; left: number; bottom: number; right: number }
   let block = $state<Block>({ top: 0, left: 0, bottom: 0, right: 0 })
@@ -33,7 +35,8 @@
   const headers = $derived.by(() =>
     Array.from({ length: block.right - block.left + 1 }, (_, i) => {
       const letter = colToLetters(block.left + i)
-      return hasHeaders ? raw(block.top, block.left + i) || `Column ${letter}` : `Column ${letter}`
+      const fallback = t('removeDuplicates.columnLetter', { letter })
+      return hasHeaders ? raw(block.top, block.left + i) || fallback : fallback
     }),
   )
 
@@ -98,16 +101,16 @@
   }
 </script>
 
-<SvModal bind:open onClose={onClose} title="Remove Duplicates" size="sm">
-  <div class="sv-sheet-dialog" role="group" aria-label="Remove Duplicates">
-    <p class="lead">To delete duplicate values, select one or more columns that contain duplicates.</p>
+<SvModal bind:open onClose={onClose} title={t('removeDuplicates.title')} size="sm">
+  <div class="sv-sheet-dialog" role="group" aria-label={t('removeDuplicates.title')}>
+    <p class="lead">{t('removeDuplicates.lead')}</p>
     <div class="checks">
-      <button type="button" class="small" onclick={() => (chosen = chosen.map(() => true))}>Select All</button>
-      <button type="button" class="small" onclick={() => (chosen = chosen.map(() => false))}>Unselect All</button>
-      <label class="check"><input type="checkbox" bind:checked={hasHeaders} /> My data has headers</label>
+      <button type="button" class="small" onclick={() => (chosen = chosen.map(() => true))}>{t('removeDuplicates.selectAll')}</button>
+      <button type="button" class="small" onclick={() => (chosen = chosen.map(() => false))}>{t('removeDuplicates.unselectAll')}</button>
+      <label class="check"><input type="checkbox" bind:checked={hasHeaders} /> {t('removeDuplicates.hasHeaders')}</label>
     </div>
     <fieldset class="group">
-      <legend>Columns</legend>
+      <legend>{t('removeDuplicates.columns')}</legend>
       {#each headers as header, i (i)}
         <label class="check"><input type="checkbox" bind:checked={chosen[i]} /> {header}</label>
       {/each}
@@ -115,8 +118,8 @@
   </div>
   {#snippet footer()}
     <div class="sv-sheet-dialog-buttons">
-      <button type="button" class="btn primary" onclick={remove} disabled={!chosen.some(Boolean)}>OK</button>
-      <button type="button" class="btn" onclick={close}>Cancel</button>
+      <button type="button" class="btn primary" onclick={remove} disabled={!chosen.some(Boolean)}>{t('ok')}</button>
+      <button type="button" class="btn" onclick={close}>{t('cancel')}</button>
     </div>
   {/snippet}
 </SvModal>