@tolinax/ayoune-interfaces 2026.54.0 → 2026.57.2

package/README.md

@@ -1,132 +1,132 @@
-# aYOUne Interfaces
-
-A comprehensive TypeScript interfaces library for the aYOUne platform - a modular business as a Service platform.
-
-[![npm version](https://badge.fury.io/js/@tolinax%2Fayoune-interfaces.svg)](https://badge.fury.io/js/@tolinax%2Fayoune-interfaces)
-[![License: LGPL-3.0](https://img.shields.io/badge/License-LGPL-yellow.svg)](https://opensource.org/license/lgpl-3-0)
-
-## Overview
-
-This library provides TypeScript type definitions and data exports for the aYOUne platform, which includes modules for:
-
-- **AI** - Artificial Intelligence services
-- **CRM** - Customer Relationship Management  
-- **CMS** - Content Management System
-- **Marketing** - Marketing automation and campaigns
-- **Automation** - Business process automation
-- **PM** - Project Management
-- **E-commerce** - Online store management
-- And many more specialized modules
-
-## Installation
-
-```bash
-npm install @tolinax/ayoune-interfaces
-```
-
-## Usage
-
-### Importing Interfaces
-
-```typescript
-import { IAPI, ITicket, IaYOUneUser } from '@tolinax/ayoune-interfaces';
-
-// Use interfaces for type safety
-const api: IAPI = {
-  _customerID: "customer123",
-  _clientID: [],
-  _subID: [],
-  _user: "user456",
-  name: "My API",
-  callback_url: "https://example.com/callback",
-  access_token: "token123",
-  access_token_key: "key456",
-  active: true,
-  scopes: [{ key: "read" }],
-  limit: false,
-  rateLimit: 1000
-};
-```
-
-### Importing Data and Enums
-
-```typescript
-import { aYOUneServices, aYOUneModules, aMN } from '@tolinax/ayoune-interfaces';
-
-// Access service definitions
-console.log(aYOUneServices); // Array of all aYOUne services with hosts
-
-// Access module definitions  
-console.log(aYOUneModules); // Array of platform modules
-
-// Use model names enum
-const collectionName = aMN.AIConversations; // "AIConversations"
-```
-
-## API Reference
-
-### Core Interfaces
-
-All interfaces extend `IDefaultFields` which provides common MongoDB document fields:
-
-- `_id`: ObjectId
-- `created`: Date
-- `updated`: Date
-- Other standard database fields
-
-### Data Exports
-
-#### Services (`aYOUneServices`)
-Array of service definitions with:
-- `label`: Human-readable service name
-- `module`: Associated platform module  
-- `host`: Service hostname
-
-#### Modules (`aYOUneModules`)
-Array of platform modules with:
-- `label`: Module display name
-- `module`: Module identifier
-- `host`: Module hostname
-
-#### Model Names (`aMN`)
-Enum containing all MongoDB collection names used across the platform.
-
-## Development
-
-### Building
-
-```bash
-npm run build
-```
-
-### Release
-
-This project uses conventional commits and automated releases:
-
-```bash
-npm run release
-```
-
-## Platform Architecture
-
-The aYOUne platform consists of multiple specialized services:
-
-- **Global Services**: Middleware, Datatables, Barcodes, Scripts
-- **AI Services**: Text/Image/Video Generation, Text-to-Speech  
-- **CMS Services**: Media, Content Snippets, Dynamic Content
-- **Business Services**: CRM, PM, Marketing, Automation
-- **Analytics**: Statistics, Monitoring, Reporting
-- **E-commerce**: Sales, Purchase, Accounting
-
-Each service is independently deployable and communicates through well-defined interfaces provided by this library.
-
-## Contributing
-
-1. Follow conventional commit format (`feat:`, `fix:`, `docs:`, etc.)
-2. All interfaces should extend `IDefaultFields` when appropriate
-3. Use consistent naming: interfaces start with `I`, data exports use descriptive names
-4. Update CHANGELOG.md entries are generated automatically
-
-## License
-
-LGPL-3.0 © tolinax
+# aYOUne Interfaces
+
+A comprehensive TypeScript interfaces library for the aYOUne platform - a modular business as a Service platform.
+
+[![npm version](https://badge.fury.io/js/@tolinax%2Fayoune-interfaces.svg)](https://badge.fury.io/js/@tolinax%2Fayoune-interfaces)
+[![License: LGPL-3.0](https://img.shields.io/badge/License-LGPL-yellow.svg)](https://opensource.org/license/lgpl-3-0)
+
+## Overview
+
+This library provides TypeScript type definitions and data exports for the aYOUne platform, which includes modules for:
+
+- **AI** - Artificial Intelligence services
+- **CRM** - Customer Relationship Management  
+- **CMS** - Content Management System
+- **Marketing** - Marketing automation and campaigns
+- **Automation** - Business process automation
+- **PM** - Project Management
+- **E-commerce** - Online store management
+- And many more specialized modules
+
+## Installation
+
+```bash
+npm install @tolinax/ayoune-interfaces
+```
+
+## Usage
+
+### Importing Interfaces
+
+```typescript
+import { IAPI, ITicket, IaYOUneUser } from '@tolinax/ayoune-interfaces';
+
+// Use interfaces for type safety
+const api: IAPI = {
+  _customerID: "customer123",
+  _clientID: [],
+  _subID: [],
+  _user: "user456",
+  name: "My API",
+  callback_url: "https://example.com/callback",
+  access_token: "token123",
+  access_token_key: "key456",
+  active: true,
+  scopes: [{ key: "read" }],
+  limit: false,
+  rateLimit: 1000
+};
+```
+
+### Importing Data and Enums
+
+```typescript
+import { aYOUneServices, aYOUneModules, aMN } from '@tolinax/ayoune-interfaces';
+
+// Access service definitions
+console.log(aYOUneServices); // Array of all aYOUne services with hosts
+
+// Access module definitions  
+console.log(aYOUneModules); // Array of platform modules
+
+// Use model names enum
+const collectionName = aMN.AIConversations; // "AIConversations"
+```
+
+## API Reference
+
+### Core Interfaces
+
+All interfaces extend `IDefaultFields` which provides common MongoDB document fields:
+
+- `_id`: ObjectId
+- `created`: Date
+- `updated`: Date
+- Other standard database fields
+
+### Data Exports
+
+#### Services (`aYOUneServices`)
+Array of service definitions with:
+- `label`: Human-readable service name
+- `module`: Associated platform module  
+- `host`: Service hostname
+
+#### Modules (`aYOUneModules`)
+Array of platform modules with:
+- `label`: Module display name
+- `module`: Module identifier
+- `host`: Module hostname
+
+#### Model Names (`aMN`)
+Enum containing all MongoDB collection names used across the platform.
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Release
+
+This project uses conventional commits and automated releases:
+
+```bash
+npm run release
+```
+
+## Platform Architecture
+
+The aYOUne platform consists of multiple specialized services:
+
+- **Global Services**: Middleware, Datatables, Barcodes, Scripts
+- **AI Services**: Text/Image/Video Generation, Text-to-Speech  
+- **CMS Services**: Media, Content Snippets, Dynamic Content
+- **Business Services**: CRM, PM, Marketing, Automation
+- **Analytics**: Statistics, Monitoring, Reporting
+- **E-commerce**: Sales, Purchase, Accounting
+
+Each service is independently deployable and communicates through well-defined interfaces provided by this library.
+
+## Contributing
+
+1. Follow conventional commit format (`feat:`, `fix:`, `docs:`, etc.)
+2. All interfaces should extend `IDefaultFields` when appropriate
+3. Use consistent naming: interfaces start with `I`, data exports use descriptive names
+4. Update CHANGELOG.md entries are generated automatically
+
+## License
+
+LGPL-3.0 © tolinax

package/data/modelsAndRights.d.ts

@@ -15,6 +15,74 @@ interface IModelAction {
     dangerous?: boolean;
     confirmation?: string;
 }
+/**
+ * Unified sub-document types known to the codegen. Each maps to one of
+ * the shared Schemas under `platform/models/src/models/sub_schemas/`
+ * (CommentsSchema, ReactionsSchema, VotesSchema, SharesSchema, …).
+ *
+ * The codegen emits REST routes + a notification-emit hook per type:
+ *   comment   → POST/GET/DELETE /:id/comments[/:cid/replies], emits `commented`
+ *   reaction  → POST/DELETE /:id/comments/:cid/reactions, emits `reacted`
+ *   vote      → POST/DELETE /:id/comments/:cid/votes, emits `voted`
+ *   share     → POST/DELETE /:id/shares, emits `shared`
+ *   attachment→ POST/GET/DELETE /:id/attachments, emits `attached`
+ */
+export type SubdocumentType = "comment" | "reaction" | "vote" | "share" | "attachment";
+export interface ISubdocumentConfig {
+    /** Path segment on the entity route, e.g. "comments". */
+    name: string;
+    /** Which unified sub-schema backs this subdoc. */
+    type: SubdocumentType;
+    /**
+     * Whether mutations on this subdoc should emit a notification via
+     * POST /notifications/send. Default `true` for `comment`, `false` for
+     * `reaction` and `vote` (too noisy for in-app bell). Explicit here
+     * because every case has defenders.
+     */
+    notify?: boolean;
+    /**
+     * Right required for mutations. Defaults to the parent entity's
+     * `{right}.{name}` (e.g. pm.tasks.comments). Read uses `{right}`.
+     */
+    right?: string;
+}
+/**
+ * Non-CRUD actions beyond the defaults (`new/edit/delete`). The codegen
+ * writes `POST /{entity}/:id/actions/{name}` for each entry, wires a
+ * rights check and an optional notification emit. Consumed by:
+ *   - admin-v2 SDUI (row-action buttons)
+ *   - OpenAPI spec (operationId `ayoune.{ns}.{capability}.actions.{name}`)
+ *   - AI agent tools (each action becomes a callable function)
+ */
+export interface IEntityAction {
+    /** URL segment, e.g. "complete", "assign", "approve". */
+    name: string;
+    /** HTTP verb. Default: POST. */
+    verb?: "POST" | "PUT" | "DELETE";
+    /** Right required. Default: `{entity.right}.{action.name}`. */
+    right?: string;
+    /**
+     * If set, the handler emits a POST to /notifications/send after success
+     * with `{entityType: entity.plural, eventType: emits}`. Skip to disable.
+     */
+    emits?: string;
+    /**
+     * JSON-schema-ish shape for the request body. Used by OpenAPI codegen,
+     * the admin-v2 runner dialog, and the AI-agent tool definition.
+     */
+    paramSchema?: Record<string, any>;
+    /** i18n label key for SDUI buttons; falls back to humanized `name`. */
+    labelKey?: string;
+    /** Material icon name for SDUI. */
+    icon?: string;
+    /** When the action is destructive and should require confirmation. */
+    dangerous?: boolean;
+    /**
+     * Whether this action runs on a single row, many rows (bulk), or both.
+     * Default: "single". Bulk actions receive `{ids: string[]}` in the body.
+     */
+    availability?: "single" | "many" | "both";
+}
 /**
  * Operations exposable to the Custom Functions `ay.db.*` sandbox SDK.
  *
@@ -70,6 +138,9 @@ export interface IModelAndRight {
     availableInSDK?: boolean;
     sdkOperations?: SDKOperation[];
     allowStreaming?: boolean;
+    events?: string[];
+    subdocuments?: ISubdocumentConfig[];
+    entityActions?: IEntityAction[];
 }
 declare const modelsAndRights: IModelAndRight[];
 export default modelsAndRights;

package/interfaces/IComment.d.ts

@@ -4,6 +4,16 @@ import { IReaction } from "./IReaction";
 export interface IComment extends IDefaultFields {
     _user?: ObjectId;
     _consumerID?: ObjectId;
+    /**
+     * Flat reply-threading. When set, this comment is a reply to the
+     * comment with matching `_id` on the same parent entity. Undefined
+     * means root-level. Arbitrary depth is allowed; the client rebuilds
+     * the tree (or a $graphLookup does it server-side). Public-web
+     * surfaces (WikiPages, knowledge base pages) rely on this for
+     * consumer-authored discussions; internal surfaces (Tasks, Projects)
+     * can use it for threaded replies when natural.
+     */
+    _parentId?: ObjectId;
     comment: string;
     internal?: boolean;
     origin?: string;

package/interfaces/IPageBlock.d.ts

@@ -5,7 +5,7 @@
  * Each block has a type, content map, settings for layout/style,
  * optional translations per locale, and optional widget embedding config.
  */
-export type PageBlockType = 'hero' | 'text' | 'image' | 'gallery' | 'video' | 'cta' | 'form' | 'widget' | 'columns' | 'testimonial' | 'pricing' | 'faq' | 'contact' | 'map' | 'social' | 'html' | 'divider' | 'spacer' | 'header' | 'footer' | 'navigation' | 'countdown' | 'stats' | 'logos' | 'features' | 'team' | 'blog-list' | 'product-list';
+export type PageBlockType = 'hero' | 'text' | 'image' | 'gallery' | 'video' | 'cta' | 'form' | 'widget' | 'columns' | 'testimonial' | 'pricing' | 'faq' | 'contact' | 'map' | 'social' | 'html' | 'divider' | 'spacer' | 'header' | 'footer' | 'navigation' | 'countdown' | 'stats' | 'logos' | 'features' | 'team' | 'blog-list' | 'product-list' | 'table' | 'code' | 'admonition' | 'mermaid' | 'toc' | 'panel' | 'api-reference' | 'playground';
 export interface IPageBlockSpacing {
     top?: number;
     right?: number;

package/interfaces/IWebsite.d.ts

@@ -196,6 +196,8 @@ export interface IWebsite extends IDefaultFields {
         helpCenter?: boolean;
         /** Enable developer portal (API docs, SDK reference, webhooks) */
         developerPortal?: boolean;
+        /** Enable Confluence-style product documentation at /:locale/docs/* (Self-Documentation, Kap. 1.62) */
+        docs?: boolean;
         /** Enable consumer portal (authenticated area: invoices, tickets, etc.) */
         consumerPortal?: boolean;
         /** Enable public roadmap + feature requests + changelog pages (dogfooding) */

package/interfaces/IWikiPage.d.ts

@@ -2,6 +2,20 @@ import { IDefaultFields } from "./IDefaultFields";
 import { ITxtStats } from "./ITxtStats";
 import { ITTS } from "./ITTS";
 import { ISEOAttributes } from "./ISEOAttributes";
+import { IPageBlock } from "./IPageBlock";
+import { IComment } from "./IComment";
+import { IVote } from "./IVote";
+/** Entry in a page's auto-generated table of contents. */
+export interface IWikiPageTocEntry {
+    /** Heading level (1 = H1, 2 = H2, ...). */
+    level: number;
+    /** URL anchor slug (matches the <h*> id attribute). */
+    slug: string;
+    /** Heading text (plain). */
+    text: string;
+}
+/** Content authoring format — determines how render-pipeline processes the page body. */
+export type WikiPageContentFormat = 'markdown' | 'blocks' | 'html';
 export interface IWikiPage extends IDefaultFields {
     _customerID?: ObjectId;
     _clientID?: ObjectId[];
@@ -23,11 +37,27 @@ export interface IWikiPage extends IDefaultFields {
     kbslug?: string;
     wikiworld?: string;
     supportPortalLink?: string;
+    /** Consumer-app deep link (ayoune.com). Populated by jobWorkerPermalinks post 2026-04-22. */
+    consumerAppLink?: string;
     ytvideoid?: string;
     content?: string;
     contentHTML?: string;
     excerpt?: string;
     excerptHTML?: string;
+    /** Block-based authoring (alternative to markdown `content`). Phase 1a of Self-Documentation. */
+    blocks?: IPageBlock[];
+    /** Which authoring format the page uses. Default: 'markdown'. */
+    contentFormat?: WikiPageContentFormat;
+    /** Last time the render pipeline populated contentHTML/excerptHTML/toc. */
+    renderedAt?: Date;
+    /** Hash of content|blocks for idempotent render-skip. */
+    renderHash?: string;
+    /** Locales in which this (kbslug, slug) is currently available (aggregated across sibling docs). */
+    availableLocales?: string[];
+    /** Auto-generated table of contents from H1-H3 headings at publish time. */
+    toc?: IWikiPageTocEntry[];
+    /** Curated cross-links to other WikiPages (in addition to inline `wiki:` links). */
+    relatedPages?: ObjectId[];
     teamaccess?: any[];
     useraccess?: any[];
     globalaccess?: any[];
@@ -40,29 +70,12 @@ export interface IWikiPage extends IDefaultFields {
         name?: string;
     }[];
     keywords?: any[];
-    comments?: {
-        _consumerID?: ObjectId;
-        comment: string;
-        createdAt?: Date;
-        comments?: {
-            _consumerID?: ObjectId;
-            comment: string;
-            createdAt?: Date;
-        }[];
-    }[];
+    /** Consumer- und User-authored comments. Flat reply-threading via IComment._parentId. */
+    comments?: IComment[];
     views?: number;
     shares?: number;
-    upVotes?: {
-        _consumerID: ObjectId;
-        usermail: string;
-        createdAt?: Date;
-    }[];
-    downVotes?: {
-        comment: string;
-        _consumerID: ObjectId;
-        usermail: string;
-        created?: Date;
-    }[];
+    /** Consumer up/down votes on the page itself (distinct from votes on individual comments, which live inside IComment.votes). */
+    votes?: IVote[];
     textBlocks?: any[];
     wikiPages?: any[];
     videoId?: ObjectId;

package/interfaces/blocks/IAdmonitionBlock.d.ts

@@ -0,0 +1,20 @@
+/**
+ * IAdmonitionBlock — Callout box for info/warning/tip/danger/success hints.
+ * Renders as styled `<div class="admonition admonition-{variant}">`.
+ * In markdown authoring, corresponds to `::: info`, `::: warning`, etc. (markdown-it-container).
+ */
+export type AdmonitionVariant = 'info' | 'warning' | 'tip' | 'danger' | 'success' | 'note';
+export interface IAdmonitionBlockContent {
+    /** Admonition type — drives color + default icon. */
+    variant: AdmonitionVariant;
+    /** Optional title shown at top of the admonition. */
+    title?: string;
+    /** Body markdown (inline + block elements supported). */
+    body: string;
+    /** Lucide / Material icon name — overrides variant default. */
+    icon?: string;
+    /** Whether the admonition is collapsible. */
+    collapsible?: boolean;
+    /** If collapsible: start collapsed. */
+    defaultOpen?: boolean;
+}

package/interfaces/blocks/IAdmonitionBlock.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * IAdmonitionBlock — Callout box for info/warning/tip/danger/success hints.
+ * Renders as styled `<div class="admonition admonition-{variant}">`.
+ * In markdown authoring, corresponds to `::: info`, `::: warning`, etc. (markdown-it-container).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/IApiReferenceBlock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IApiReferenceBlock — Embed of a live API entity reference from api-registry.json.
+ * Renders a table of REST paths, required rights, and (optionally) fields.
+ */
+export interface IApiReferenceBlockContent {
+    /** Module slug (e.g. 'crm', 'cms', 'hub'). */
+    module: string;
+    /** Optional specific entity within the module (e.g. 'Consumers'). If omitted, renders the full module index. */
+    entity?: string;
+    /** Show the CRUD-path table (GET /list, POST /, etc.). Default: true. */
+    showCrudTable?: boolean;
+    /** Show the field-list from the entity schema. Default: false (opt-in). */
+    showFields?: boolean;
+    /** Show per-route rights. Default: true. */
+    showRights?: boolean;
+    /** Deep-link target (opens the full entwickler-portal page). */
+    linkToDeveloperPortal?: boolean;
+}

package/interfaces/blocks/IApiReferenceBlock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * IApiReferenceBlock — Embed of a live API entity reference from api-registry.json.
+ * Renders a table of REST paths, required rights, and (optionally) fields.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/ICodeBlock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ICodeBlock — Syntax-highlighted code block with optional line numbers + filename.
+ * Rendered server-side via highlight.js at publish time.
+ */
+export interface ICodeBlockContent {
+    /** Code content (preserves original whitespace). */
+    code: string;
+    /** Language identifier for syntax highlighting (e.g. 'ts', 'bash', 'json'). */
+    language: string;
+    /** Show line numbers in gutter. */
+    showLineNumbers?: boolean;
+    /** Optional filename shown as a header above the block. */
+    filename?: string;
+    /** Highlight specific line numbers (1-based). */
+    highlightLines?: number[];
+    /** Wrap long lines (false = horizontal scroll). */
+    wrap?: boolean;
+}

package/interfaces/blocks/ICodeBlock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * ICodeBlock — Syntax-highlighted code block with optional line numbers + filename.
+ * Rendered server-side via highlight.js at publish time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/IMermaidBlock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IMermaidBlock — Mermaid-JS diagram block.
+ * Source diagramCode is authored in the editor; renderedSvg is populated
+ * server-side at publish time so the consumer-app stays zero-JS.
+ */
+export type MermaidDiagramType = 'flowchart' | 'sequence' | 'class' | 'state' | 'gantt' | 'pie' | 'mindmap' | 'erd' | 'journey' | 'gitgraph' | 'c4' | 'unknown';
+export interface IMermaidBlockContent {
+    /** Mermaid source (e.g. "graph TD\nA --> B"). */
+    diagramCode: string;
+    /** Auto-detected diagram type for rendering hints. */
+    diagramType?: MermaidDiagramType;
+    /** Server-rendered SVG markup (inlined into contentHTML at publish). */
+    renderedSvg?: string;
+    /** Theme preset: default | dark | forest | neutral. */
+    theme?: 'default' | 'dark' | 'forest' | 'neutral';
+    /** Optional caption below the diagram. */
+    caption?: string;
+}

package/interfaces/blocks/IMermaidBlock.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * IMermaidBlock — Mermaid-JS diagram block.
+ * Source diagramCode is authored in the editor; renderedSvg is populated
+ * server-side at publish time so the consumer-app stays zero-JS.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/IPanelBlock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IPanelBlock — Collapsible panel/accordion block.
+ * Renders as `<details><summary>title</summary>body</details>` (zero-JS).
+ */
+export interface IPanelBlockContent {
+    /** Panel title (shown in summary). */
+    title: string;
+    /** Panel body (markdown/HTML). */
+    body: string;
+    /** Whether the panel can be collapsed. Default: true. */
+    collapsible?: boolean;
+    /** Whether the panel starts open. Default: true. */
+    defaultOpen?: boolean;
+    /** Optional icon in the summary bar. */
+    icon?: string;
+    /** Background color variant. */
+    variant?: 'default' | 'muted' | 'accent';
+}

package/interfaces/blocks/IPanelBlock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * IPanelBlock — Collapsible panel/accordion block.
+ * Renders as `<details><summary>title</summary>body</details>` (zero-JS).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/IPlaygroundBlock.d.ts

@@ -0,0 +1,25 @@
+/**
+ * IPlaygroundBlock — Interactive "Try it now" REST-API snippet.
+ * In the consumer-app, renders a form that sends a real request to the target API.
+ */
+export type PlaygroundHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface IPlaygroundBlockContent {
+    /** HTTP method. */
+    method: PlaygroundHttpMethod;
+    /** Request path (e.g. '/consumers/:id'). May contain `:paramName` placeholders. */
+    path: string;
+    /** Module that owns the endpoint (used to resolve the host: `{module}-api.ayoune.app`). */
+    module: string;
+    /** Optional entity name for schema-aware Body-Editor hints. */
+    entity?: string;
+    /** Pre-filled request body (JSON). */
+    sampleBody?: any;
+    /** Expected sample response — shown before the user sends. */
+    sampleResponse?: any;
+    /** Whether to require a JWT before the "Send" button activates. Default: true. */
+    requireAuth?: boolean;
+    /** Title shown above the playground. */
+    title?: string;
+    /** Explanation text above the form. */
+    description?: string;
+}

package/interfaces/blocks/IPlaygroundBlock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * IPlaygroundBlock — Interactive "Try it now" REST-API snippet.
+ * In the consumer-app, renders a form that sends a real request to the target API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/ITableBlock.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ITableBlock — Confluence-style table block for WikiPages + WebPages.
+ * Renders via markdown-it table plugin (or custom block renderer).
+ */
+export type TableCellAlignment = 'left' | 'center' | 'right';
+export interface ITableBlockContent {
+    /** Column headers */
+    headers: string[];
+    /** Rows as arrays of cell strings. Cells may contain inline markdown. */
+    rows: string[][];
+    /** Per-column alignment (length = headers.length). Default: 'left'. */
+    alignment?: TableCellAlignment[];
+    /** Optional caption displayed above/below the table */
+    caption?: string;
+    /** Show striped rows */
+    striped?: boolean;
+    /** Show outer border */
+    bordered?: boolean;
+}

package/interfaces/blocks/ITableBlock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * ITableBlock — Confluence-style table block for WikiPages + WebPages.
+ * Renders via markdown-it table plugin (or custom block renderer).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/ITocBlock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ITocBlock — Auto-generated Table-of-Contents block.
+ * Populated server-side from the page's H1-H6 headings at publish time.
+ */
+export interface ITocBlockContent {
+    /** Minimum heading depth to include (1 = H1, 2 = H2, ...). Default: 2. */
+    minDepth?: number;
+    /** Maximum heading depth. Default: 3. */
+    maxDepth?: number;
+    /** Scope of the TOC. */
+    scope: 'page' | 'space';
+    /** Title shown above the TOC (e.g. "On this page"). */
+    title?: string;
+    /** Whether to render as numbered list (ordered). */
+    numbered?: boolean;
+    /** Whether to collapse the TOC by default. */
+    collapsible?: boolean;
+}

package/interfaces/blocks/ITocBlock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * ITocBlock — Auto-generated Table-of-Contents block.
+ * Populated server-side from the page's H1-H6 headings at publish time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/blocks/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Confluence-style Block-Type Content interfaces for WikiPages + WebPages.
+ * Each interface defines the shape of `IPageBlock.content` for a specific block type.
+ * Added 2026-04-22 as part of the Self-Documentation initiative (Kap. 1.62).
+ */
+export * from './ITableBlock';
+export * from './ICodeBlock';
+export * from './IAdmonitionBlock';
+export * from './IMermaidBlock';
+export * from './ITocBlock';
+export * from './IPanelBlock';
+export * from './IApiReferenceBlock';
+export * from './IPlaygroundBlock';

package/interfaces/blocks/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Confluence-style Block-Type Content interfaces for WikiPages + WebPages.
+ * Each interface defines the shape of `IPageBlock.content` for a specific block type.
+ * Added 2026-04-22 as part of the Self-Documentation initiative (Kap. 1.62).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ITableBlock"), exports);
+__exportStar(require("./ICodeBlock"), exports);
+__exportStar(require("./IAdmonitionBlock"), exports);
+__exportStar(require("./IMermaidBlock"), exports);
+__exportStar(require("./ITocBlock"), exports);
+__exportStar(require("./IPanelBlock"), exports);
+__exportStar(require("./IApiReferenceBlock"), exports);
+__exportStar(require("./IPlaygroundBlock"), exports);

package/interfaces/index.d.ts

@@ -705,6 +705,7 @@ export * from "./IWebsite";
 export * from "./IWebsiteMenu";
 export * from "./IWebsiteTemplate";
 export * from "./IPageBlock";
+export * from "./blocks";
 export * from "./IWhatsappLog";
 export * from "./IWidget";
 export * from "./IWidgetEmbedSite";

package/interfaces/index.js

@@ -721,6 +721,7 @@ __exportStar(require("./IWebsite"), exports);
 __exportStar(require("./IWebsiteMenu"), exports);
 __exportStar(require("./IWebsiteTemplate"), exports);
 __exportStar(require("./IPageBlock"), exports);
+__exportStar(require("./blocks"), exports);
 __exportStar(require("./IWhatsappLog"), exports);
 __exportStar(require("./IWidget"), exports);
 __exportStar(require("./IWidgetEmbedSite"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-interfaces",
-  "version": "2026.54.0",
+  "version": "2026.57.2",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,6 @@
     "copy-readme": "cpx README.md dist",
     "prerelease": "npm run build",
     "release": "release-it --ci",
-    "postrelease": "npm run release-package",
     "prerelease-package": "npm run copy-package  && npm run copy-readme",
     "release-package": "cd dist && npm publish",
     "test": "echo \"Error: no test specified\" && exit 1"