@stackable-labs/sdk-extension-contracts 2.16.0 → 2.17.0

package/dist/index.d.ts

@@ -660,23 +660,25 @@ interface InstanceConfig {
     } & Record<string, unknown>;
 }
 /**
- * ExtensionGroup — an ordered slice of an Instance's authorized extensions with shared collapse behavior.
+ * ExtensionGroup — an ordered slice of an Instance's authorized extensions.
  *
- * Renders to end users as either an always-open stack (collapsible=false) or one of two
- * collapsible modes controlled by `oneAtATime`:
- *   - oneAtATime=true  → accordion: one row open at a time, at least one must stay open
- *   - oneAtATime=false → free-form: any combination open/closed, user can collapse all
- * Max 4 groups per instance. Single-extension instances do NOT use groups — they render
- * always-open via the hard-rule fallback.
+ * Two render modes, switched by `paginated`:
+ *   - paginated=true  → carousel: one extension visible at a time; user pages through via
+ *                       dot indicators + left/right arrow controls. No trigger row, no label
+ *                       on the trigger (developer-facing identifiers stay out of end-user UI).
+ *   - paginated=false → stacked: all extensions render expanded, vertically stacked.
  *
- * Immutability rule: once a group is persisted with a given `id`, that id is stable across all
- * subsequent updates. Renderer + admin UI key off `id` for collapse-state tracking.
+ * Single-extension hard rule (§5a): a group whose post-enabled-filter render list is 1 always
+ * renders that single extension inline (no carousel controls, no dots). Same rationale as the
+ * instance-level hard rule.
+ *
+ * Max 4 groups per instance. Immutability rule: once a group is persisted with a given `id`,
+ * that id is stable across all subsequent updates.
  */
 interface ExtensionGroup {
     id: string;
     label?: string;
-    collapsible: boolean;
-    oneAtATime: boolean;
+    paginated: boolean;
     extensionIds: string[];
 }
 interface InstanceOption {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-contracts",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "type": "module",
   "sideEffects": false,
   "private": false,