@contractspec/bundle.library 1.11.1 → 1.12.0

package/src/components/docs/generated/docs-index.feature-flags.json

@@ -2,7 +2,7 @@
   {
     "id": "feature-flags/experiment.create",
     "title": "experiment.create",
-    "summary": "Create an A/B test experiment. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, experiment, create",
+    "summary": "Create an A/B test experiment.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, experiment, create\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/experiment.create",
     "source": "generated",
     "contentPath": "feature-flags/experiment.create.md"
@@ -10,7 +10,7 @@
   {
     "id": "feature-flags/experiment.created",
     "title": "experiment.created",
-    "summary": "An experiment has been created. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, experiment, create \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "An experiment has been created.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, experiment, create\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/experiment.created",
     "source": "generated",
     "contentPath": "feature-flags/experiment.created.md"
@@ -18,7 +18,7 @@
   {
     "id": "feature-flags/experiment.get",
     "title": "experiment.get",
-    "summary": "Get experiment details. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, experiment, get \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Get experiment details.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, experiment, get\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/experiment.get",
     "source": "generated",
     "contentPath": "feature-flags/experiment.get.md"
@@ -26,7 +26,7 @@
   {
     "id": "feature-flags/experiment.start",
     "title": "experiment.start",
-    "summary": "Start an experiment. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, experiment, start \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Start an experiment.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, experiment, start\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/experiment.start",
     "source": "generated",
     "contentPath": "feature-flags/experiment.start.md"
@@ -34,7 +34,7 @@
   {
     "id": "feature-flags/experiment.started",
     "title": "experiment.started",
-    "summary": "An experiment has started. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, experiment, start \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "An experiment has started.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, experiment, start\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/experiment.started",
     "source": "generated",
     "contentPath": "feature-flags/experiment.started.md"
@@ -42,7 +42,7 @@
   {
     "id": "feature-flags/experiment.stop",
     "title": "experiment.stop",
-    "summary": "Stop an experiment. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, experiment, stop \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Stop an experiment.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, experiment, stop\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/experiment.stop",
     "source": "generated",
     "contentPath": "feature-flags/experiment.stop.md"
@@ -50,7 +50,7 @@
   {
     "id": "feature-flags/experiment.stopped",
     "title": "experiment.stopped",
-    "summary": "An experiment has stopped. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, experiment, stop \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "An experiment has stopped.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, experiment, stop\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/experiment.stopped",
     "source": "generated",
     "contentPath": "feature-flags/experiment.stopped.md"
@@ -58,7 +58,7 @@
   {
     "id": "feature-flags/experiment.variant_assigned",
     "title": "experiment.variant_assigned",
-    "summary": "A subject has been assigned to an experiment variant. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, experiment, variant",
+    "summary": "A subject has been assigned to an experiment variant.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, experiment, variant",
     "route": "/docs/reference/feature-flags/experiment.variant_assigned",
     "source": "generated",
     "contentPath": "feature-flags/experiment.variant_assigned.md"
@@ -66,7 +66,7 @@
   {
     "id": "feature-flags/experiments",
     "title": "experiments",
-    "summary": "A/B testing and experimentation platform \n - **Type**: capability (capability) \n - **Version**: 1.0.0 \n - **Owners**: @platform.featureflags \n - **Tags**: experiments, ab-testing \n - **File**: `packages/libs/feature-flags/src/feature-flags.capability.ts`",
+    "summary": "A/B testing and experimentation platform\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: @platform.featureflags\n- **Tags**: experiments, ab-testing\n- **File**: `packages/libs/feature-flags/src/feature-flags.capability.ts`",
     "route": "/docs/reference/feature-flags/experiments",
     "source": "generated",
     "contentPath": "feature-flags/experiments.md"
@@ -74,7 +74,7 @@
   {
     "id": "feature-flags/feature-flag",
     "title": "feature-flag",
-    "summary": "Feature flag management and evaluation \n - **Type**: capability (capability) \n - **Version**: 1.0.0 \n - **Owners**: @platform.featureflags \n - **Tags**: feature-flags, configuration \n - **File**: `packages/libs/feature-flags/src/feature-flags.capability.ts`",
+    "summary": "Feature flag management and evaluation\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: @platform.featureflags\n- **Tags**: feature-flags, configuration\n- **File**: `packages/libs/feature-flags/src/feature-flags.capability.ts`",
     "route": "/docs/reference/feature-flags/feature-flag",
     "source": "generated",
     "contentPath": "feature-flags/feature-flag.md"
@@ -82,7 +82,7 @@
   {
     "id": "feature-flags/feature-flags",
     "title": "feature-flags",
-    "summary": "Feature flag management with targeting rules and A/B experiments \n - **Type**: feature \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, experiments, targeting",
+    "summary": "Feature flag management with targeting rules and A/B experiments\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, experiments, targeting",
     "route": "/docs/reference/feature-flags/feature-flags",
     "source": "generated",
     "contentPath": "feature-flags/feature-flags.md"
@@ -90,7 +90,7 @@
   {
     "id": "feature-flags/flag.create",
     "title": "flag.create",
-    "summary": "Create a new feature flag. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, create \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Create a new feature flag.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, create\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.create",
     "source": "generated",
     "contentPath": "feature-flags/flag.create.md"
@@ -98,7 +98,7 @@
   {
     "id": "feature-flags/flag.created",
     "title": "flag.created",
-    "summary": "A feature flag has been created. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, create \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A feature flag has been created.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, create\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.created",
     "source": "generated",
     "contentPath": "feature-flags/flag.created.md"
@@ -106,7 +106,7 @@
   {
     "id": "feature-flags/flag.delete",
     "title": "flag.delete",
-    "summary": "Delete a feature flag. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, delete \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Delete a feature flag.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, delete\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.delete",
     "source": "generated",
     "contentPath": "feature-flags/flag.delete.md"
@@ -114,7 +114,7 @@
   {
     "id": "feature-flags/flag.deleted",
     "title": "flag.deleted",
-    "summary": "A feature flag has been deleted. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, delete \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A feature flag has been deleted.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, delete\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.deleted",
     "source": "generated",
     "contentPath": "feature-flags/flag.deleted.md"
@@ -122,7 +122,7 @@
   {
     "id": "feature-flags/flag.evaluate",
     "title": "flag.evaluate",
-    "summary": "Evaluate a feature flag for a given context. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, evaluate",
+    "summary": "Evaluate a feature flag for a given context.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, evaluate\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.evaluate",
     "source": "generated",
     "contentPath": "feature-flags/flag.evaluate.md"
@@ -130,7 +130,7 @@
   {
     "id": "feature-flags/flag.evaluated",
     "title": "flag.evaluated",
-    "summary": "A feature flag has been evaluated. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, evaluate \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A feature flag has been evaluated.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, evaluate\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.evaluated",
     "source": "generated",
     "contentPath": "feature-flags/flag.evaluated.md"
@@ -138,7 +138,7 @@
   {
     "id": "feature-flags/flag.get",
     "title": "flag.get",
-    "summary": "Get a feature flag by key. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, get \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Get a feature flag by key.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, get\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.get",
     "source": "generated",
     "contentPath": "feature-flags/flag.get.md"
@@ -146,7 +146,7 @@
   {
     "id": "feature-flags/flag.list",
     "title": "flag.list",
-    "summary": "List all feature flags. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, list \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "List all feature flags.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, list\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.list",
     "source": "generated",
     "contentPath": "feature-flags/flag.list.md"
@@ -154,7 +154,7 @@
   {
     "id": "feature-flags/flag.rule_created",
     "title": "flag.rule_created",
-    "summary": "A targeting rule has been created. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, rule, create \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A targeting rule has been created.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, rule, create\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.rule_created",
     "source": "generated",
     "contentPath": "feature-flags/flag.rule_created.md"
@@ -162,7 +162,7 @@
   {
     "id": "feature-flags/flag.rule_deleted",
     "title": "flag.rule_deleted",
-    "summary": "A targeting rule has been deleted. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, rule, delete \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A targeting rule has been deleted.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, rule, delete\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.rule_deleted",
     "source": "generated",
     "contentPath": "feature-flags/flag.rule_deleted.md"
@@ -170,7 +170,7 @@
   {
     "id": "feature-flags/flag.rule.create",
     "title": "flag.rule.create",
-    "summary": "Create a targeting rule for a flag. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, rule, create",
+    "summary": "Create a targeting rule for a flag.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, rule, create\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.rule.create",
     "source": "generated",
     "contentPath": "feature-flags/flag.rule.create.md"
@@ -178,7 +178,7 @@
   {
     "id": "feature-flags/flag.rule.delete",
     "title": "flag.rule.delete",
-    "summary": "Delete a targeting rule. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, rule, delete \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Delete a targeting rule.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, rule, delete\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.rule.delete",
     "source": "generated",
     "contentPath": "feature-flags/flag.rule.delete.md"
@@ -186,7 +186,7 @@
   {
     "id": "feature-flags/flag.toggle",
     "title": "flag.toggle",
-    "summary": "Toggle a feature flag status. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, toggle \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Toggle a feature flag status.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, toggle\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.toggle",
     "source": "generated",
     "contentPath": "feature-flags/flag.toggle.md"
@@ -194,7 +194,7 @@
   {
     "id": "feature-flags/flag.toggled",
     "title": "flag.toggled",
-    "summary": "A feature flag status has been toggled. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, toggle \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A feature flag status has been toggled.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, toggle\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.toggled",
     "source": "generated",
     "contentPath": "feature-flags/flag.toggled.md"
@@ -202,7 +202,7 @@
   {
     "id": "feature-flags/flag.update",
     "title": "flag.update",
-    "summary": "Update an existing feature flag. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.feature-flags \n - **Tags**: feature-flags, update \n - **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
+    "summary": "Update an existing feature flag.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.feature-flags\n- **Tags**: feature-flags, update\n- **File**: `packages/libs/feature-flags/src/contracts/index.ts`",
     "route": "/docs/reference/feature-flags/flag.update",
     "source": "generated",
     "contentPath": "feature-flags/flag.update.md"
@@ -210,7 +210,7 @@
   {
     "id": "feature-flags/flag.updated",
     "title": "flag.updated",
-    "summary": "A feature flag has been updated. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.feature-flags \n - **Tags**: feature-flags, update \n - **File**: `packages/libs/feature-flags/src/events.ts`",
+    "summary": "A feature flag has been updated.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.feature-flags\n- **Tags**: feature-flags, update\n- **File**: `packages/libs/feature-flags/src/events.ts`",
     "route": "/docs/reference/feature-flags/flag.updated",
     "source": "generated",
     "contentPath": "feature-flags/flag.updated.md"

package/src/components/docs/generated/docs-index.files.json

@@ -2,7 +2,7 @@
   {
     "id": "files/attachment.attach",
     "title": "attachment.attach",
-    "summary": "Attach a file to an entity. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, attachment, attach \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Attach a file to an entity.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, attachment, attach\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/attachment.attach",
     "source": "generated",
     "contentPath": "files/attachment.attach.md"
@@ -10,7 +10,7 @@
   {
     "id": "files/attachment.attached",
     "title": "attachment.attached",
-    "summary": "A file has been attached to an entity. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, attachment, attach \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "A file has been attached to an entity.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, attachment, attach\n- **File**: `packages/libs/files/src/events.ts`",
     "route": "/docs/reference/files/attachment.attached",
     "source": "generated",
     "contentPath": "files/attachment.attached.md"
@@ -18,7 +18,7 @@
   {
     "id": "files/attachment.detach",
     "title": "attachment.detach",
-    "summary": "Detach a file from an entity. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, attachment, detach \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Detach a file from an entity.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, attachment, detach\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/attachment.detach",
     "source": "generated",
     "contentPath": "files/attachment.detach.md"
@@ -26,7 +26,7 @@
   {
     "id": "files/attachment.detached",
     "title": "attachment.detached",
-    "summary": "A file has been detached from an entity. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, attachment, detach \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "A file has been detached from an entity.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, attachment, detach\n- **File**: `packages/libs/files/src/events.ts`",
     "route": "/docs/reference/files/attachment.detached",
     "source": "generated",
     "contentPath": "files/attachment.detached.md"
@@ -34,7 +34,7 @@
   {
     "id": "files/attachment.list",
     "title": "attachment.list",
-    "summary": "List attachments for an entity. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, attachment, list \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "List attachments for an entity.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, attachment, list\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/attachment.list",
     "source": "generated",
     "contentPath": "files/attachment.list.md"
@@ -42,7 +42,7 @@
   {
     "id": "files/attachments",
     "title": "attachments",
-    "summary": "File attachments for entities \n - **Type**: capability (capability) \n - **Version**: 1.0.0 \n - **Owners**: @platform.core \n - **Tags**: attachments, files \n - **File**: `packages/libs/files/src/files.capability.ts`",
+    "summary": "File attachments for entities\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: @platform.core\n- **Tags**: attachments, files\n- **File**: `packages/libs/files/src/files.capability.ts`\n```typescript",
     "route": "/docs/reference/files/attachments",
     "source": "generated",
     "contentPath": "files/attachments.md"
@@ -50,7 +50,7 @@
   {
     "id": "files/file.delete",
     "title": "file.delete",
-    "summary": "Delete a file. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, delete \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Delete a file.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, delete\n- **File**: `packages/libs/files/src/contracts/index.ts`\nRemove a file and all its versions and attachments.",
     "route": "/docs/reference/files/file.delete",
     "source": "generated",
     "contentPath": "files/file.delete.md"
@@ -58,7 +58,7 @@
   {
     "id": "files/file.deleted",
     "title": "file.deleted",
-    "summary": "A file has been deleted. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, delete \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "A file has been deleted.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, delete\n- **File**: `packages/libs/files/src/events.ts`\n```typescript",
     "route": "/docs/reference/files/file.deleted",
     "source": "generated",
     "contentPath": "files/file.deleted.md"
@@ -66,7 +66,7 @@
   {
     "id": "files/file.downloadUrl",
     "title": "file.downloadUrl",
-    "summary": "Get a presigned download URL. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, download \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Get a presigned download URL.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, download\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.downloadUrl",
     "source": "generated",
     "contentPath": "files/file.downloadUrl.md"
@@ -74,7 +74,7 @@
   {
     "id": "files/file.get",
     "title": "file.get",
-    "summary": "Get a file by ID. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, get \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Get a file by ID.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, get\n- **File**: `packages/libs/files/src/contracts/index.ts`\nRetrieve file metadata.",
     "route": "/docs/reference/files/file.get",
     "source": "generated",
     "contentPath": "files/file.get.md"
@@ -82,7 +82,7 @@
   {
     "id": "files/file.list",
     "title": "file.list",
-    "summary": "List files with filtering. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, list \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "List files with filtering.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, list\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.list",
     "source": "generated",
     "contentPath": "files/file.list.md"
@@ -90,7 +90,7 @@
   {
     "id": "files/file.presignedUrl.create",
     "title": "file.presignedUrl.create",
-    "summary": "Create a presigned URL for direct upload. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, presigned, upload \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Create a presigned URL for direct upload.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, presigned, upload\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.presignedUrl.create",
     "source": "generated",
     "contentPath": "files/file.presignedUrl.create.md"
@@ -98,7 +98,7 @@
   {
     "id": "files/file.update",
     "title": "file.update",
-    "summary": "Update file metadata. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, update \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Update file metadata.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, update\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.update",
     "source": "generated",
     "contentPath": "files/file.update.md"
@@ -106,7 +106,7 @@
   {
     "id": "files/file.updated",
     "title": "file.updated",
-    "summary": "A file has been updated. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, update \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "A file has been updated.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, update\n- **File**: `packages/libs/files/src/events.ts`\n```typescript",
     "route": "/docs/reference/files/file.updated",
     "source": "generated",
     "contentPath": "files/file.updated.md"
@@ -114,7 +114,7 @@
   {
     "id": "files/file.upload",
     "title": "file.upload",
-    "summary": "Upload a new file. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, upload \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Upload a new file.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, upload\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.upload",
     "source": "generated",
     "contentPath": "files/file.upload.md"
@@ -122,7 +122,7 @@
   {
     "id": "files/file.uploaded",
     "title": "file.uploaded",
-    "summary": "A file has been uploaded. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, upload \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "A file has been uploaded.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, upload\n- **File**: `packages/libs/files/src/events.ts`\n```typescript",
     "route": "/docs/reference/files/file.uploaded",
     "source": "generated",
     "contentPath": "files/file.uploaded.md"
@@ -130,7 +130,7 @@
   {
     "id": "files/file.version_created",
     "title": "file.version_created",
-    "summary": "A new file version has been created. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, version, create \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "A new file version has been created.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, version, create\n- **File**: `packages/libs/files/src/events.ts`",
     "route": "/docs/reference/files/file.version_created",
     "source": "generated",
     "contentPath": "files/file.version_created.md"
@@ -138,7 +138,7 @@
   {
     "id": "files/file.version.create",
     "title": "file.version.create",
-    "summary": "Create a new version of a file. \n - **Type**: operation (command) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, version, create \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Create a new version of a file.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, version, create\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.version.create",
     "source": "generated",
     "contentPath": "files/file.version.create.md"
@@ -146,7 +146,7 @@
   {
     "id": "files/file.version.list",
     "title": "file.version.list",
-    "summary": "Get file version history. \n - **Type**: operation (query) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: platform.files \n - **Tags**: files, version, list \n - **File**: `packages/libs/files/src/contracts/index.ts`",
+    "summary": "Get file version history.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: platform.files\n- **Tags**: files, version, list\n- **File**: `packages/libs/files/src/contracts/index.ts`",
     "route": "/docs/reference/files/file.version.list",
     "source": "generated",
     "contentPath": "files/file.version.list.md"
@@ -154,7 +154,7 @@
   {
     "id": "files/files",
     "title": "files",
-    "summary": "File storage, attachments, and media processing with presigned URLs \n - **Type**: feature \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, upload, attachments, storage",
+    "summary": "File storage, attachments, and media processing with presigned URLs\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, upload, attachments, storage",
     "route": "/docs/reference/files/files",
     "source": "generated",
     "contentPath": "files/files.md"
@@ -162,7 +162,7 @@
   {
     "id": "files/upload.session_completed",
     "title": "upload.session_completed",
-    "summary": "An upload session has completed. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, upload, session, complete \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "An upload session has completed.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, upload, session, complete\n- **File**: `packages/libs/files/src/events.ts`",
     "route": "/docs/reference/files/upload.session_completed",
     "source": "generated",
     "contentPath": "files/upload.session_completed.md"
@@ -170,7 +170,7 @@
   {
     "id": "files/upload.session_started",
     "title": "upload.session_started",
-    "summary": "An upload session has started. \n - **Type**: event (event) \n - **Version**: 1.0.0 \n - **Stability**: stable \n - **Owners**: @platform.files \n - **Tags**: files, upload, session, start \n - **File**: `packages/libs/files/src/events.ts`",
+    "summary": "An upload session has started.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.files\n- **Tags**: files, upload, session, start\n- **File**: `packages/libs/files/src/events.ts`",
     "route": "/docs/reference/files/upload.session_started",
     "source": "generated",
     "contentPath": "files/upload.session_started.md"