@svgrid/enterprise 1.0.1 → 1.2.0

package/src/ai.test.ts

@@ -70,7 +70,7 @@ beforeEach(() => {
   // Default to a licensed state so the soft-gate doesn't dump noise on the
   // console during expected-failure tests. Individual cases clear it when
   // they want to assert soft-gate behaviour.
-  setLicenseKey('SVPRO-DEV-TEST')
+  setLicenseKey('SVENTERPRISE-DEV-TEST')
 })
 afterEach(() => {
   setAIProvider(null)

package/src/ai.ts

@@ -20,13 +20,13 @@
  * `AIProvider` that knows how to call OpenAI / Anthropic / a local
  * model / a server-side proxy. We never bundle a model client.
  *
- * License gate: every AI call routes through `assertProLicensed()`,
+ * License gate: every AI call routes through `assertEnterpriseLicensed()`,
  * which soft-gates (still works, adds a watermark, console nudge) when
  * no key is set so demos and evaluation stay frictionless.
  */
 
 import type { RowData, SvGridApi, TableFeatures } from '@svgrid/grid'
-import { assertProLicensed } from './license'
+import { assertEnterpriseLicensed } from './license'
 
 // ---------------------------------------------------------------------------
 // Provider contract
@@ -230,7 +230,7 @@ export async function aiFilter<
   query: string,
   opts: AIFilterOptions = {},
 ): Promise<AIFilterResult> {
-  assertProLicensed('AI assistant')
+  assertEnterpriseLicensed('AI assistant')
   const schema = buildColumnSchema(api)
   const prompt =
     `You are a data-grid filter planner. Translate the user's natural-language ` +
@@ -317,7 +317,7 @@ export async function aiSmartFill<
   api: SvGridApi<TFeatures, TData>,
   opts: AISmartFillOptions,
 ): Promise<AISmartFillResult<TValue>> {
-  assertProLicensed('AI assistant')
+  assertEnterpriseLicensed('AI assistant')
   if (opts.examples.length === 0) {
     throw new Error('@svgrid/enterprise/ai: aiSmartFill requires at least one example.')
   }
@@ -408,7 +408,7 @@ export async function aiSummarize<
   api: SvGridApi<TFeatures, TData>,
   opts: AISummarizeOptions,
 ): Promise<AISummary> {
-  assertProLicensed('AI assistant')
+  assertEnterpriseLicensed('AI assistant')
   const all = api.getData()
   const rows: TData[] = (() => {
     const t = opts.target
@@ -497,7 +497,7 @@ export async function aiClassify<
   api: SvGridApi<TFeatures, TData>,
   opts: AIClassifyOptions,
 ): Promise<AIClassifyResult> {
-  assertProLicensed('AI assistant')
+  assertEnterpriseLicensed('AI assistant')
   const data = api.getData()
   const targets = opts.targetRowIndices ?? data.map((_, i) => i)
   const rubric = opts.classDescriptions

package/src/export.ts

@@ -1,7 +1,7 @@
 /// <reference path="./pdfmake-shims.d.ts" />
 import type { RowData, TableFeatures } from '@svgrid/grid'
 import type { SvGridApi } from '@svgrid/grid'
-import { assertProLicensed } from './license'
+import { assertEnterpriseLicensed } from './license'
 import { installSmartShim, type SmartDataExporterInstance } from './smart-shim'
 
 export type ExportFormat = 'xlsx' | 'pdf' | 'csv' | 'tsv' | 'html'
@@ -126,6 +126,30 @@ export type ExportOptions<TData> = {
    * Mutually exclusive with `groupBy`. xlsx only.
    */
   hierarchical?: boolean
+  /**
+   * Merged cells to write into the sheet (xlsx / pdf). Each entry spans
+   * `colSpan` columns and `rowSpan` rows starting at the given zero-based
+   * **body** row / column index (the header row is not counted). Mirrors the
+   * grid's own `MergeSpec` shape closely, so grid merges map straight through -
+   * convert a `MergeSpec` (`{ rowIndex, columnId, rowspan, colspan }`) by
+   * resolving `columnId` to its column index. Mutually exclusive with
+   * `groupBy` / `hierarchical`.
+   */
+  merges?: ReadonlyArray<ExportMerge>
+}
+
+/**
+ * A merged cell region for {@link ExportOptions.merges}. `row` / `col` are
+ * zero-based indices into the exported body (header excluded). A cell that
+ * spans two columns to the right is `{ row, col, colSpan: 2 }`.
+ */
+export type ExportMerge = {
+  row: number
+  col: number
+  /** Columns to span (default 1). */
+  colSpan?: number
+  /** Rows to span (default 1). */
+  rowSpan?: number
 }
 
 let exporterCtorPromise: Promise<
@@ -398,6 +422,19 @@ function buildExporterOptions<TData>(
   // hierarchical through here and groupBy through the constructor call
   // site in exportGrid.
   if (opts.hierarchical) out.hierarchical = true
+  // Merged cells: translate the friendly {row, col, rowSpan, colSpan} shape to
+  // Smart's native {cell: [row, col], rowspan, colspan}. Skip 1x1 "merges"
+  // (nothing to span). Ignored when grouping/hierarchy owns the row layout.
+  if (opts.merges?.length && !opts.groupBy?.length && !opts.hierarchical) {
+    const mergedCells = opts.merges
+      .map((m) => ({
+        cell: [m.row, m.col],
+        rowspan: Math.max(1, Math.floor(m.rowSpan ?? 1)),
+        colspan: Math.max(1, Math.floor(m.colSpan ?? 1)),
+      }))
+      .filter((m) => m.rowspan > 1 || m.colspan > 1)
+    if (mergedCells.length) out.mergedCells = mergedCells
+  }
   return out
 }
 
@@ -432,7 +469,7 @@ export async function exportGrid<
   TFeatures extends TableFeatures,
   TData extends RowData,
 >(api: SvGridApi<TFeatures, TData>, opts: ExportOptions<TData>): Promise<void> {
-  assertProLicensed('Export')
+  assertEnterpriseLicensed('Export')
   await ensureGlobals(opts.format)
   const Ctor = await getDataExporter()
 

package/src/import.test.ts

@@ -43,7 +43,7 @@ function fakeApi() {
 }
 
 beforeEach(() => {
-  setLicenseKey('SVPRO-DEV-TEST')
+  setLicenseKey('SVENTERPRISE-DEV-TEST')
 })
 afterEach(() => {
   clearLicenseKey()

package/src/import.ts

@@ -25,7 +25,7 @@
  */
 
 import type { RowData, SvGridApi, TableFeatures } from '@svgrid/grid'
-import { assertProLicensed } from './license'
+import { assertEnterpriseLicensed } from './license'
 
 // ---------------------------------------------------------------------------
 // Public types
@@ -557,7 +557,7 @@ export async function importData<
   api: SvGridApi<TFeatures, TData>,
   opts: ImportOptions<TData>,
 ): Promise<ImportResult<TData>> {
-  assertProLicensed('Import')
+  assertEnterpriseLicensed('Import')
   const format = sniffFormat(opts.file, opts.format ?? 'auto')
 
   let matrix: string[][]

package/src/index.ts

@@ -4,7 +4,7 @@ export {
   getLicenseKey,
   isLicenseKeySet,
   hasValidLicense,
-  assertProLicensed,
+  assertEnterpriseLicensed,
 } from './license'
 
 export {
@@ -29,7 +29,7 @@ export {
   type ImportRowError,
   type ImportValidator,
 } from './import'
-export { installPro, type ProGridApi, type ProAIApi, type ProPivotApi } from './install'
+export { installEnterprise, type EnterpriseGridApi, type EnterpriseAIApi, type EnterprisePivotApi } from './install'
 export {
   createStagedEditing,
   type StagedChange,
@@ -40,7 +40,7 @@ export { dismissUnlicensedNudge } from './watermark'
 export {
   showUpgradePrompt,
   dismissUpgradePrompt,
-  type ProFeatureLabel,
+  type EnterpriseFeatureLabel,
 } from './upgrade-prompt'
 
 export {
@@ -56,6 +56,20 @@ export {
   type PivotValueConfig,
 } from './pivot'
 
+export { default as SvPivotDesigner } from './SvPivotDesigner.svelte'
+export {
+  ALL_AGGREGATORS,
+  AGG_LABEL,
+  EMPTY_LAYOUT,
+  defaultLayoutFor,
+  type PivotField,
+  type PivotValueChip,
+  type PivotFilterChip,
+  type PivotLayout,
+  type PivotPreset,
+  type Well,
+} from './pivot-designer'
+
 export {
   // Provider plumbing
   setAIProvider,

package/src/install.ts

@@ -17,7 +17,7 @@ import {
   type PivotResult,
 } from './pivot'
 
-export type ProAIApi<TData extends RowData> = {
+export type EnterpriseAIApi<TData extends RowData> = {
   /** Natural-language -> filter + sort plan (and optionally apply it). */
   filter(query: string, opts?: AIFilterOptions): Promise<AIFilterResult>
   /** Propose values for empty cells based on a few worked examples. */
@@ -32,7 +32,7 @@ export type ProAIApi<TData extends RowData> = {
   readonly _rowType?: TData
 }
 
-export type ProPivotApi<
+export type EnterprisePivotApi<
   TFeatures extends TableFeatures,
   TData extends RowData,
 > = {
@@ -54,7 +54,7 @@ export type ProPivotApi<
   ): PivotResult<TFeatures>
 }
 
-export type ProGridApi<
+export type EnterpriseGridApi<
   TFeatures extends TableFeatures,
   TData extends RowData,
 > = SvGridApi<TFeatures, TData> & {
@@ -68,10 +68,10 @@ export type ProGridApi<
   importData(opts: ImportOptions<TData>): Promise<ImportResult<TData>>
   /** AI helpers (Pro). All calls route through a consumer-registered
    *  AIProvider via setAIProvider(); no model client is bundled. */
-  ai: ProAIApi<TData>
+  ai: EnterpriseAIApi<TData>
   /** Pivot table builder (Pro). Pure - returns `{ rows, columns }` you
    *  hand to a separate `<SvGrid>` instance. */
-  pivot: ProPivotApi<TFeatures, TData>
+  pivot: EnterprisePivotApi<TFeatures, TData>
 }
 
 /**
@@ -84,11 +84,11 @@ export type ProGridApi<
  * the console emits a one-time nudge. Revoked or malformed keys throw on
  * first call.
  */
-export function installPro<
+export function installEnterprise<
   TFeatures extends TableFeatures,
   TData extends RowData,
->(api: SvGridApi<TFeatures, TData>): ProGridApi<TFeatures, TData> {
-  const pro = api as ProGridApi<TFeatures, TData>
+>(api: SvGridApi<TFeatures, TData>): EnterpriseGridApi<TFeatures, TData> {
+  const pro = api as EnterpriseGridApi<TFeatures, TData>
   pro.exportData = (opts) => exportGrid(pro, opts)
   pro.print = (opts) => printGrid(pro, opts)
   pro.importData = (opts) => importData(pro, opts)

package/src/license.ts

@@ -8,17 +8,17 @@
 //   ────────────────────────────────────────────────────────────────────
 //   null (no key set)                 -> soft-gate: watermark + console.log,
 //                                        feature still runs
-//   does not start with "SVPRO-"      -> throws (programmer error)
+//   does not start with "SVENTERPRISE-"      -> throws (programmer error)
 //   in REVOKED_KEYS                   -> throws (revoked / leaked / expired)
-//   starts with "SVPRO-DEV" or
-//     "SVPRO-EVAL"                    -> works; one-time console.info notice
-//   any other "SVPRO-..."             -> works silently (paid production)
+//   starts with "SVENTERPRISE-DEV" or
+//     "SVENTERPRISE-EVAL"                    -> works; one-time console.info notice
+//   any other "SVENTERPRISE-..."             -> works silently (paid production)
 
 import { REVOKED_KEYS } from './revoked'
 import { emitUnlicensedNudge } from './watermark'
-import { showUpgradePrompt, type ProFeatureLabel } from './upgrade-prompt'
+import { showUpgradePrompt, type EnterpriseFeatureLabel } from './upgrade-prompt'
 
-const VALID_PREFIX = 'SVPRO-'
+const VALID_PREFIX = 'SVENTERPRISE-'
 let currentKey: string | null = null
 let noticedDev = false
 
@@ -56,7 +56,7 @@ export function hasValidLicense(): boolean {
   return true
 }
 
-export function assertProLicensed(feature?: ProFeatureLabel): void {
+export function assertEnterpriseLicensed(feature?: EnterpriseFeatureLabel): void {
   if (currentKey == null) {
     // Soft-gate: the feature still runs, but the user gets a watermark +
     // a one-time console.log nudge directing them to pricing, plus a
@@ -68,7 +68,7 @@ export function assertProLicensed(feature?: ProFeatureLabel): void {
   }
   if (!currentKey.startsWith(VALID_PREFIX)) {
     throw new Error(
-      '@svgrid/enterprise: invalid license key format (expected "SVPRO-..." prefix).',
+      '@svgrid/enterprise: invalid license key format (expected "SVENTERPRISE-..." prefix).',
     )
   }
   if (REVOKED_KEYS.has(currentKey)) {
@@ -79,7 +79,7 @@ export function assertProLicensed(feature?: ProFeatureLabel): void {
   }
   if (
     !noticedDev &&
-    (currentKey.startsWith('SVPRO-DEV') || currentKey.startsWith('SVPRO-EVAL'))
+    (currentKey.startsWith('SVENTERPRISE-DEV') || currentKey.startsWith('SVENTERPRISE-EVAL'))
   ) {
     // eslint-disable-next-line no-console
     console.info(

package/src/pivot-designer.ts

@@ -0,0 +1,101 @@
+/**
+ * Types + helpers for the SvPivotDesigner component.
+ *
+ * Why a separate module: the component file (.svelte) imports these,
+ * and so do consumers wiring up custom presets, formatters, or wells.
+ * Keeping the pure-TS surface here also lets us unit-test the layout
+ * normalisation + serialisation without instantiating the component.
+ */
+
+import type { CellFormatConfig } from '@svgrid/grid'
+import type { PivotAggregatorId } from './pivot'
+
+/** One field the designer offers in its left-rail picker.
+ *  Dimensions land in Rows by default; measures land in Values. */
+export type PivotField<T extends Record<string, unknown> = Record<string, unknown>> = {
+  field: keyof T & string
+  /** Display name shown in the picker + on chips. */
+  label: string
+  /** Default well: 'dimension' -> Rows, 'measure' -> Values. */
+  kind: 'dimension' | 'measure'
+  /** Optional group name for the field picker (e.g. 'Demographics'). */
+  group?: string
+  /** Optional formatter applied to value-well chips by default. */
+  format?: CellFormatConfig
+  /** Optional default aggregator when added to Values (default 'sum'). */
+  defaultAgg?: PivotAggregatorId
+}
+
+/** A single chip in the Values well. */
+export type PivotValueChip = {
+  field: string
+  agg: PivotAggregatorId
+  label?: string
+  format?: CellFormatConfig
+}
+
+/** A single chip in the Filters well. `allowed === null` => all values pass. */
+export type PivotFilterChip = {
+  field: string
+  /** Distinct values that pass the filter. `null` means no restriction. */
+  allowed: string[] | null
+}
+
+/** The full pivot layout. The designer is a controlled component that
+ *  reads + writes this single shape via `bind:layout`. */
+export type PivotLayout = {
+  rows: string[]
+  cols: string[]
+  values: PivotValueChip[]
+  filters: PivotFilterChip[]
+  /** Hide subtotal rows between groups. Default false. */
+  hideSubtotals?: boolean
+  /** Hide grand-total row + column. Default false. */
+  hideGrandTotals?: boolean
+}
+
+/** A saved layout the user can pick from the toolbar's preset menu. */
+export type PivotPreset = {
+  name: string
+  layout: PivotLayout
+}
+
+/** A built-in aggregator option. Consumers can pass a subset to
+ *  `aggregators` to restrict the chip menu (e.g. 'count' only). */
+export const ALL_AGGREGATORS: PivotAggregatorId[] = [
+  'sum', 'avg', 'min', 'max', 'count', 'countDistinct', 'first', 'last',
+]
+
+/** Empty layout used by Reset + the initial state. */
+export const EMPTY_LAYOUT: PivotLayout = {
+  rows: [], cols: [], values: [], filters: [],
+}
+
+/** Build an initial layout from a field list - useful when the
+ *  consumer just wants "throw the first dimension in Rows + first
+ *  measure in Values" defaults. */
+export function defaultLayoutFor<T extends Record<string, unknown>>(
+  fields: ReadonlyArray<PivotField<T>>,
+): PivotLayout {
+  const dim = fields.find((f) => f.kind === 'dimension')
+  const meas = fields.find((f) => f.kind === 'measure')
+  return {
+    rows: dim ? [dim.field] : [],
+    cols: [],
+    values: meas
+      ? [{ field: meas.field, agg: meas.defaultAgg ?? 'sum', label: meas.label, format: meas.format }]
+      : [],
+    filters: [],
+  }
+}
+
+/** Move / add / remove a chip across the four wells. The well names
+ *  match the layout shape. */
+export type Well = 'rows' | 'cols' | 'values' | 'filters'
+
+/** Pretty label for an aggregator id. */
+export const AGG_LABEL: Record<PivotAggregatorId, string> = {
+  sum: 'Sum', avg: 'Average', min: 'Min', max: 'Max',
+  count: 'Count', countDistinct: 'Distinct count',
+  first: 'First', last: 'Last',
+}

package/src/pivot.test.ts

@@ -7,6 +7,7 @@ import {
   createPivotModel,
   filterCollapsedPivotRows,
   pivotAggregators,
+  type PivotConfig,
   type PivotRow,
 } from './pivot'
 
@@ -162,15 +163,42 @@ describe('createPivotModel - configuration toggles', () => {
     expect(r.rows.find((row) => row.__pivotKind === 'grandTotal')).toBeUndefined()
   })
 
-  it('omits row subtotals when rowSubtotals=false', () => {
+  it('keeps group headers but blanks their values when rowSubtotals=false', () => {
     const r = createPivotModel(facts, {
       rows: ['region', 'salesPerson'],
       cols: ['quarter'],
       values: [{ field: 'amount', agg: 'sum' }],
       rowSubtotals: false,
     })
-    // Only leaves + grand total - no `group` rows.
-    expect(r.rows.filter((row) => row.__pivotKind === 'group')).toEqual([])
+    // Group header rows are STILL emitted - the grouping hierarchy is
+    // preserved; turning off subtotals never removes a grouping level.
+    const groups = r.rows.filter((row) => row.__pivotKind === 'group')
+    expect(groups.length).toBeGreaterThan(0)
+    expect(groups.map((row) => row.__pivotLabel)).toContain('AMER')
+    // ...but each header carries no aggregate values: the value cells are
+    // present (so columns line up) and explicitly null.
+    for (const g of groups) {
+      const valueKeys = Object.keys(g).filter((k) => !k.startsWith('__pivot'))
+      expect(valueKeys.length).toBeGreaterThan(0)
+      expect(valueKeys.every((k) => (g as Record<string, unknown>)[k] === null)).toBe(true)
+    }
+  })
+
+  it('keeps the grand-total value identical whether or not subtotals show', () => {
+    const base: PivotConfig<Sale> = {
+      rows: ['region', 'salesPerson'],
+      cols: ['quarter'],
+      values: [{ field: 'amount', agg: 'sum' }],
+    }
+    const withSub = createPivotModel(facts, { ...base, rowSubtotals: true })
+    const noSub = createPivotModel(facts, { ...base, rowSubtotals: false })
+    const totalValues = (m: typeof withSub) => {
+      const g = m.rows.find((row) => row.__pivotKind === 'grandTotal')!
+      return Object.fromEntries(
+        Object.entries(g).filter(([k]) => !k.startsWith('__pivot')),
+      )
+    }
+    expect(totalValues(noSub)).toEqual(totalValues(withSub))
   })
 
   it('honours a custom rowSort comparator', () => {

package/src/pivot.ts

@@ -238,7 +238,7 @@ function buildColumnTree<TFeatures extends TableFeatures>(
   const headerCol: ColumnDef<TFeatures, PivotRow> = {
     id: '__pivotRowHeader',
     header: rowHeaderLabel,
-    accessorFn: (row) => row.__pivotLabel,
+    fieldFn: (row) => row.__pivotLabel,
     width: 240,
   }
 
@@ -252,7 +252,7 @@ function buildColumnTree<TFeatures extends TableFeatures>(
         return {
           id,
           header: label,
-          accessorFn: (row) => row[id],
+          fieldFn: (row) => row[id],
           format: value.format,
           width: 130,
         } as ColumnDef<TFeatures, PivotRow>
@@ -283,7 +283,7 @@ function buildColumnTree<TFeatures extends TableFeatures>(
     return {
       id,
       header: label,
-      accessorFn: (row) => row[id],
+      fieldFn: (row) => row[id],
       format: value.format,
       width: 140,
     } as ColumnDef<TFeatures, PivotRow>
@@ -349,6 +349,28 @@ function computeRowValues(
   return result
 }
 
+/**
+ * Build the same value-column keys as `computeRowValues`, but with every cell
+ * `null`. Used for group HEADER rows when `rowSubtotals` is off: the row keeps
+ * its place in the hierarchy (label + expand/collapse) yet shows no aggregate
+ * numbers. Cells are `null` rather than absent so consumers can distinguish a
+ * deliberately-blank subtotal from a missing column.
+ */
+function blankRowValues(
+  colLeafPaths: ReadonlyArray<ReadonlyArray<unknown>>,
+  values: ReadonlyArray<PivotValueConfig<unknown>>,
+  includeGrandTotalCol: boolean,
+): Record<string, null> {
+  const result: Record<string, null> = {}
+  for (const colPath of colLeafPaths) {
+    for (let i = 0; i < values.length; i += 1) result[leafColumnId(colPath, i)] = null
+  }
+  if (includeGrandTotalCol) {
+    for (let i = 0; i < values.length; i += 1) result[leafColumnId(['__total'], i)] = null
+  }
+  return result
+}
+
 function walkRowTree(
   node: AxisNode,
   out: PivotRow[],
@@ -387,11 +409,16 @@ function walkRowTree(
     return
   }
 
-  // Group node. Emit a subtotal-style row IF requested AND this node has
-  // a real path (not the synthetic root) AND it's not at the deepest level.
+  // Group node. Emit the group HEADER row whenever this node is a real group
+  // (not the synthetic root, not the deepest level). The header is emitted
+  // regardless of `rowSubtotals` so the grouping hierarchy and the
+  // expand/collapse parent chain stay intact; the flag only controls whether
+  // the header carries its aggregate (subtotal) values or renders as a
+  // label-only row. This matches Excel / AG Grid, where hiding subtotals never
+  // removes a grouping level from the row axis.
   const isRealGroup = node.level > 0 && node.level < rowFields.length
   let nextParentId: string | null = parentId
-  if (isRealGroup && wantSubtotals) {
+  if (isRealGroup) {
     const id = `group__${node.pathKey}`
     out.push({
       __pivotId: id,
@@ -400,13 +427,15 @@ function walkRowTree(
       __pivotLabel: String(node.value ?? '(All)'),
       __pivotParentId: parentId,
       __pivotExpandable: true,
-      ...computeRowValues(
-        node.rows as ReadonlyArray<Record<string, unknown>>,
-        colLeafPaths,
-        colFields,
-        values,
-        includeGrandTotalCol,
-      ),
+      ...(wantSubtotals
+        ? computeRowValues(
+            node.rows as ReadonlyArray<Record<string, unknown>>,
+            colLeafPaths,
+            colFields,
+            values,
+            includeGrandTotalCol,
+          )
+        : blankRowValues(colLeafPaths, values, includeGrandTotalCol)),
     })
     // Children of this group point at this row as their parent so a
     // collapse hides the whole subtree, not just the immediate leaves.

package/src/print.ts

@@ -1,5 +1,5 @@
 import type { RowData, TableFeatures, SvGridApi } from '@svgrid/grid'
-import { assertProLicensed } from './license'
+import { assertEnterpriseLicensed } from './license'
 import { installSmartShim } from './smart-shim'
 import type { ExportColumn } from './export'
 
@@ -51,7 +51,7 @@ export async function printGrid<
   TFeatures extends TableFeatures,
   TData extends RowData,
 >(api: SvGridApi<TFeatures, TData>, opts?: PrintOptions<TData>): Promise<void> {
-  assertProLicensed('Print')
+  assertEnterpriseLicensed('Print')
   const sourceRows: ReadonlyArray<TData> = opts?.rows ?? api.getDisplayedRows()
   let cols: ReadonlyArray<ExportColumn>
   if (opts?.columns && opts.columns.length > 0) {

package/src/revoked.ts

@@ -1,5 +1,5 @@
 // Revoked license keys. A key in this set throws on use even if it has the
-// valid SVPRO- prefix. Use this to invalidate keys that have been leaked,
+// valid SVENTERPRISE- prefix. Use this to invalidate keys that have been leaked,
 // shared outside their seat count, or issued for trials that have expired.
 //
 // =============================================================================
@@ -44,6 +44,6 @@
 // =============================================================================
 
 export const REVOKED_KEYS: ReadonlySet<string> = new Set<string>([
-  // 'SVPRO-EVAL-acme-202506-3F7K9P',  // example - expired ACME trial
-  // 'SVPRO-LEAKED-globex-202612-X8N4P', // example - key leaked on GitHub
+  // 'SVENTERPRISE-EVAL-acme-202506-3F7K9P',  // example - expired ACME trial
+  // 'SVENTERPRISE-LEAKED-globex-202612-X8N4P', // example - key leaked on GitHub
 ])

package/src/upgrade-prompt.test.ts

@@ -8,7 +8,7 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import { showUpgradePrompt, dismissUpgradePrompt } from './upgrade-prompt'
 
-const CARD_ATTR = 'data-@svgrid/enterprise-upgrade'
+const CARD_ATTR = 'data-svgrid-enterprise-upgrade'
 
 function card(): HTMLElement | null {
   return document.querySelector(`[${CARD_ATTR}]`)

package/src/upgrade-prompt.ts

@@ -17,16 +17,16 @@
 //   - Zero dependencies, inline styles - no CSS file to import, nothing to
 //     bundle, works in any host app regardless of its styling.
 
-const CARD_ATTR = 'data-@svgrid/enterprise-upgrade'
+const CARD_ATTR = 'data-svgrid-enterprise-upgrade'
 const PRICING_URL = 'https://www.svgrid.com/pricing'
 // ?ref=in-app lets us measure how many trials start from this exact prompt
 // vs. the pricing page itself - the whole point of a moment-of-intent CTA.
-const TRIAL_URL = 'https://www.svgrid.com/pricing?ref=in-app&utm_source=@svgrid/enterprise&utm_medium=upgrade-prompt'
+const TRIAL_URL = 'https://www.svgrid.com/pricing?ref=in-app&utm_source=svgrid-enterprise&utm_medium=upgrade-prompt'
 
 let shownThisSession = false
 
 /** Human-readable labels for the Pro surfaces that gate behind a license. */
-export type ProFeatureLabel =
+export type EnterpriseFeatureLabel =
   | 'Export'
   | 'Import'
   | 'Print'
@@ -38,7 +38,7 @@ export type ProFeatureLabel =
  * been shown this session, a card is already up, or we're on the server. Safe
  * to call on every Pro feature invocation - it self-throttles.
  */
-export function showUpgradePrompt(feature?: ProFeatureLabel | string): void {
+export function showUpgradePrompt(feature?: EnterpriseFeatureLabel | string): void {
   if (shownThisSession) return
   if (typeof document === 'undefined' || typeof window === 'undefined') return
   if (document.querySelector(`[${CARD_ATTR}]`)) return
@@ -72,7 +72,7 @@ function close(card: HTMLElement): void {
   window.setTimeout(() => card.remove(), 220)
 }
 
-function buildCard(feature?: ProFeatureLabel | string): HTMLElement {
+function buildCard(feature?: EnterpriseFeatureLabel | string): HTMLElement {
   const card = document.createElement('div')
   card.setAttribute(CARD_ATTR, '1')
   card.setAttribute('role', 'dialog')

package/src/watermark.test.ts

@@ -9,7 +9,7 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import { emitUnlicensedNudge, dismissUnlicensedNudge } from './watermark'
 
-const WATERMARK_ATTR = 'data-@svgrid/enterprise-watermark'
+const WATERMARK_ATTR = 'data-svgrid-enterprise-watermark'
 
 function makeGridRoot(): HTMLElement {
   const el = document.createElement('div')