Skip to content

docs(genui-sdk): update genui-sdk docs#86

Merged
kagol merged 5 commits intodevfrom
deploy/update-genui-sdk-docs
Feb 14, 2026
Merged

docs(genui-sdk): update genui-sdk docs#86
kagol merged 5 commits intodevfrom
deploy/update-genui-sdk-docs

Conversation

@gimmyhehe
Copy link
Member

@gimmyhehe gimmyhehe commented Feb 13, 2026

Summary by CodeRabbit

  • Documentation

    • Restructured site sidebar/navigation for TinyEditor and GenUI SDK for clearer grouping and discoverability
    • Split GenUI SDK guide into Vue, Angular and Server sections; expanded component, renderer, Chat and ConfigProvider examples and reorganized renderer-related content for consistency
    • Minor navigation formatting and alignment improvements
  • Chores

    • Added Angular SDK to the workspace and updated GenUI SDK dependency versions
    • Added a prebuild step and increased Node.js memory for builds

@gimmyhehe gimmyhehe changed the title docs(genui-sdk): update genui-sdk docs [wip]docs(genui-sdk): update genui-sdk docs Feb 13, 2026
@gimmyhehe gimmyhehe force-pushed the deploy/update-genui-sdk-docs branch from fd9f19b to 65888c2 Compare February 13, 2026 15:23
@coderabbitai
Copy link

coderabbitai bot commented Feb 13, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

Walkthrough

Reorganizes VitePress sidebar/navigation for TinyEditor and GenUI SDK, adds Angular packages to the pnpm workspace, updates genui SDK submodule pointer and genui package dependencies, and adjusts root build scripts (adds prebuild and increases Node heap).

Changes

Cohort / File(s) Summary
VitePress config
./.vitepress/config.mts
Reformatted sidebar/navigation objects: split TinyEditor entries into discrete top-level entries, expanded and restructured GenUI SDK navigation (added "快速开始", split Vue/Angular/Server guides, reorganized Renderer/examples and component/example nesting); changes are structural/formatting of navigation config.
Workspace manifest
pnpm-workspace.yaml
Added package globs: genui/genui-sdk/packages/frameworks/angular, genui/genui-sdk/packages/core, genui/genui-sdk/projects/tiny-schema-renderer-ng.
Root package scripts
package.json
Added prebuild script to run GenUI SDK core and Angular element builds; updated build to set NODE_OPTIONS="--max-old-space-size=8192" (keeps VP_MODE=production).
genui package deps
genui/package.json
Updated dependencies: replaced @opentiny/genui-sdk-vue from 1.0.0-beta.1 to 1.0.0, and added @opentiny/genui-sdk-angular as workspace:*.
Submodule pointer
genui/genui-sdk
Updated git submodule pointer from b0acc32... to 3a6b1c2... (submodule reference changed; no source edits in this diff).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐇 I hopped through sidebars, neat and spry,
Split paths and nested guides up high.
Added Angular, lifted build's might,
Submodule hopped forward into sight.
A carrot-clicked doc dance — quick and light.

🚥 Pre-merge checks | ✅ 3 | ❌ 1
❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title is vague and overly broad. It says 'update genui-sdk docs' but the actual changes include dependency updates, workspace configuration changes, build script modifications, and submodule pointer updates—not just documentation updates. Consider a more specific title that accurately reflects all major changes, such as 'chore(genui-sdk): update docs, dependencies, and build configuration' or break into multiple focused PRs.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into dev

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch deploy/update-genui-sdk-docs

