[pull] main from TryGhost:main

.changeset/common-squids-argue.md

@@ -0,0 +1,15 @@
+---
+"@tryghost/kg-utils": patch
+"@tryghost/kg-unsplash-selector": patch
+"@tryghost/kg-markdown-html-renderer": patch
+"@tryghost/kg-lexical-html-renderer": patch
+"@tryghost/kg-html-to-lexical": patch
+"@tryghost/kg-default-transforms": patch
+"@tryghost/kg-default-nodes": patch
+"@tryghost/kg-default-cards": patch
+"@tryghost/kg-converters": patch
+"@tryghost/kg-clean-basic-html": patch
+"@tryghost/kg-card-factory": patch
+---
+
+Documented the package API and corrected the development instructions in the README

.changeset/funky-bikes-chew.md

@@ -0,0 +1,5 @@
+---
+"@tryghost/koenig-lexical": patch
+---
+
+Updated the test commands in the README

.changeset/olive-regions-stop.md

@@ -0,0 +1,5 @@
+---
+"@tryghost/koenig-lexical": patch
+---
+
+Added a package description for npm

.github/workflows/ci.yml

@@ -173,9 +173,9 @@ jobs:
               - '.github/workflows/ci.yml'
             core:
               - *shared
-              # Repository documentation and ownership metadata do not affect
-              # Ghost runtime behaviour, even though they live in .github.
-              - '!.github/**/*.md'
+              # Documentation and ownership metadata do not affect Ghost
+              # runtime behaviour, even when they live inside a project root.
+              - '!**/*.md'
               - '!.github/CODEOWNERS'
               - 'ghost/**'
               - '!ghost/core/core/server/data/tinybird/**'
@@ -234,6 +234,18 @@ jobs:
       - name: Determine Affected Projects
         id: affected
         run: |
+          # Nx treats README files as project inputs. Avoid populating code-test
+          # matrices when every changed file is documentation.
+          if [[ "${{ env.IS_TAG }}" != 'true' && "${{ steps.changed.outputs.any-code }}" != 'true' ]]; then
+            echo 'affected_projects=[]' >> "$GITHUB_OUTPUT"
+            echo 'affected_projects_str=' >> "$GITHUB_OUTPUT"
+            echo 'unit_test_projects_str=' >> "$GITHUB_OUTPUT"
+            echo 'affected_i18n_projects=' >> "$GITHUB_OUTPUT"
+            echo 'affected_playwright_projects=[]' >> "$GITHUB_OUTPUT"
+            echo 'publish_public_apps_matrix=[]' >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
           # if the ci files have changed or we're in a tag, ensure we don't just look at affected
           # projects and we run the necessary jobs on all projects
           AFFECTED_ARG="--affected"

AGENTS.md

@@ -88,7 +88,7 @@ import Interpolate from '@doist/react-interpolate';
 {t('Could not sign in.')} <a href={link}>{t('Click here to retry')}</a>
 ```
 
-See `apps/portal/src/components/pages/email-receiving-faq.js` for a canonical example of correct `Interpolate` usage.
+See `apps/portal/src/components/pages/email-receiving-faq.jsx` for a canonical example of correct `Interpolate` usage.
 
 ### Build Dependencies (Nx)