HF-307: wire the two commercial add-on tokens, strictly additively

Per the 2026-08-12 packages meeting: `spreadsheet` backs the Spreadsheet
Bundle add-on and grants Crud, UndoRedo, Clipboard and Batching ("chyba tez"
batching - Kuba, 12.08); `import_export` grants FeatureId.ImportExport, a
reserved grant with no gated method until HF-107 ships the feature.

Additive only: a key naming neither add-on keeps every feature area it has
today (the opt-in rule for keys carrying no feat:* tokens is untouched), so
no real key can start throwing as a side effect of this change. The open
product question - does a package key without the bundle keep CRUD once
packages go live - stays open and is documented as such in the guide.

Implemented by a prep-ship lane (task HF-307-addon-grants); verified here:
license suite 165/165 under Jest, tsc --noEmit clean, eslint clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PdHPZAjciZFWqGa19Yf7it

Author: marcin-kordas-hoc

docs/guide/license-key.md

@@ -65,6 +65,18 @@ an id of their own. The licence covers built-in ids, so a plugin registered unde
 key does not include is treated as that built-in and stays unavailable — it will not be described and
 it evaluates to `#LIC!`. Pick an id the built-in catalogue does not use and this cannot happen.
 
+Two commercial add-ons build on top of a package:
+
+* **Spreadsheet Bundle** grants the CRUD API (adding, removing, and moving rows, columns, sheets,
+  and cell contents), undo/redo, clipboard operations, and batching (`suspendEvaluation()` /
+  `resumeEvaluation()`).
+* **Import/export** is reserved for a future release. HyperFormula doesn't have an import/export
+  feature yet, so this add-on doesn't grant or restrict anything today.
+
+In this release, not having either add-on doesn't restrict anything either: every key already
+grants the CRUD API, undo/redo, clipboard, and batching regardless of whether it names these
+add-ons.
+
 ::: tip
 To find out which package your key includes, check your order confirmation or
 [contact our team](contact.md). HyperFormula deliberately reports nothing about the contents of

src/license/LicenseEntitlement.ts

@@ -6,10 +6,13 @@
 /**
  * Identifies a feature area of the public API that a license entitlement can gate.
  *
- * `CustomFunctions` and `ImportExport` are reserved vocabulary: they exist so a license payload
- * is free to carry them, but no capability grant in this release maps to either of them yet.
- * HF-307 decision D1 drops function-registration gating (and the `CustomFunctions` grant) from
- * this release; `ImportExport` has no gated methods until HF-107 lands.
+ * `CustomFunctions` is reserved vocabulary: it exists so a license payload is free to carry it,
+ * but HF-307 decision D1 drops function-registration gating (and the `CustomFunctions` grant)
+ * from this release, so no capability grant maps to it.
+ *
+ * `ImportExport` IS granted, by the `import_export` add-on token (2026-08-12 packages meeting) —
+ * but it gates no public method yet, because HF-107 hasn't shipped the import/export feature it
+ * would gate. The grant exists; the gate does not, yet.
  */
 export const enum FeatureId {
   NamedExpressions = 'named_expressions',

src/license/capabilities.ts

@@ -44,9 +44,17 @@ export const FUNCTIONS_2_TOKEN = 'functions_2'
 export const FUNCTIONS_3_TOKEN = 'functions_3'
 /** Excel simulator package — the entire implemented catalog. */
 export const FUNCTIONS_4_TOKEN = 'functions_4'
-/** Spreadsheet add-on. Reserved: recognized, grants nothing yet — see {@link CAPABILITY_TABLE}. */
+/**
+ * Spreadsheet Bundle add-on (2026-08-12 packages meeting). Grants {@link FeatureId.Crud},
+ * {@link FeatureId.UndoRedo}, {@link FeatureId.Clipboard} and {@link FeatureId.Batching} — see
+ * {@link CAPABILITY_TABLE}.
+ */
 export const SPREADSHEET_ADDON_TOKEN = 'spreadsheet'
-/** Import/export add-on. Reserved until HF-107 ships the feature it would gate. */
+/**
+ * Import/export add-on (2026-08-12 packages meeting). Grants {@link FeatureId.ImportExport}, a
+ * RESERVED grant: nothing in the public API is gated on it yet, because HF-107 hasn't shipped the
+ * import/export feature it would gate.
+ */
 export const IMPORT_EXPORT_ADDON_TOKEN = 'import_export'
 
 /**
@@ -197,11 +205,13 @@ const functions4Grant: CapabilityGrant = {
  * all five alongside the tier (that vocabulary predates feature tokens); legacy keys resolve to
  * the unrestricted entitlement and never consult this table.
  *
- * The two add-on tokens are RESERVED: recognized, so an issued key carrying one is not reported
- * as unrecognized, but granting nothing. `spreadsheet` has no agreed content yet — the packaging
- * proposal names a *package* "Spreadsheet" and the pricing task names a "Spreadsheet Bundle"
- * add-on, and it is not settled whether those are the same set; guessing would silently sell an
- * empty add-on or duplicate a whole tier. `import_export` has nothing to grant until HF-107.
+ * The two add-on tokens, wired per the 2026-08-12 packages meeting: `spreadsheet` backs the
+ * 'Spreadsheet Bundle' add-on and grants {@link FeatureId.Crud}, {@link FeatureId.UndoRedo},
+ * {@link FeatureId.Clipboard} and {@link FeatureId.Batching} (Kuba: batching too, 12.08).
+ * `import_export` backs the import-export add-on and grants {@link FeatureId.ImportExport} — a
+ * RESERVED grant, since nothing in the public API is gated on it yet: HF-107 hasn't shipped the
+ * feature it would gate. Both tokens stay recognized either way, so an issued key carrying one is
+ * never reported as unrecognized.
  */
 export const CAPABILITY_TABLE: ReadonlyMap<string, CapabilityGrant> = new Map([
   [CORE_TOKEN, coreGrant],
@@ -214,7 +224,10 @@ export const CAPABILITY_TABLE: ReadonlyMap<string, CapabilityGrant> = new Map([
   [CLIPBOARD_FEATURE_TOKEN, {functions: [], features: [FeatureId.Clipboard]}],
   [NAMED_EXPRESSIONS_FEATURE_TOKEN, {functions: [], features: [FeatureId.NamedExpressions]}],
   [BATCHING_FEATURE_TOKEN, {functions: [], features: [FeatureId.Batching]}],
-  [SPREADSHEET_ADDON_TOKEN, {functions: [], features: []}],
-  [IMPORT_EXPORT_ADDON_TOKEN, {functions: [], features: []}],
+  [SPREADSHEET_ADDON_TOKEN, {
+    functions: [],
+    features: [FeatureId.Crud, FeatureId.UndoRedo, FeatureId.Clipboard, FeatureId.Batching],
+  }],
+  [IMPORT_EXPORT_ADDON_TOKEN, {functions: [], features: [FeatureId.ImportExport]}],
 ])