feat(richtext): type richtext field value from OpenAPI spec

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "bracketSpacing": true,
+  "printWidth": 80,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package.json

@@ -30,11 +30,6 @@
   "resolutions": {
     "cypress": "^14.3.3"
   },
-  "pnpm": {
-    "overrides": {
-      "happy-dom": "^20.8.8"
-    }
-  },
   "dependencies": {
     "cypress": "^14.3.3"
   }

packages/angular/src/lib/richtext/rich-text.component.spec.ts

@@ -162,7 +162,11 @@ describe('SbRichTextComponent', () => {
   });
   describe('custom renderers', () => {
     it('overrides node rendering with custom component', async () => {
-      const node: SbRichTextNode = { type: 'paragraph', content: [text('Hello')] };
+      const node: SbRichTextNode = {
+        type: 'paragraph',
+        attrs: { textAlign: null },
+        content: [text('Hello')],
+      };
       TestBed.resetTestingModule();
       await TestBed.configureTestingModule({
         imports: [SbRichTextComponent],
@@ -198,6 +202,7 @@ describe('SbRichTextComponent', () => {
 
       const node: SbRichTextNode = {
         type: 'paragraph',
+        attrs: { textAlign: null },
         content: [text('Bold Link', [{ type: 'bold' }, linkMark('https://example.com')])],
       };
       fixture.componentRef.setInput('sbDocument', node);
@@ -314,9 +319,9 @@ describe('SbRichTextComponent', () => {
       const content: SbRichTextDoc = {
         type: 'doc',
         content: [
-          { type: 'paragraph', content: [text('Before')] },
+          { type: 'paragraph', attrs: { textAlign: null }, content: [text('Before')] },
           { type: 'blok', attrs: { id: 'x', body: [{ _uid: '1', component: 'test' }] } },
-          { type: 'paragraph', content: [text('After')] },
+          { type: 'paragraph', attrs: { textAlign: null }, content: [text('After')] },
         ],
       };
       fixture.componentRef.setInput('sbDocument', content);
@@ -431,9 +436,9 @@ describe('SbRichTextComponent', () => {
       const doc: SbRichTextDoc = {
         type: 'doc',
         content: [
-          { type: 'paragraph', content: [text('Before image')] },
+          { type: 'paragraph', attrs: { textAlign: null }, content: [text('Before image')] },
           imageNode,
-          { type: 'paragraph', content: [text('After image')] },
+          { type: 'paragraph', attrs: { textAlign: null }, content: [text('After image')] },
         ],
       };
       fixture.componentRef.setInput('sbDocument', doc);

packages/cli/package.json

@@ -36,6 +36,7 @@
     "dist/**"
   ],
   "scripts": {
+    "generate:openapi": "node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/generate.ts",
     "build": "unbuild",
     "release": "release-it",
     "dev": "pnpm run build && node dist/index.mjs",
@@ -47,6 +48,31 @@
     "test:ui": "vitest --ui",
     "coverage": "vitest run --coverage"
   },
+  "nx": {
+    "targets": {
+      "generate:openapi": {
+        "inputs": [
+          "{projectRoot}/scripts/generate.ts",
+          "openapiCodegen"
+        ],
+        "outputs": [
+          "{projectRoot}/src/generated"
+        ],
+        "cache": true,
+        "dependsOn": [
+          "@storyblok/openapi-codegen:build"
+        ]
+      },
+      "build": {
+        "dependsOn": [
+          "^build"
+        ],
+        "outputs": [
+          "{projectRoot}/dist/**"
+        ]
+      }
+    }
+  },
   "dependencies": {
     "@inquirer/prompts": "^7.5.1",
     "@storyblok/js": "workspace:*",
@@ -72,6 +98,7 @@
   "devDependencies": {
     "@release-it/conventional-changelog": "10.0.0",
     "@storyblok/eslint-config": "workspace:*",
+    "@storyblok/openapi-codegen": "workspace:*",
     "@types/cli-progress": "^3.11.6",
     "@types/inquirer": "^9.0.8",
     "@types/node": "^24.11.0",

packages/cli/scripts/generate.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env -S node --experimental-strip-types --no-warnings=ExperimentalWarning
+/**
+ * Generates `storyblok` CLI's OpenAPI-derived richtext types from the pinned
+ * overlay spec cache. Produces `RichtextDoc`, `RichTextNode`, and
+ * `RichTextMark` in `src/generated/` — the types for the richtext document
+ * format consumed by story content.
+ *
+ * Re-run after `pnpm --filter @storyblok/openapi-codegen pull[:update]`.
+ */
+
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { generate } from '@storyblok/openapi-codegen';
+import { execSync } from 'node:child_process';
+
+const PKG_ROOT = resolve(fileURLToPath(import.meta.url), '../..');
+
+await generate({
+  outDir: resolve(PKG_ROOT, 'src/generated'),
+  include: ['RichtextDoc', 'RichTextNode', 'RichTextMark'],
+});
+const GENERATED_PATH = resolve(PKG_ROOT, 'src/generated');
+execSync(`pnpm eslint ${GENERATED_PATH} --fix`, {
+  stdio: 'inherit',
+});