@svgrid/grid 2.1.22 → 2.2.0

package/src/SvNumberInput.svelte

@@ -1,130 +1,131 @@
-<script lang="ts">
-  /**
-   * SvNumberInput - a numeric input with min/max/step, spinner buttons, optional
-   * thousands grouping + precision, prefix/suffix. Parity: Smart `smart-number-input`.
-   * Emits number | null. The SvGrid number cell editor, standalone too.
-   *
-   * This is the styled renderer over the headless `createNumberInput` core - the
-   * same split as the grid (`createSvGrid` / `<SvGrid>`): parse/format/clamp,
-   * spinner + keyboard and ARIA all come from the core via prop-getters.
-   */
-  import SvRepeatButton from './SvRepeatButton.svelte'
-  import SvField from './SvField.svelte'
-  import { nextEditorId, type SvEditorProps } from './editor-contract'
-  import { createNumberInput } from './createNumberInput.svelte'
-
-  type Props = SvEditorProps & {
-    value?: number | null
-    onChange?: (value: number | null) => void
-    min?: number
-    max?: number
-    step?: number
-    precision?: number
-    /** Group thousands (1,234) on display. */
-    grouping?: boolean
-    prefix?: string
-    suffix?: string
-    placeholder?: string
-    spinButtons?: boolean
-    /** Show a clear (x) button when there is a value. */
-    clearable?: boolean
-  }
-
-  let {
-    value = null,
-    onChange,
-    min = -Infinity,
-    max = Infinity,
-    step = 1,
-    precision,
-    grouping = false,
-    prefix = '',
-    suffix = '',
-    placeholder,
-    disabled = false,
-    readonly = false,
-    spinButtons = true,
-    clearable = false,
-    name,
-    size = 'md',
-    ariaLabel,
-    invalid = false,
-    required = false,
-    error,
-    label,
-    hint,
-    dir,
-    id,
-  }: Props = $props()
-
-  const autoId = nextEditorId('sv-num')
-  const uid = $derived(id ?? autoId)
-
-  const num = createNumberInput({
-    value: () => value,
-    onChange: (v) => onChange?.(v),
-    min: () => min,
-    max: () => max,
-    step: () => step,
-    precision: () => precision,
-    grouping: () => grouping,
-    prefix: () => prefix,
-    suffix: () => suffix,
-    placeholder: () => placeholder,
-    disabled: () => disabled,
-    readonly: () => readonly,
-    id: () => uid,
-    invalid: () => invalid,
-    required: () => required,
-    error: () => error,
-    hint: () => hint,
-    ariaLabel: () => ariaLabel,
-  })
-</script>
-
-<SvField id={uid} {label} {hint} {error} {required} {dir}>
-  <div class="sv-num sv-num--{size}" class:is-disabled={disabled} class:is-invalid={invalid}>
-    <input class="sv-num__input" {...num.inputProps()} />
-    {#if clearable && value != null && !disabled && !readonly}
-      <button type="button" class="sv-num__clear" aria-label="Clear" tabindex="-1" onclick={() => onChange?.(null)}>
-        <svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M6 6l12 12M18 6L6 18" /></svg>
-      </button>
-    {/if}
-    {#if spinButtons}
-      <div class="sv-num__spin">
-        <SvRepeatButton size="sm" variant="ghost" ariaLabel="Increment" onclick={num.increment}>
-          <svg viewBox="0 0 24 24" width="11" height="11" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M6 15l6-6 6 6" /></svg>
-        </SvRepeatButton>
-        <SvRepeatButton size="sm" variant="ghost" ariaLabel="Decrement" onclick={num.decrement}>
-          <svg viewBox="0 0 24 24" width="11" height="11" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M6 9l6 6 6-6" /></svg>
-        </SvRepeatButton>
-      </div>
-    {/if}
-    {#if name}<input type="hidden" {name} value={value ?? ''} />{/if}
-  </div>
-</SvField>
-
-<style>
-  .sv-num {
-    --_accent: var(--sg-accent, #2563eb);
-    display: inline-flex; align-items: stretch; width: 150px;
-    background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
-    border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
-    overflow: hidden;
-  }
-  .sv-num:focus-within { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
-  .sv-num.is-invalid { border-color: var(--sg-danger, #dc2626); }
-  .sv-num.is-invalid:focus-within { box-shadow: 0 0 0 2px color-mix(in srgb, var(--sg-danger, #dc2626) 22%, transparent); }
-  .sv-num.is-disabled { opacity: 0.6; }
-  .sv-num__input {
-    flex: 1; min-width: 0; border: 0; background: none; outline: none; color: inherit; font: inherit;
-    text-align: end; padding: 0 8px;
-  }
-  .sv-num--sm { height: 28px; font-size: 12px; }
-  .sv-num--md { height: 34px; font-size: 13px; }
-  .sv-num--lg { height: 40px; font-size: 15px; }
-  .sv-num__clear { display: grid; place-items: center; width: 22px; align-self: center; flex: none; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; border-radius: 4px; }
-  .sv-num__clear:hover { color: var(--sg-danger, #dc2626); }
-  .sv-num__spin { display: flex; flex-direction: column; border-inline-start: 1px solid var(--sg-border, #e2e8f0); }
-  .sv-num__spin :global(.sv-repeat) { flex: 1; padding: 0 6px; border-radius: 0; }
-</style>
+<script lang="ts">
+  /**
+   * SvNumberInput - a numeric input with min/max/step, spinner buttons, optional
+   * thousands grouping + precision, prefix/suffix. Parity: Smart `smart-number-input`.
+   * Emits number | null. The SvGrid number cell editor, standalone too.
+   *
+   * This is the styled renderer over the headless `createNumberInput` core - the
+   * same split as the grid (`createSvGrid` / `<SvGrid>`): parse/format/clamp,
+   * spinner + keyboard and ARIA all come from the core via prop-getters.
+   */
+  import SvRepeatButton from './SvRepeatButton.svelte'
+  import SvField from './SvField.svelte'
+  import { nextEditorId, type SvEditorProps } from './editor-contract'
+  import { createNumberInput } from './createNumberInput.svelte'
+
+  type Props = SvEditorProps & {
+    value?: number | null
+    onChange?: (value: number | null) => void
+    min?: number
+    max?: number
+    step?: number
+    precision?: number
+    /** Group thousands (1,234) on display. */
+    grouping?: boolean
+    prefix?: string
+    suffix?: string
+    placeholder?: string
+    spinButtons?: boolean
+    /** Show a clear (x) button when there is a value. */
+    clearable?: boolean
+  }
+
+  let {
+    value = $bindable<number | null>(null),
+    onChange,
+    min = -Infinity,
+    max = Infinity,
+    step = 1,
+    precision,
+    grouping = false,
+    prefix = '',
+    suffix = '',
+    placeholder,
+    disabled = false,
+    readonly = false,
+    spinButtons = true,
+    clearable = false,
+    name,
+    size = 'md',
+    ariaLabel,
+    invalid = false,
+    required = false,
+    error,
+    label,
+    hint,
+    dir,
+    id,
+  }: Props = $props()
+
+  const autoId = nextEditorId('sv-num')
+  const uid = $derived(id ?? autoId)
+
+  const num = createNumberInput({
+    value: () => value,
+    // Write `value` (so `bind:value` works) AND fire `onChange` (callback users).
+    onChange: (v) => { value = v; onChange?.(v) },
+    min: () => min,
+    max: () => max,
+    step: () => step,
+    precision: () => precision,
+    grouping: () => grouping,
+    prefix: () => prefix,
+    suffix: () => suffix,
+    placeholder: () => placeholder,
+    disabled: () => disabled,
+    readonly: () => readonly,
+    id: () => uid,
+    invalid: () => invalid,
+    required: () => required,
+    error: () => error,
+    hint: () => hint,
+    ariaLabel: () => ariaLabel,
+  })
+</script>
+
+<SvField id={uid} {label} {hint} {error} {required} {dir}>
+  <div class="sv-num sv-num--{size}" class:is-disabled={disabled} class:is-invalid={invalid}>
+    <input class="sv-num__input" {...num.inputProps()} />
+    {#if clearable && value != null && !disabled && !readonly}
+      <button type="button" class="sv-num__clear" aria-label="Clear" tabindex="-1" onclick={() => { value = null; onChange?.(null) }}>
+        <svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M6 6l12 12M18 6L6 18" /></svg>
+      </button>
+    {/if}
+    {#if spinButtons}
+      <div class="sv-num__spin">
+        <SvRepeatButton size="sm" variant="ghost" ariaLabel="Increment" onclick={num.increment}>
+          <svg viewBox="0 0 24 24" width="11" height="11" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M6 15l6-6 6 6" /></svg>
+        </SvRepeatButton>
+        <SvRepeatButton size="sm" variant="ghost" ariaLabel="Decrement" onclick={num.decrement}>
+          <svg viewBox="0 0 24 24" width="11" height="11" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M6 9l6 6 6-6" /></svg>
+        </SvRepeatButton>
+      </div>
+    {/if}
+    {#if name}<input type="hidden" {name} value={value ?? ''} />{/if}
+  </div>
+</SvField>
+
+<style>
+  .sv-num {
+    --_accent: var(--sg-accent, #2563eb);
+    display: inline-flex; align-items: stretch; width: 150px;
+    background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
+    border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
+    overflow: hidden;
+  }
+  .sv-num:focus-within { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
+  .sv-num.is-invalid { border-color: var(--sg-danger, #dc2626); }
+  .sv-num.is-invalid:focus-within { box-shadow: 0 0 0 2px color-mix(in srgb, var(--sg-danger, #dc2626) 22%, transparent); }
+  .sv-num.is-disabled { opacity: 0.6; }
+  .sv-num__input {
+    flex: 1; min-width: 0; border: 0; background: none; outline: none; color: inherit; font: inherit;
+    text-align: end; padding: 0 8px;
+  }
+  .sv-num--sm { height: 28px; font-size: 12px; }
+  .sv-num--md { height: 34px; font-size: 13px; }
+  .sv-num--lg { height: 40px; font-size: 15px; }
+  .sv-num__clear { display: grid; place-items: center; width: 22px; align-self: center; flex: none; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; border-radius: 4px; }
+  .sv-num__clear:hover { color: var(--sg-danger, #dc2626); }
+  .sv-num__spin { display: flex; flex-direction: column; border-inline-start: 1px solid var(--sg-border, #e2e8f0); }
+  .sv-num__spin :global(.sv-repeat) { flex: 1; padding: 0 6px; border-radius: 0; }
+</style>

package/src/SvOtpInput.svelte

@@ -1,158 +1,158 @@
-<script lang="ts">
-  /**
-   * SvOtpInput - a segmented one-time-code / PIN entry: N single-char cells with
-   * auto-advance, Backspace-to-previous, arrow navigation, and paste that
-   * distributes across the cells. Emits the joined string. Parity: Smart OTP.
-   *
-   * ```svelte
-   * <SvOtpInput length={6} value={code} onChange={(v) => (code = v)}
-   *   onComplete={(v) => verify(v)} />
-   * ```
-   */
-  import SvField from './SvField.svelte'
-  import { nextEditorId, type SvEditorProps } from './editor-contract'
-  import { sanitizeOtp, otpCells, isOtpComplete } from './otp'
-
-  type Props = Pick<
-    SvEditorProps,
-    'disabled' | 'label' | 'hint' | 'error' | 'required' | 'dir' | 'size' | 'id' | 'name' | 'invalid'
-  > & {
-    value?: string
-    onChange?: (value: string) => void
-    /** Fired once every cell is filled. */
-    onComplete?: (value: string) => void
-    length?: number
-    /** Digits only (default) vs any character. */
-    numeric?: boolean
-    /** Mask the characters (password dots). */
-    mask?: boolean
-    autofocus?: boolean
-  }
-
-  let {
-    value = $bindable(''),
-    onChange,
-    onComplete,
-    length = 6,
-    numeric = true,
-    mask = false,
-    disabled = false,
-    label,
-    hint,
-    error,
-    required = false,
-    dir,
-    size = 'md',
-    id,
-    name,
-    invalid = false,
-    autofocus = false,
-  }: Props = $props()
-
-  const autoId = nextEditorId('sv-otp')
-  const uid = $derived(id ?? autoId)
-  const cells = $derived(otpCells(sanitizeOtp(value, length, numeric), length))
-  let inputs = $state<HTMLInputElement[]>([])
-
-  function commit(next: string) {
-    const clean = sanitizeOtp(next, length, numeric)
-    value = clean // enables bind:value
-    onChange?.(clean)
-    if (isOtpComplete(clean, length)) onComplete?.(clean)
-  }
-  function focusCell(i: number) {
-    const el = inputs[Math.max(0, Math.min(length - 1, i))]
-    el?.focus()
-    el?.select()
-  }
-  function currentCells(): string[] {
-    return otpCells(sanitizeOtp(value, length, numeric), length)
-  }
-
-  function onCellInput(i: number, e: Event) {
-    const ch = sanitizeOtp((e.currentTarget as HTMLInputElement).value, 1, numeric).slice(-1)
-    const arr = currentCells()
-    arr[i] = ch
-    commit(arr.join(''))
-    if (ch) focusCell(i + 1)
-  }
-  function onCellKeydown(i: number, e: KeyboardEvent) {
-    const rtl = dir === 'rtl'
-    if (e.key === 'Backspace') {
-      e.preventDefault()
-      const arr = currentCells()
-      if (arr[i]) {
-        arr[i] = ''
-        commit(arr.join(''))
-      } else if (i > 0) {
-        arr[i - 1] = ''
-        commit(arr.join(''))
-        focusCell(i - 1)
-      }
-    } else if (e.key === 'ArrowLeft') {
-      e.preventDefault()
-      focusCell(rtl ? i + 1 : i - 1)
-    } else if (e.key === 'ArrowRight') {
-      e.preventDefault()
-      focusCell(rtl ? i - 1 : i + 1)
-    }
-  }
-  function onPaste(i: number, e: ClipboardEvent) {
-    e.preventDefault()
-    const text = e.clipboardData?.getData('text') ?? ''
-    const arr = currentCells()
-    const pasted = sanitizeOtp(text, length - i, numeric)
-    for (let k = 0; k < pasted.length; k++) arr[i + k] = pasted[k]!
-    const joined = arr.join('')
-    commit(joined)
-    focusCell(Math.min(i + pasted.length, length - 1))
-  }
-  function mountFocus(node: HTMLInputElement, i: number) {
-    if (autofocus && i === 0) node.focus()
-  }
-</script>
-
-<SvField id={uid} {label} {hint} {error} {required} {dir}>
-  <div
-    class="sv-otp sv-otp--{size}"
-    class:is-disabled={disabled}
-    class:is-invalid={invalid}
-    role="group"
-    aria-label={label ?? 'One-time code'}
-  >
-    {#each cells as cell, i (i)}
-      <input
-        bind:this={inputs[i]}
-        use:mountFocus={i}
-        class="sv-otp__cell"
-        type={mask ? 'password' : 'text'}
-        inputmode={numeric ? 'numeric' : 'text'}
-        autocomplete={i === 0 ? 'one-time-code' : 'off'}
-        maxlength="1"
-        value={cell}
-        {disabled}
-        aria-label={`Character ${i + 1} of ${length}`}
-        oninput={(e) => onCellInput(i, e)}
-        onkeydown={(e) => onCellKeydown(i, e)}
-        onpaste={(e) => onPaste(i, e)}
-        onfocus={(e) => (e.currentTarget as HTMLInputElement).select()}
-      />
-    {/each}
-    {#if name}<input type="hidden" {name} value={value} />{/if}
-  </div>
-</SvField>
-
-<style>
-  .sv-otp { --_accent: var(--sg-accent, #2563eb); display: inline-flex; gap: 8px; }
-  .sv-otp.is-disabled { opacity: 0.6; }
-  .sv-otp__cell {
-    width: 40px; height: 46px; text-align: center; font: inherit; font-weight: 650; font-size: 18px;
-    background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
-    border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
-    outline: none; caret-color: var(--_accent);
-  }
-  .sv-otp--sm .sv-otp__cell { width: 34px; height: 40px; font-size: 16px; }
-  .sv-otp--lg .sv-otp__cell { width: 46px; height: 54px; font-size: 20px; }
-  .sv-otp__cell:focus { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
-  .sv-otp.is-invalid .sv-otp__cell { border-color: var(--sg-danger, #dc2626); }
-</style>
+<script lang="ts">
+  /**
+   * SvOtpInput - a segmented one-time-code / PIN entry: N single-char cells with
+   * auto-advance, Backspace-to-previous, arrow navigation, and paste that
+   * distributes across the cells. Emits the joined string. Parity: Smart OTP.
+   *
+   * ```svelte
+   * <SvOtpInput length={6} value={code} onChange={(v) => (code = v)}
+   *   onComplete={(v) => verify(v)} />
+   * ```
+   */
+  import SvField from './SvField.svelte'
+  import { nextEditorId, type SvEditorProps } from './editor-contract'
+  import { sanitizeOtp, otpCells, isOtpComplete } from './otp'
+
+  type Props = Pick<
+    SvEditorProps,
+    'disabled' | 'label' | 'hint' | 'error' | 'required' | 'dir' | 'size' | 'id' | 'name' | 'invalid'
+  > & {
+    value?: string
+    onChange?: (value: string) => void
+    /** Fired once every cell is filled. */
+    onComplete?: (value: string) => void
+    length?: number
+    /** Digits only (default) vs any character. */
+    numeric?: boolean
+    /** Mask the characters (password dots). */
+    mask?: boolean
+    autofocus?: boolean
+  }
+
+  let {
+    value = $bindable(''),
+    onChange,
+    onComplete,
+    length = 6,
+    numeric = true,
+    mask = false,
+    disabled = false,
+    label,
+    hint,
+    error,
+    required = false,
+    dir,
+    size = 'md',
+    id,
+    name,
+    invalid = false,
+    autofocus = false,
+  }: Props = $props()
+
+  const autoId = nextEditorId('sv-otp')
+  const uid = $derived(id ?? autoId)
+  const cells = $derived(otpCells(sanitizeOtp(value, length, numeric), length))
+  let inputs = $state<HTMLInputElement[]>([])
+
+  function commit(next: string) {
+    const clean = sanitizeOtp(next, length, numeric)
+    value = clean // enables bind:value
+    onChange?.(clean)
+    if (isOtpComplete(clean, length)) onComplete?.(clean)
+  }
+  function focusCell(i: number) {
+    const el = inputs[Math.max(0, Math.min(length - 1, i))]
+    el?.focus()
+    el?.select()
+  }
+  function currentCells(): string[] {
+    return otpCells(sanitizeOtp(value, length, numeric), length)
+  }
+
+  function onCellInput(i: number, e: Event) {
+    const ch = sanitizeOtp((e.currentTarget as HTMLInputElement).value, 1, numeric).slice(-1)
+    const arr = currentCells()
+    arr[i] = ch
+    commit(arr.join(''))
+    if (ch) focusCell(i + 1)
+  }
+  function onCellKeydown(i: number, e: KeyboardEvent) {
+    const rtl = dir === 'rtl'
+    if (e.key === 'Backspace') {
+      e.preventDefault()
+      const arr = currentCells()
+      if (arr[i]) {
+        arr[i] = ''
+        commit(arr.join(''))
+      } else if (i > 0) {
+        arr[i - 1] = ''
+        commit(arr.join(''))
+        focusCell(i - 1)
+      }
+    } else if (e.key === 'ArrowLeft') {
+      e.preventDefault()
+      focusCell(rtl ? i + 1 : i - 1)
+    } else if (e.key === 'ArrowRight') {
+      e.preventDefault()
+      focusCell(rtl ? i - 1 : i + 1)
+    }
+  }
+  function onPaste(i: number, e: ClipboardEvent) {
+    e.preventDefault()
+    const text = e.clipboardData?.getData('text') ?? ''
+    const arr = currentCells()
+    const pasted = sanitizeOtp(text, length - i, numeric)
+    for (let k = 0; k < pasted.length; k++) arr[i + k] = pasted[k]!
+    const joined = arr.join('')
+    commit(joined)
+    focusCell(Math.min(i + pasted.length, length - 1))
+  }
+  function mountFocus(node: HTMLInputElement, i: number) {
+    if (autofocus && i === 0) node.focus()
+  }
+</script>
+
+<SvField id={uid} {label} {hint} {error} {required} {dir}>
+  <div
+    class="sv-otp sv-otp--{size}"
+    class:is-disabled={disabled}
+    class:is-invalid={invalid}
+    role="group"
+    aria-label={label ?? 'One-time code'}
+  >
+    {#each cells as cell, i (i)}
+      <input
+        bind:this={inputs[i]}
+        use:mountFocus={i}
+        class="sv-otp__cell"
+        type={mask ? 'password' : 'text'}
+        inputmode={numeric ? 'numeric' : 'text'}
+        autocomplete={i === 0 ? 'one-time-code' : 'off'}
+        maxlength="1"
+        value={cell}
+        {disabled}
+        aria-label={`Character ${i + 1} of ${length}`}
+        oninput={(e) => onCellInput(i, e)}
+        onkeydown={(e) => onCellKeydown(i, e)}
+        onpaste={(e) => onPaste(i, e)}
+        onfocus={(e) => (e.currentTarget as HTMLInputElement).select()}
+      />
+    {/each}
+    {#if name}<input type="hidden" {name} value={value} />{/if}
+  </div>
+</SvField>
+
+<style>
+  .sv-otp { --_accent: var(--sg-accent, #2563eb); display: inline-flex; gap: 8px; }
+  .sv-otp.is-disabled { opacity: 0.6; }
+  .sv-otp__cell {
+    width: 40px; height: 46px; text-align: center; font: inherit; font-weight: 650; font-size: 18px;
+    background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
+    border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
+    outline: none; caret-color: var(--_accent);
+  }
+  .sv-otp--sm .sv-otp__cell { width: 34px; height: 40px; font-size: 16px; }
+  .sv-otp--lg .sv-otp__cell { width: 46px; height: 54px; font-size: 20px; }
+  .sv-otp__cell:focus { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
+  .sv-otp.is-invalid .sv-otp__cell { border-color: var(--sg-danger, #dc2626); }
+</style>

package/src/SvPagination.svelte

@@ -9,7 +9,7 @@
    * <SvPagination page={p} pageCount={20} onChange={(n) => (p = n)} />
    * ```
    */
-  import { paginationRange } from './paginate'
+  import { createPagination } from './createPagination'
 
   type Props = {
     /** 1-based current page. */
@@ -38,23 +38,26 @@
     ariaLabel = 'Pagination',
   }: Props = $props()
 
-  const items = $derived(paginationRange({ page, pageCount, siblingCount, boundaryCount }))
-  const go = (p: number) => {
-    if (disabled) return
-    const next = Math.min(Math.max(p, 1), pageCount)
-    if (next !== page) onChange?.(next)
-  }
+  // Page-range math + navigation live in the shared headless core.
+  const pg = createPagination({
+    page: () => page,
+    pageCount: () => pageCount,
+    onChange,
+    siblingCount: () => siblingCount,
+    boundaryCount: () => boundaryCount,
+    disabled: () => disabled,
+  })
 </script>
 
-<nav class="sv-pg sv-pg--{size}" aria-label={ariaLabel}>
+<nav class="sv-pg sv-pg--{size}" {...pg.navProps(ariaLabel)}>
   <ul class="sv-pg__list">
     {#if showFirstLast}
-      <li><button type="button" class="sv-pg__btn" aria-label="First page" onclick={() => go(1)} disabled={disabled || page <= 1}>&laquo;</button></li>
+      <li><button type="button" class="sv-pg__btn" {...pg.firstProps()}>&laquo;</button></li>
     {/if}
     {#if showPrevNext}
-      <li><button type="button" class="sv-pg__btn" aria-label="Previous page" onclick={() => go(page - 1)} disabled={disabled || page <= 1}>&lsaquo;</button></li>
+      <li><button type="button" class="sv-pg__btn" {...pg.prevProps()}>&lsaquo;</button></li>
     {/if}
-    {#each items as it, i (typeof it === 'number' ? `p${it}` : `${it}-${i}`)}
+    {#each pg.items as it, i (typeof it === 'number' ? `p${it}` : `${it}-${i}`)}
       {#if it === 'ellipsis-left' || it === 'ellipsis-right'}
         <li><span class="sv-pg__ellipsis" aria-hidden="true">&hellip;</span></li>
       {:else}
@@ -62,20 +65,17 @@
           <button
             type="button"
             class="sv-pg__btn"
-            class:is-active={it === page}
-            aria-current={it === page ? 'page' : undefined}
-            aria-label={`Page ${it}`}
-            {disabled}
-            onclick={() => go(it)}
+            class:is-active={pg.isActive(it)}
+            {...pg.pageButtonProps(it)}
           >{it}</button>
         </li>
       {/if}
     {/each}
     {#if showPrevNext}
-      <li><button type="button" class="sv-pg__btn" aria-label="Next page" onclick={() => go(page + 1)} disabled={disabled || page >= pageCount}>&rsaquo;</button></li>
+      <li><button type="button" class="sv-pg__btn" {...pg.nextProps()}>&rsaquo;</button></li>
     {/if}
     {#if showFirstLast}
-      <li><button type="button" class="sv-pg__btn" aria-label="Last page" onclick={() => go(pageCount)} disabled={disabled || page >= pageCount}>&raquo;</button></li>
+      <li><button type="button" class="sv-pg__btn" {...pg.lastProps()}>&raquo;</button></li>
     {/if}
   </ul>
 </nav>