No actionable comments were generated in the recent review. 🎉


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gimmyhehe gimmyhehe force-pushed the deploy/update-genui-sdk-docs branch from 4012a04 to 8c54cdf Compare February 14, 2026 07:26
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @.vitepress/config.mts:
- Around line 465-476: The menu object with text 'Renderer 组件' currently sets
base: '/genui-sdk' and uses absolute item links (leading '/'), causing the base
to be ignored; update the base to include a trailing slash (e.g., '/genui-sdk/')
and change each item link in the items array ({ text: '自定义 Actions', { text:
'配置缓冲字段', { text: '传递合并 State' }) to relative paths (remove the leading '/') so
links resolve under the base (e.g., 'examples/angular/renderer/custom-actions',
etc.).

Comment on lines +465 to +476
{
text: 'Renderer 组件',
base: '/genui-sdk',
items: [
{ text: '自定义 Actions', link: '/examples/angular/renderer/custom-actions' },
{
text: '配置缓冲字段',
link: '/examples/angular/renderer/required-complete-field-selectors'
},
{ text: '传递合并 State', link: '/examples/angular/renderer/state' }
]
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Same broken base/link pattern — Angular example links will misroute.

Same issue as the Server 指引 section: base: '/genui-sdk' with absolute links (leading /) means the base is ignored, resolving to /examples/angular/renderer/... instead of /genui-sdk/examples/angular/renderer/....

🐛 Proposed fix — use trailing slash on base and relative links
             {
               text: 'Renderer 组件',
-              base: '/genui-sdk',
+              base: '/genui-sdk/examples/angular/renderer/',
               items: [
-                { text: '自定义 Actions', link: '/examples/angular/renderer/custom-actions' },
+                { text: '自定义 Actions', link: 'custom-actions' },
                 {
                   text: '配置缓冲字段',
-                  link: '/examples/angular/renderer/required-complete-field-selectors'
+                  link: 'required-complete-field-selectors'
                 },
-                { text: '传递合并 State', link: '/examples/angular/renderer/state' }
+                { text: '传递合并 State', link: 'state' }
               ]
             }
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
{
text: 'Renderer 组件',
base: '/genui-sdk',
items: [
{ text: '自定义 Actions', link: '/examples/angular/renderer/custom-actions' },
{
text: '配置缓冲字段',
link: '/examples/angular/renderer/required-complete-field-selectors'
},
{ text: '传递合并 State', link: '/examples/angular/renderer/state' }
]
}
{
text: 'Renderer 组件',
base: '/genui-sdk/examples/angular/renderer/',
items: [
{ text: '自定义 Actions', link: 'custom-actions' },
{
text: '配置缓冲字段',
link: 'required-complete-field-selectors'
},
{ text: '传递合并 State', link: 'state' }
]
}
🤖 Prompt for AI Agents
In @.vitepress/config.mts around lines 465 - 476, The menu object with text
'Renderer 组件' currently sets base: '/genui-sdk' and uses absolute item links
(leading '/'), causing the base to be ignored; update the base to include a
trailing slash (e.g., '/genui-sdk/') and change each item link in the items
array ({ text: '自定义 Actions', { text: '配置缓冲字段', { text: '传递合并 State' }) to
relative paths (remove the leading '/') so links resolve under the base (e.g.,
'examples/angular/renderer/custom-actions', etc.).

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@genui/package.json`:
- Line 15: The dependency entry "@opentiny/genui-sdk-vue": "1.0.0-beta.2" in
package.json references a package version that doesn't exist; update
package.json to point to a published version (e.g., change the version string to
"1.0.0-alpha.2") or coordinate to publish "1.0.0-beta.2" before merging, then
run npm install / yarn install and verify CI passes; ensure the updated version
string appears only in the package.json dependency for "@opentiny/genui-sdk-vue"
so lockfiles can be regenerated.
- Line 14: The workspace reference "@opentiny/genui-sdk-angular" in
genui/package.json cannot be resolved because pnpm-workspace.yaml lists
incorrect package paths; open pnpm-workspace.yaml and update the package globs
to the actual repository locations for the SDK (the entries that currently point
to genui/genui-sdk/packages/frameworks/angular, genui/genui-sdk/packages/core,
genui/genui-sdk/projects/tiny-schema-renderer-ng) so they match where those
packages live, or remove/replace the workspace:* dependency in
genui/package.json if the package is not part of the monorepo; also verify the
prebuild script in genui/package.json references the corrected workspace package
names and paths so pnpm can resolve and build `@opentiny/genui-sdk-angular`
successfully.
🧹 Nitpick comments (1)
.vitepress/config.mts (1)

376-388: Inconsistent base/link patterns across guide sections.

The Vue section uses base: '/genui-sdk/guide/' with relative links, but Angular uses base: '/genui-sdk/' and Server uses base: '/genui-sdk' with a leading-slash link. While all three likely resolve correctly, the mixed conventions hurt readability and are error-prone.

Consider aligning all three sections:

♻️ Suggested alignment
         {
           text: 'GenUI SDK Angular 指引',
-          base: '/genui-sdk/',
+          base: '/genui-sdk/guide/angular/',
           items: [
-            { text: '安装与配置', link: 'guide/angular/install' },
-            { text: '使用 Renderer 组件', link: 'guide/angular/start-with-renderer' }
+            { text: '安装与配置', link: 'install' },
+            { text: '使用 Renderer 组件', link: 'start-with-renderer' }
           ]
         },
         {
           text: 'GenUI SDK Server 指引',
-          base: '/genui-sdk',
-          items: [{ text: 'Server 包使用文档', link: '/guide/server-usage' }]
+          base: '/genui-sdk/guide/',
+          items: [{ text: 'Server 包使用文档', link: 'server-usage' }]
         }

"license": "MIT",
"dependencies": {
"@opentiny/genui-sdk-vue": "1.0.0-beta.1"
"@opentiny/genui-sdk-angular": "workspace:*",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check pnpm-workspace.yaml for angular package inclusion
echo "=== pnpm-workspace.yaml ===" 
cat pnpm-workspace.yaml 2>/dev/null || echo "File not found"

echo -e "\n=== Root package.json build scripts ===" 
cat package.json | grep -A10 '"scripts"'

Repository: opentiny/docs

Length of output: 833


🏁 Script executed:

#!/bin/bash
# Check the angular package.json to verify the package name
find . -path "*genui-sdk/packages/frameworks/angular/package.json" -type f | head -1 | xargs cat

echo -e "\n=== Check genui/package.json dependencies ===" 
cat genui/package.json | grep -A5 -B5 "@opentiny/genui-sdk-angular"

Repository: opentiny/docs

Length of output: 371


🏁 Script executed:

#!/bin/bash
# Find and display angular package.json
cat genui/genui-sdk/packages/frameworks/angular/package.json 2>/dev/null | head -20 || echo "File not found at expected path"

# Alternative: search for it
echo -e "\n=== Searching for angular package.json ===" 
find . -name "package.json" -path "*/frameworks/angular/*" -type f -exec cat {} \; 2>/dev/null | head -20

Repository: opentiny/docs

Length of output: 100


🏁 Script executed:

#!/bin/bash
# List the directory structure to understand the workspace layout
echo "=== Checking genui-sdk structure ===" 
ls -la genui/genui-sdk/packages/frameworks/ 2>/dev/null || echo "Directory not found"

echo -e "\n=== List all files in genui-sdk ===" 
find genui/genui-sdk -maxdepth 3 -type d | head -20

echo -e "\n=== Search for any angular package.json ===" 
find . -name "package.json" | grep -i angular

Repository: opentiny/docs

Length of output: 211


🏁 Script executed:

#!/bin/bash
# Check what's actually in genui directory
echo "=== Contents of genui directory ===" 
ls -la genui/

echo -e "\n=== Contents of genui-sdk directory ===" 
ls -la genui/genui-sdk/

echo -e "\n=== All package.json files in the repo ===" 
find . -name "package.json" -type f | grep -v node_modules | sort

Repository: opentiny/docs

Length of output: 552


🏁 Script executed:

#!/bin/bash
# Check if the packages declared in pnpm-workspace.yaml actually exist
echo "=== Verifying packages declared in pnpm-workspace.yaml ===" 
pnpm_packages=(
  "tiny-robot"
  "genui"
  "genui/genui-sdk/packages/frameworks/angular"
  "genui/genui-sdk/packages/core"
  "genui/genui-sdk/projects/tiny-schema-renderer-ng"
)

for pkg in "${pnpm_packages[@]}"; do
  if [ -d "$pkg" ]; then
    echo "$pkg exists"
  else
    echo "$pkg DOES NOT EXIST"
  fi
done

echo -e "\n=== Check tiny-robot packages ===" 
find tiny-robot -maxdepth 2 -type f -name "package.json" 2>/dev/null | head -10

Repository: opentiny/docs

Length of output: 359


🏁 Script executed:

#!/bin/bash
# Check git status to see if packages are being ignored or missing
echo "=== Check git status ===" 
git status 2>/dev/null | head -30

echo -e "\n=== Check .gitignore for genui-sdk ===" 
cat .gitignore 2>/dev/null | grep -i genui

echo -e "\n=== Look for any `@opentiny` packages in node_modules (after install) ===" 
find node_modules/@opentiny -maxdepth 2 -type d 2>/dev/null | grep -i angular | head -10

Repository: opentiny/docs

Length of output: 394


Fix workspace package paths in pnpm-workspace.yaml — referenced packages do not exist.

The pnpm-workspace.yaml declares packages at paths that don't exist:

  • genui/genui-sdk/packages/frameworks/angular
  • genui/genui-sdk/packages/core
  • genui/genui-sdk/projects/tiny-schema-renderer-ng

The workspace:* reference to @opentiny/genui-sdk-angular in genui/package.json cannot resolve. The prebuild script will also fail attempting to build a non-existent package. Verify the correct paths for these workspace packages in the repository and update pnpm-workspace.yaml accordingly.

🤖 Prompt for AI Agents
In `@genui/package.json` at line 14, The workspace reference
"@opentiny/genui-sdk-angular" in genui/package.json cannot be resolved because
pnpm-workspace.yaml lists incorrect package paths; open pnpm-workspace.yaml and
update the package globs to the actual repository locations for the SDK (the
entries that currently point to genui/genui-sdk/packages/frameworks/angular,
genui/genui-sdk/packages/core, genui/genui-sdk/projects/tiny-schema-renderer-ng)
so they match where those packages live, or remove/replace the workspace:*
dependency in genui/package.json if the package is not part of the monorepo;
also verify the prebuild script in genui/package.json references the corrected
workspace package names and paths so pnpm can resolve and build
`@opentiny/genui-sdk-angular` successfully.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

Build is broken: @opentiny/genui-sdk-vue@1.0.0-beta.2 does not exist.

The CI pipeline confirms this version isn't published — the latest release is 1.0.0-alpha.2. Either publish the beta.2 package first or pin to an existing version (e.g., 1.0.0-alpha.2).

🤖 Prompt for AI Agents
In `@genui/package.json` at line 15, The dependency entry
"@opentiny/genui-sdk-vue": "1.0.0-beta.2" in package.json references a package
version that doesn't exist; update package.json to point to a published version
(e.g., change the version string to "1.0.0-alpha.2") or coordinate to publish
"1.0.0-beta.2" before merging, then run npm install / yarn install and verify CI
passes; ensure the updated version string appears only in the package.json
dependency for "@opentiny/genui-sdk-vue" so lockfiles can be regenerated.

@gimmyhehe gimmyhehe changed the title [wip]docs(genui-sdk): update genui-sdk docs docs(genui-sdk): update genui-sdk docs Feb 14, 2026
@kagol kagol merged commit 70001e2 into dev Feb 14, 2026
4 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

Comments