@vigilkids/section-renderer-vue 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present VigilKids
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @vigilkids/section-renderer-vue
+
+Vue 3 rendering engine for OneX Section system. Renders section-based content with product-aware component resolution, lazy loading, inline editing, and editor preview support.
+
+## Install
+
+```bash
+pnpm add @vigilkids/section-renderer-vue
+```
+
+**Peer Dependencies:**
+- `vue` ≥ 3.4
+- `@vigilkids/section-core` (workspace)
+
+## Usage
+
+### Frontend (Nuxt/Vue app)
+
+```vue
+<script setup>
+import { SectionRenderer, registerArticleSections, SectionRendererPlugin } from '@vigilkids/section-renderer-vue'
+
+// Register built-in article sections (call once at app startup)
+registerArticleSections()
+</script>
+
+<template>
+  <SectionRenderer
+    :sections-data="article.content_json"
+    :product-code="'visiva'"
+  />
+</template>
+```
+
+### Admin Preview (iframe)
+
+```typescript
+import { createPreviewApp } from '@vigilkids/section-renderer-vue/editor'
+
+createPreviewApp('#app', {
+  bridge: { send, on },
+  onSectionClick: (id) => { /* select section */ },
+})
+```
+
+### Product Styles
+
+```typescript
+// Import product-specific article CSS
+import '@vigilkids/section-renderer-vue/styles/vigilkids'
+import '@vigilkids/section-renderer-vue/styles/visiva'
+```
+
+## Components
+
+| Component | Purpose |
+|-----------|---------|
+| `SectionRenderer` | Root renderer — iterates sections, resolves components |
+| `SectionWrapper` | Per-section container with editor-mode highlights |
+| `LazySection` | IntersectionObserver lazy loading with CLS prevention |
+| `SectionErrorBoundary` | Graceful error fallback per section |
+| `FallbackSection` | Placeholder for unregistered section types |
+
+## Composables
+
+| Composable | Purpose |
+|------------|---------|
+| `useInlineEdit` | contentEditable inline text editing (double-click to edit) |
+| `useRegistry` | Product-aware section component registration and resolution |
+| `useSectionStyle` | Semantic tokens → Tailwind classes + inline styles |
+| `useSectionSEO` | JSON-LD structured data generation |
+| `useLazyRender` | IntersectionObserver visibility detection |
+
+## Section Components
+
+28 article sections across 2 products (VigilKids + Visiva) + 2 shared:
+
+`article-heading`, `article-subheading`, `article-image`, `article-bullet-list`, `article-step-list`, `article-notice`, `article-quote`, `article-question`, `article-pros-cons`, `article-feature`, `article-cta`, `article-faq`, `article-table`, `article-toc`, `article-custom-html`
+
+## Compatibility
+
+- Vue ≥ 3.4
+- Node.js ≥ 18
+- ESM only
+
+## License
+
+[MIT](./LICENSE)

package/dist/assets/images/article/arrow.svg

@@ -0,0 +1,3 @@
+<svg width="21" height="12" viewBox="0 0 21 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M20.5303 6.53033C20.8232 6.23744 20.8232 5.76256 20.5303 5.46967L15.7574 0.696699C15.4645 0.403806 14.9896 0.403806 14.6967 0.696699C14.4038 0.989593 14.4038 1.46447 14.6967 1.75736L18.9393 6L14.6967 10.2426C14.4038 10.5355 14.4038 11.0104 14.6967 11.3033C14.9896 11.5962 15.4645 11.5962 15.7574 11.3033L20.5303 6.53033ZM0 6V6.75H20V6V5.25H0V6Z" fill="#24C790"/>
+</svg>

package/dist/assets/images/article/hot.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M10.5479 11.9702C10.0966 11.9702 9.71456 12.5389 9.71456 13.2188C9.71456 13.8948 10.0966 14.4668 10.5479 14.4668C10.9992 14.4668 11.3819 13.8968 11.3819 13.2175C11.3819 12.5389 10.9999 11.9689 10.5485 11.9689L10.5479 11.9702ZM15.3977 3.54841C15.3258 3.46817 15.2338 3.40848 15.1312 3.37545C15.0286 3.34242 14.919 3.33723 14.8138 3.36042C14.6018 3.41108 14.4271 3.57374 14.3471 3.79507C14.1688 4.31816 14.0036 4.84565 13.8518 5.37704C13.6385 4.93438 13.3985 4.50972 13.1318 4.10374C12.1478 2.60444 10.7985 1.3318 8.88657 0.0985037C8.7956 0.0391916 8.69032 0.00547728 8.58182 0.000902909C8.47331 -0.00367146 8.36558 0.021063 8.26993 0.0725076C8.17116 0.129583 8.08767 0.209723 8.02661 0.306079C7.96554 0.402435 7.92871 0.512143 7.91927 0.625828C7.65327 3.22973 7.16395 5.86901 5.492 7.72696L5.27001 7.25364C5.0747 6.84432 4.89202 6.45901 4.7747 6.12901C4.64802 5.76569 4.27671 5.5837 3.94538 5.72237C3.7931 5.78848 3.67093 5.90898 3.60272 6.06034L3.46806 6.347C2.64741 8.08696 1.52544 10.4736 1.3561 12.4915C1.00477 16.7687 4.55669 19.4567 8.25059 19.9033C9.06192 20.0013 9.87722 20.0233 10.6919 19.9733C13.5965 19.784 17.125 18.1554 18.3143 14.1468C19.0843 11.5449 18.7837 7.21032 15.3977 3.54708V3.54774V3.54841ZM7.82794 15.1521C7.82794 15.4901 7.57528 15.7655 7.26462 15.7655C6.95464 15.7668 6.70329 15.4921 6.70196 15.1521V13.7588L5.542 13.7788V15.1861C5.542 15.5234 5.28934 15.7994 4.97868 15.7994C4.66936 15.8008 4.41669 15.5261 4.41536 15.1861V11.4189C4.41536 11.0802 4.66735 10.8056 4.97868 10.8056C5.28934 10.8056 5.54134 11.0802 5.54134 11.4189V12.5515L6.70196 12.5322V11.3855C6.70196 11.0469 6.95395 10.7716 7.26462 10.7716C7.57528 10.7716 7.82727 11.0469 7.82727 11.3849V15.1515H7.82794V15.1521ZM10.5479 15.6908C9.4679 15.6908 8.59059 14.5801 8.59059 13.2155C8.59059 11.8509 9.4679 10.7402 10.5479 10.7402C11.6278 10.7402 12.5078 11.8509 12.5078 13.2155C12.5065 14.5801 11.6278 15.6908 10.5479 15.6908V15.6908ZM15.6504 12.1022H14.9351V15.1188C14.9351 15.4568 14.6838 15.7321 14.3731 15.7321C14.0631 15.7334 13.8111 15.4588 13.8091 15.1188V12.1022H13.0951C13.0202 12.1022 12.9461 12.0862 12.8778 12.0553C12.8095 12.0244 12.7486 11.9792 12.6991 11.9229C12.5931 11.8023 12.5339 11.6475 12.5325 11.4869C12.5325 11.1482 12.7845 10.8736 13.0951 10.8736H15.6484C15.9591 10.8736 16.2104 11.1482 16.2104 11.4869C16.2099 11.6477 16.1506 11.8028 16.0437 11.9229C15.9951 11.9796 15.9348 12.0251 15.8669 12.0562C15.799 12.0872 15.7251 12.1032 15.6504 12.1029V12.1022Z" fill="#F74343"/>
+</svg>

package/dist/assets/images/article/notice-info-icon.svg

@@ -0,0 +1,5 @@
+<svg width="142" height="40" viewBox="0 0 142 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M0 0H142L132.921 27.6208C130.493 35.0074 123.596 40 115.821 40H26.179C18.4036 40 11.5071 35.0074 9.07906 27.6208L0 0Z" fill="#24C790"/>
+<path d="M51.1531 30.9568H51.1203C50.1031 30.9459 49.0832 30.9459 48.0633 30.9459H46.5074C45.4684 30.9459 44.4293 30.9459 43.3875 30.9322C42.8105 30.9158 42.2418 30.7955 41.7059 30.5768C40.7953 30.2213 40.2758 29.4283 40.2785 28.3975L40.2812 24.5311C40.2812 22.39 40.2813 20.2463 40.3004 18.1053C40.3031 17.5229 40.6777 16.976 40.9977 16.6889C42.2363 15.5568 43.5816 14.1459 44.1449 12.2428C44.3008 11.7123 44.3609 11.1271 44.4238 10.5092C44.5496 9.27871 45.348 8.47754 46.4145 8.47754C46.8328 8.47754 47.2512 8.60332 47.6613 8.84668C48.4844 9.3416 49.034 10.1182 49.3375 11.2256C49.8242 12.9838 49.5754 14.69 49.302 16.1529V16.1584C49.2391 16.5002 49.4961 16.8174 49.8461 16.8174H53.4008C54.0133 16.8174 54.891 16.8939 55.4324 17.5502C55.8262 18.0287 55.9383 18.674 55.7715 19.5271C55.2629 22.1494 54.6395 24.7936 54.0434 27.2572C53.8574 28.0256 53.5484 28.7365 53.2504 29.4256L53.1219 29.7209C52.7828 30.5193 52.0828 30.9568 51.1531 30.9568ZM35.909 30.6998H35.5836C34.4078 30.6998 33.4453 29.7373 33.4453 28.5615V19.0322C33.4453 17.8564 34.4078 16.8939 35.5836 16.8939H35.909C37.0848 16.8939 38.0473 17.8564 38.0473 19.0322V28.5588C38.05 29.7373 37.0875 30.6998 35.909 30.6998Z" fill="white"/>
+<path d="M76.8066 21.9316H73.1836V19.6465H76.8066C77.3665 19.6465 77.8223 19.5553 78.1738 19.373C78.5254 19.1842 78.7826 18.9238 78.9453 18.5918C79.1081 18.2598 79.1895 17.8854 79.1895 17.4688C79.1895 17.0456 79.1081 16.6517 78.9453 16.2871C78.7826 15.9225 78.5254 15.6296 78.1738 15.4082C77.8223 15.1868 77.3665 15.0762 76.8066 15.0762H74.1992V27H71.2695V12.7812H76.8066C77.9199 12.7812 78.8737 12.9831 79.668 13.3867C80.4688 13.7839 81.0807 14.334 81.5039 15.0371C81.9271 15.7402 82.1387 16.5443 82.1387 17.4492C82.1387 18.3672 81.9271 19.1615 81.5039 19.832C81.0807 20.5026 80.4688 21.0202 79.668 21.3848C78.8737 21.7493 77.9199 21.9316 76.8066 21.9316ZM86.7969 18.7383V27H83.9844V16.4336H86.6309L86.7969 18.7383ZM89.9805 16.3652L89.9316 18.9727C89.7949 18.9531 89.6289 18.9368 89.4336 18.9238C89.2448 18.9043 89.0723 18.8945 88.916 18.8945C88.5189 18.8945 88.1738 18.9466 87.8809 19.0508C87.5944 19.1484 87.3535 19.2949 87.1582 19.4902C86.9694 19.6855 86.8262 19.9232 86.7285 20.2031C86.6374 20.4831 86.5853 20.8021 86.5723 21.1602L86.0059 20.9844C86.0059 20.3008 86.0742 19.6725 86.2109 19.0996C86.3477 18.5202 86.5462 18.0156 86.8066 17.5859C87.0736 17.1562 87.3991 16.8242 87.7832 16.5898C88.1673 16.3555 88.6068 16.2383 89.1016 16.2383C89.2578 16.2383 89.4173 16.2513 89.5801 16.2773C89.7428 16.2969 89.8763 16.3262 89.9805 16.3652ZM90.5664 21.8242V21.6191C90.5664 20.8444 90.6771 20.1315 90.8984 19.4805C91.1198 18.8229 91.4421 18.2533 91.8652 17.7715C92.2884 17.2897 92.8092 16.9154 93.4277 16.6484C94.0462 16.375 94.7559 16.2383 95.5566 16.2383C96.3574 16.2383 97.0703 16.375 97.6953 16.6484C98.3203 16.9154 98.8444 17.2897 99.2676 17.7715C99.6973 18.2533 100.023 18.8229 100.244 19.4805C100.465 20.1315 100.576 20.8444 100.576 21.6191V21.8242C100.576 22.5924 100.465 23.3053 100.244 23.9629C100.023 24.6139 99.6973 25.1836 99.2676 25.6719C98.8444 26.1536 98.3236 26.528 97.7051 26.7949C97.0866 27.0618 96.377 27.1953 95.5762 27.1953C94.7754 27.1953 94.0625 27.0618 93.4375 26.7949C92.819 26.528 92.2949 26.1536 91.8652 25.6719C91.4421 25.1836 91.1198 24.6139 90.8984 23.9629C90.6771 23.3053 90.5664 22.5924 90.5664 21.8242ZM93.3789 21.6191V21.8242C93.3789 22.2669 93.418 22.6803 93.4961 23.0645C93.5742 23.4486 93.6979 23.7871 93.8672 24.0801C94.043 24.3665 94.2708 24.5911 94.5508 24.7539C94.8307 24.9167 95.1725 24.998 95.5762 24.998C95.9668 24.998 96.3021 24.9167 96.582 24.7539C96.862 24.5911 97.0866 24.3665 97.2559 24.0801C97.4251 23.7871 97.5488 23.4486 97.627 23.0645C97.7116 22.6803 97.7539 22.2669 97.7539 21.8242V21.6191C97.7539 21.1895 97.7116 20.7858 97.627 20.4082C97.5488 20.0241 97.4219 19.6855 97.2461 19.3926C97.0768 19.0931 96.8522 18.8587 96.5723 18.6895C96.2923 18.5202 95.9538 18.4355 95.5566 18.4355C95.1595 18.4355 94.821 18.5202 94.541 18.6895C94.2676 18.8587 94.043 19.0931 93.8672 19.3926C93.6979 19.6855 93.5742 20.0241 93.4961 20.4082C93.418 20.7858 93.3789 21.1895 93.3789 21.6191ZM108.018 24.0801C108.018 23.8783 107.959 23.696 107.842 23.5332C107.725 23.3704 107.507 23.2207 107.188 23.084C106.875 22.9408 106.423 22.8105 105.83 22.6934C105.296 22.5762 104.798 22.4297 104.336 22.2539C103.88 22.0716 103.483 21.8535 103.145 21.5996C102.812 21.3457 102.552 21.0462 102.363 20.7012C102.174 20.3496 102.08 19.9492 102.08 19.5C102.08 19.0573 102.174 18.6406 102.363 18.25C102.559 17.8594 102.835 17.5143 103.193 17.2148C103.558 16.9089 104.001 16.6712 104.521 16.502C105.049 16.3262 105.641 16.2383 106.299 16.2383C107.217 16.2383 108.005 16.3848 108.662 16.6777C109.326 16.9707 109.834 17.3743 110.186 17.8887C110.544 18.3965 110.723 18.9759 110.723 19.627H107.91C107.91 19.3535 107.852 19.1094 107.734 18.8945C107.624 18.6732 107.448 18.5007 107.207 18.377C106.973 18.2467 106.667 18.1816 106.289 18.1816C105.977 18.1816 105.706 18.237 105.479 18.3477C105.251 18.4518 105.075 18.5951 104.951 18.7773C104.834 18.9531 104.775 19.1484 104.775 19.3633C104.775 19.526 104.808 19.6725 104.873 19.8027C104.945 19.9264 105.059 20.0404 105.215 20.1445C105.371 20.2487 105.573 20.3464 105.82 20.4375C106.074 20.5221 106.387 20.6003 106.758 20.6719C107.52 20.8281 108.2 21.0332 108.799 21.2871C109.398 21.5345 109.873 21.873 110.225 22.3027C110.576 22.7259 110.752 23.2826 110.752 23.9727C110.752 24.4414 110.648 24.8711 110.439 25.2617C110.231 25.6523 109.932 25.9941 109.541 26.2871C109.15 26.5736 108.682 26.7982 108.135 26.9609C107.594 27.1172 106.986 27.1953 106.309 27.1953C105.326 27.1953 104.492 27.0195 103.809 26.668C103.132 26.3164 102.617 25.8704 102.266 25.3301C101.921 24.7832 101.748 24.2233 101.748 23.6504H104.414C104.427 24.0345 104.525 24.3438 104.707 24.5781C104.896 24.8125 105.133 24.9818 105.42 25.0859C105.713 25.1901 106.029 25.2422 106.367 25.2422C106.732 25.2422 107.035 25.1934 107.275 25.0957C107.516 24.9915 107.699 24.8548 107.822 24.6855C107.952 24.5098 108.018 24.3079 108.018 24.0801Z" fill="white"/>
+</svg>

package/dist/assets/images/article/notice-info.svg

@@ -0,0 +1,3 @@
+<svg width="30" height="30" viewBox="0 0 30 30" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M14.9466 1.89697C7.72213 1.89697 1.84375 7.77539 1.84375 14.9999C1.84375 22.2253 7.72111 28.1027 14.9466 28.1027C22.1721 28.1027 28.0495 22.2253 28.0495 14.9999C28.0495 7.77539 22.1721 1.89697 14.9466 1.89697ZM21.2697 12.8385L13.7424 20.4476C13.7405 20.4495 13.7368 20.4505 13.7348 20.4533C13.7321 20.4552 13.7321 20.4589 13.7292 20.4608C13.6691 20.519 13.5948 20.5548 13.5252 20.5943C13.4905 20.6139 13.4623 20.6441 13.4256 20.6582C13.3128 20.7034 13.1934 20.7268 13.0739 20.7268C12.9536 20.7268 12.8324 20.7034 12.7186 20.6563C12.681 20.6404 12.6509 20.6084 12.6152 20.5886C12.5456 20.5491 12.4733 20.5143 12.4131 20.4552C12.4112 20.4533 12.4102 20.4495 12.4083 20.4476C12.4065 20.4448 12.4027 20.4448 12.4009 20.4419L8.69884 16.6374C8.33693 16.2652 8.34538 15.6702 8.71764 15.3082C9.08987 14.9472 9.684 14.9538 10.0469 15.3271L13.0805 18.4443L19.9337 11.5159C20.2985 11.1465 20.8945 11.1428 21.2631 11.5084C21.6305 11.874 21.6343 12.4692 21.2697 12.8385Z" fill="#24C790"/>
+</svg>

package/dist/assets/images/article/notice-warning-icon.svg

@@ -0,0 +1,5 @@
+<svg width="142" height="40" viewBox="0 0 142 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M0 0H142L132.921 27.6208C130.493 35.0074 123.596 40 115.821 40H26.179C18.4036 40 11.5071 35.0074 9.07906 27.6208L0 0Z" fill="#F1631C"/>
+<path d="M38.1398 8.47773L38.1727 8.47773C39.1898 8.48867 40.2098 8.48867 41.2297 8.48867L42.7855 8.48867C43.8246 8.48867 44.8637 8.48867 45.9055 8.50234C46.4824 8.51875 47.0512 8.63906 47.5871 8.85781C48.4977 9.21328 49.0172 10.0062 49.0145 11.0371L49.0117 14.9035C49.0117 17.0445 49.0117 19.1883 48.9926 21.3293C48.9898 21.9117 48.6152 22.4586 48.2953 22.7457C47.0566 23.8777 45.7113 25.2887 45.148 27.1918C44.9922 27.7223 44.932 28.3074 44.8691 28.9254C44.7434 30.1559 43.9449 30.957 42.8785 30.957C42.4602 30.957 42.0418 30.8312 41.6316 30.5879C40.8086 30.093 40.259 29.3164 39.9555 28.209C39.4688 26.4508 39.7176 24.7445 39.991 23.2816L39.991 23.2762C40.0539 22.9344 39.7969 22.6172 39.4469 22.6172L35.8922 22.6172C35.2797 22.6172 34.402 22.5406 33.8605 21.8844C33.4668 21.4059 33.3547 20.7605 33.5215 19.9074C34.0301 17.2852 34.6535 14.641 35.2496 12.1773C35.4355 11.409 35.7445 10.698 36.0426 10.009L36.1711 9.71367C36.5102 8.91523 37.2102 8.47773 38.1398 8.47773ZM53.384 8.73477L53.7094 8.73477C54.8852 8.73477 55.8477 9.69727 55.8477 10.873L55.8477 20.4023C55.8477 21.5781 54.8852 22.5406 53.7094 22.5406L53.384 22.5406C52.2082 22.5406 51.2457 21.5781 51.2457 20.4023L51.2457 10.8758C51.243 9.69727 52.2055 8.73477 53.384 8.73477Z" fill="white"/>
+<path d="M79.5117 22.2832H82.4316C82.373 23.2402 82.1094 24.0898 81.6406 24.832C81.1784 25.5742 80.5306 26.1536 79.6973 26.5703C78.8704 26.987 77.8743 27.1953 76.709 27.1953C75.7975 27.1953 74.9805 27.0391 74.2578 26.7266C73.5352 26.4076 72.9167 25.9518 72.4023 25.3594C71.8945 24.7669 71.5072 24.0508 71.2402 23.2109C70.9733 22.3711 70.8398 21.4303 70.8398 20.3887V19.4023C70.8398 18.3607 70.9766 17.4199 71.25 16.5801C71.5299 15.7337 71.9271 15.0143 72.4414 14.4219C72.9622 13.8294 73.584 13.3737 74.3066 13.0547C75.0293 12.7357 75.8366 12.5762 76.7285 12.5762C77.9134 12.5762 78.9128 12.791 79.7266 13.2207C80.5469 13.6504 81.1816 14.2428 81.6309 14.998C82.0866 15.7533 82.36 16.6126 82.4512 17.5762H79.5215C79.4889 17.0033 79.375 16.5182 79.1797 16.1211C78.9844 15.7174 78.6882 15.4147 78.291 15.2129C77.9004 15.0046 77.3796 14.9004 76.7285 14.9004C76.2402 14.9004 75.8138 14.9915 75.4492 15.1738C75.0846 15.3561 74.7786 15.6328 74.5312 16.0039C74.2839 16.375 74.0983 16.8438 73.9746 17.4102C73.8574 17.9701 73.7988 18.6276 73.7988 19.3828V20.3887C73.7988 21.1243 73.8542 21.7721 73.9648 22.332C74.0755 22.8854 74.2448 23.3542 74.4727 23.7383C74.707 24.1159 75.0065 24.4023 75.3711 24.5977C75.7422 24.7865 76.1882 24.8809 76.709 24.8809C77.321 24.8809 77.8255 24.7832 78.2227 24.5879C78.6198 24.3926 78.9225 24.1029 79.1309 23.7188C79.3457 23.3346 79.4727 22.8561 79.5117 22.2832ZM83.7305 21.8242V21.6191C83.7305 20.8444 83.8411 20.1315 84.0625 19.4805C84.2839 18.8229 84.6061 18.2533 85.0293 17.7715C85.4525 17.2897 85.9733 16.9154 86.5918 16.6484C87.2103 16.375 87.9199 16.2383 88.7207 16.2383C89.5215 16.2383 90.2344 16.375 90.8594 16.6484C91.4844 16.9154 92.0085 17.2897 92.4316 17.7715C92.8613 18.2533 93.1868 18.8229 93.4082 19.4805C93.6296 20.1315 93.7402 20.8444 93.7402 21.6191V21.8242C93.7402 22.5924 93.6296 23.3053 93.4082 23.9629C93.1868 24.6139 92.8613 25.1836 92.4316 25.6719C92.0085 26.1536 91.4876 26.528 90.8691 26.7949C90.2507 27.0618 89.541 27.1953 88.7402 27.1953C87.9395 27.1953 87.2266 27.0618 86.6016 26.7949C85.9831 26.528 85.459 26.1536 85.0293 25.6719C84.6061 25.1836 84.2839 24.6139 84.0625 23.9629C83.8411 23.3053 83.7305 22.5924 83.7305 21.8242ZM86.543 21.6191V21.8242C86.543 22.2669 86.582 22.6803 86.6602 23.0645C86.7383 23.4486 86.862 23.7871 87.0312 24.0801C87.207 24.3665 87.4349 24.5911 87.7148 24.7539C87.9948 24.9167 88.3366 24.998 88.7402 24.998C89.1309 24.998 89.4661 24.9167 89.7461 24.7539C90.026 24.5911 90.2507 24.3665 90.4199 24.0801C90.5892 23.7871 90.7129 23.4486 90.791 23.0645C90.8757 22.6803 90.918 22.2669 90.918 21.8242V21.6191C90.918 21.1895 90.8757 20.7858 90.791 20.4082C90.7129 20.0241 90.5859 19.6855 90.4102 19.3926C90.2409 19.0931 90.0163 18.8587 89.7363 18.6895C89.4564 18.5202 89.1178 18.4355 88.7207 18.4355C88.3236 18.4355 87.985 18.5202 87.7051 18.6895C87.4316 18.8587 87.207 19.0931 87.0312 19.3926C86.862 19.6855 86.7383 20.0241 86.6602 20.4082C86.582 20.7858 86.543 21.1895 86.543 21.6191ZM98.2227 18.6895V27H95.4102V16.4336H98.0469L98.2227 18.6895ZM97.8125 21.3457H97.0508C97.0508 20.5645 97.1517 19.8613 97.3535 19.2363C97.5553 18.6048 97.8385 18.0677 98.2031 17.625C98.5677 17.1758 99.0007 16.834 99.502 16.5996C100.01 16.3587 100.576 16.2383 101.201 16.2383C101.696 16.2383 102.148 16.3099 102.559 16.4531C102.969 16.5964 103.32 16.8242 103.613 17.1367C103.913 17.4492 104.141 17.8626 104.297 18.377C104.46 18.8913 104.541 19.5195 104.541 20.2617V27H101.709V20.252C101.709 19.7832 101.644 19.4186 101.514 19.1582C101.383 18.8978 101.191 18.7155 100.938 18.6113C100.69 18.5007 100.384 18.4453 100.02 18.4453C99.6419 18.4453 99.3132 18.5202 99.0332 18.6699C98.7598 18.8197 98.5319 19.028 98.3496 19.2949C98.1738 19.5553 98.0404 19.8613 97.9492 20.2129C97.8581 20.5645 97.8125 20.9421 97.8125 21.3457ZM112.393 24.0801C112.393 23.8783 112.334 23.696 112.217 23.5332C112.1 23.3704 111.882 23.2207 111.562 23.084C111.25 22.9408 110.798 22.8105 110.205 22.6934C109.671 22.5762 109.173 22.4297 108.711 22.2539C108.255 22.0716 107.858 21.8535 107.52 21.5996C107.188 21.3457 106.927 21.0462 106.738 20.7012C106.549 20.3496 106.455 19.9492 106.455 19.5C106.455 19.0573 106.549 18.6406 106.738 18.25C106.934 17.8594 107.21 17.5143 107.568 17.2148C107.933 16.9089 108.376 16.6712 108.896 16.502C109.424 16.3262 110.016 16.2383 110.674 16.2383C111.592 16.2383 112.38 16.3848 113.037 16.6777C113.701 16.9707 114.209 17.3743 114.561 17.8887C114.919 18.3965 115.098 18.9759 115.098 19.627H112.285C112.285 19.3535 112.227 19.1094 112.109 18.8945C111.999 18.6732 111.823 18.5007 111.582 18.377C111.348 18.2467 111.042 18.1816 110.664 18.1816C110.352 18.1816 110.081 18.237 109.854 18.3477C109.626 18.4518 109.45 18.5951 109.326 18.7773C109.209 18.9531 109.15 19.1484 109.15 19.3633C109.15 19.526 109.183 19.6725 109.248 19.8027C109.32 19.9264 109.434 20.0404 109.59 20.1445C109.746 20.2487 109.948 20.3464 110.195 20.4375C110.449 20.5221 110.762 20.6003 111.133 20.6719C111.895 20.8281 112.575 21.0332 113.174 21.2871C113.773 21.5345 114.248 21.873 114.6 22.3027C114.951 22.7259 115.127 23.2826 115.127 23.9727C115.127 24.4414 115.023 24.8711 114.814 25.2617C114.606 25.6523 114.307 25.9941 113.916 26.2871C113.525 26.5736 113.057 26.7982 112.51 26.9609C111.969 27.1172 111.361 27.1953 110.684 27.1953C109.701 27.1953 108.867 27.0195 108.184 26.668C107.507 26.3164 106.992 25.8704 106.641 25.3301C106.296 24.7832 106.123 24.2233 106.123 23.6504H108.789C108.802 24.0345 108.9 24.3438 109.082 24.5781C109.271 24.8125 109.508 24.9818 109.795 25.0859C110.088 25.1901 110.404 25.2422 110.742 25.2422C111.107 25.2422 111.41 25.1934 111.65 25.0957C111.891 24.9915 112.074 24.8548 112.197 24.6855C112.327 24.5098 112.393 24.3079 112.393 24.0801Z" fill="white"/>
+</svg>

package/dist/assets/images/article/notice-warning.svg

@@ -0,0 +1,10 @@
+<svg width="30" height="30" viewBox="0 0 30 30" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_918_3041)">
+<path d="M15 1.875C7.75137 1.875 1.875 7.75137 1.875 15C1.875 22.2486 7.75137 28.125 15 28.125C22.2486 28.125 28.125 22.2486 28.125 15C28.125 7.75137 22.2486 1.875 15 1.875ZM21.2988 19.8062C21.4962 20.0044 21.607 20.2728 21.607 20.5525C21.607 20.8322 21.4962 21.1006 21.2988 21.2988C21.1006 21.4958 20.8325 21.6064 20.5531 21.6064C20.2736 21.6064 20.0055 21.4958 19.8073 21.2988L15 16.4915L10.1953 21.2988C9.997 21.4966 9.72833 21.6077 9.44824 21.6077C9.16815 21.6077 8.89949 21.4966 8.70117 21.2988C8.50418 21.1006 8.39361 20.8325 8.39361 20.5531C8.39361 20.2736 8.50418 20.0055 8.70117 19.8073L13.5059 15.0026L8.70117 10.1953C8.50338 9.997 8.3923 9.72833 8.3923 9.44824C8.3923 9.16815 8.50338 8.89949 8.70117 8.70117C8.89949 8.50338 9.16815 8.3923 9.44824 8.3923C9.72833 8.3923 9.997 8.50338 10.1953 8.70117L15 13.5085L19.8047 8.70381C20.0027 8.50566 20.2711 8.39411 20.5512 8.39362C20.8313 8.39312 21.1002 8.50373 21.2988 8.70117C21.4966 8.89949 21.6077 9.16815 21.6077 9.44824C21.6077 9.72833 21.4966 9.997 21.2988 10.1953L16.4915 15L21.2988 19.8062Z" fill="#F1631C"/>
+</g>
+<defs>
+<clipPath id="clip0_918_3041">
+<rect width="30" height="30" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/assets/images/article/question.svg

@@ -0,0 +1,10 @@
+<svg width="38" height="38" viewBox="0 0 38 38" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_918_3068)">
+<path d="M19 38C8.50615 38 0 29.4924 0 19C0 8.50615 8.50615 0 19 0C29.4938 0 38 8.50615 38 19C38 29.4924 29.4938 38 19 38ZM19 2.92162C10.1212 2.92162 2.92308 10.1197 2.92308 19C2.92308 27.8788 10.1212 35.0769 19 35.0769C27.8788 35.0769 35.0769 27.8788 35.0769 19C35.0769 10.1197 27.8788 2.92162 19 2.92162ZM24.1168 16.986C23.7412 17.4668 23.3364 17.8922 22.9038 18.2634C22.4712 18.6346 22.0663 19.0058 21.6907 19.3771C21.3151 19.7483 21.0023 20.1327 20.7553 20.5332C20.5083 20.9322 20.3841 21.375 20.3841 21.8602C20.3841 22.2695 20.4367 22.6407 20.5419 22.9739C20.6457 23.3072 20.7509 23.5878 20.8562 23.8158H17.8439C17.7577 23.5775 17.6817 23.2692 17.6159 22.8877C17.5487 22.5077 17.5151 22.1321 17.5151 21.7608C17.5151 21.1806 17.632 20.6545 17.8658 20.1838C18.0982 19.7118 18.3891 19.2718 18.7355 18.8626C19.0833 18.4534 19.4589 18.0588 19.8638 17.6788C20.2672 17.2973 20.6442 16.9261 20.9906 16.5651C21.3385 16.2041 21.6278 15.8226 21.8617 15.4236C22.0941 15.0232 22.211 14.5862 22.211 14.1097C22.211 13.6815 22.1262 13.3088 21.9538 12.9902C21.7828 12.6715 21.5475 12.4041 21.2478 12.1907C20.9482 11.9758 20.6062 11.8165 20.2204 11.7128C19.8345 11.6075 19.4238 11.5549 18.9854 11.5549C17.5677 11.5549 16.2172 12.1878 14.9325 13.4535V10.1562C16.492 9.24277 18.1099 8.78677 19.7848 8.78677C20.5551 8.78677 21.2844 8.88615 21.9684 9.08638C22.6538 9.28662 23.2531 9.58039 23.7675 9.97062C24.2805 10.3608 24.6854 10.8461 24.9806 11.4263C25.2758 12.008 25.4235 12.6832 25.4235 13.4535C25.4235 14.1857 25.2992 14.8375 25.0522 15.409C24.8038 15.9805 24.4925 16.5052 24.1168 16.986ZM19.4706 26.0417C20.0128 26.0417 20.4893 26.2332 20.8985 26.6132C21.2975 26.9654 21.4978 27.4126 21.4978 27.9548C21.4978 28.4883 21.2975 28.9355 20.8985 29.2965C20.4791 29.6678 20.0041 29.8534 19.4706 29.8534C18.9284 29.8534 18.4475 29.6678 18.0295 29.2965C17.6291 28.9355 17.4303 28.4883 17.4303 27.9548C17.4303 27.4126 17.6291 26.9654 18.0295 26.6132C18.4388 26.2332 18.9196 26.0417 19.4706 26.0417Z" fill="#F1981C"/>
+</g>
+<defs>
+<clipPath id="clip0_918_3068">
+<rect width="38" height="38" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/composables/useInlineEdit.d.ts

@@ -0,0 +1,30 @@
+import { type Ref } from 'vue';
+export interface UseInlineEditOptions {
+    /** 是否处于编辑器模式 */
+    editorMode: () => boolean;
+    /** 当 Section setting 编辑完成时调用 */
+    onSettingUpdate?: (key: string, value: string) => void;
+    /** 当 Block setting 编辑完成时调用 */
+    onBlockSettingUpdate?: (blockId: string, key: string, value: string) => void;
+    /** 内联编辑开始时调用 */
+    onEditStart?: (key: string) => void;
+    /** 内联编辑结束时调用 */
+    onEditEnd?: () => void;
+    /** 编辑中按 Ctrl+Z/Y 时调用（先提交编辑再触发，让 admin 执行 undo/redo） */
+    onUndoRedo?: (action: 'redo' | 'undo') => void;
+}
+export interface UseInlineEditReturn {
+    /** 绑定到可编辑的 Section setting 元素 */
+    editableAttrs: (settingKey: string) => Record<string, unknown>;
+    /** 绑定到可编辑的 Block setting 元素 */
+    blockEditableAttrs: (blockId: string, settingKey: string) => Record<string, unknown>;
+    /** 当前正在编辑的 key（null = 未编辑） */
+    editingKey: Ref<string | null>;
+}
+/**
+ * 内联编辑 composable
+ * 封装 contentEditable 逻辑，让 Section 组件在 editorMode 下支持双击编辑文本
+ *
+ * 设计思路：通过返回 attrs 对象配合 v-bind 使用，组件无需关心编辑状态管理
+ */
+export declare function useInlineEdit(options: UseInlineEditOptions): UseInlineEditReturn;

package/dist/composables/useInlineEdit.mjs

@@ -0,0 +1,94 @@
+import { detectUndoRedo } from "@vigilkids/section-core";
+import { nextTick, ref } from "vue";
+export function useInlineEdit(options) {
+  const { editorMode, onSettingUpdate, onBlockSettingUpdate, onEditStart, onEditEnd, onUndoRedo } = options;
+  const editingKey = ref(null);
+  let originalText = "";
+  function selectAllText(el) {
+    const selection = window.getSelection();
+    if (!selection) return;
+    const range = document.createRange();
+    range.selectNodeContents(el);
+    selection.removeAllRanges();
+    selection.addRange(range);
+  }
+  function startEdit(compositeKey, el) {
+    editingKey.value = compositeKey;
+    originalText = el.textContent ?? "";
+    onEditStart?.(compositeKey);
+    void nextTick(() => {
+      el.focus();
+      selectAllText(el);
+    });
+  }
+  function commitEdit(el, emitFn) {
+    const newValue = el.textContent?.trim() ?? "";
+    if (newValue !== originalText) {
+      emitFn(newValue);
+    }
+    editingKey.value = null;
+    onEditEnd?.();
+  }
+  function cancelEdit(el) {
+    el.textContent = originalText;
+    editingKey.value = null;
+    onEditEnd?.();
+  }
+  function buildAttrs(compositeKey, emitFn) {
+    if (!editorMode()) return {};
+    if (editingKey.value === compositeKey) {
+      return {
+        contenteditable: "plaintext-only",
+        class: "inline-editing",
+        onBlur: (e) => {
+          commitEdit(e.currentTarget, emitFn);
+        },
+        onKeydown: (e) => {
+          if (e.key === "Enter") {
+            e.preventDefault();
+            commitEdit(e.currentTarget, emitFn);
+            return;
+          }
+          if (e.key === "Escape") {
+            e.preventDefault();
+            cancelEdit(e.currentTarget);
+            return;
+          }
+          const undoRedoAction = detectUndoRedo(e);
+          if (undoRedoAction) {
+            e.preventDefault();
+            commitEdit(e.currentTarget, emitFn);
+            onUndoRedo?.(undoRedoAction);
+          }
+        },
+        onPaste: (e) => {
+          e.preventDefault();
+          const text = e.clipboardData?.getData("text/plain") ?? "";
+          document.execCommand("insertText", false, text);
+        }
+      };
+    }
+    return {
+      class: "inline-editable",
+      onDblclick: (e) => {
+        startEdit(compositeKey, e.currentTarget);
+      }
+    };
+  }
+  function editableAttrs(settingKey) {
+    return buildAttrs(settingKey, (newValue) => {
+      onSettingUpdate?.(settingKey, newValue);
+    });
+  }
+  function blockEditableAttrs(blockId, settingKey) {
+    const compositeKey = `${blockId}:${settingKey}`;
+    return buildAttrs(compositeKey, (newValue) => {
+      onBlockSettingUpdate?.(blockId, settingKey, newValue);
+    });
+  }
+  return {
+    editableAttrs,
+    blockEditableAttrs,
+    editingKey
+  };
+}

package/dist/composables/useLazyRender.d.ts

@@ -0,0 +1,18 @@
+import type { Ref } from 'vue';
+interface LazyRenderOptions {
+    /** IntersectionObserver rootMargin，提前多少像素开始加载 */
+    rootMargin?: string;
+    /** 是否在 SSR 时直接渲染（不延迟），保证服务端输出完整 HTML */
+    ssrEager?: boolean;
+}
+/**
+ * 使用 IntersectionObserver 实现懒渲染
+ * 组件进入视口（或接近视口）时才触发渲染，减少首屏渲染负担
+ *
+ * SSR 环境下默认立即标记为可见，保证 HTML 完整性；
+ * 客户端 hydration 后由 IntersectionObserver 接管可见性判断
+ */
+export declare function useLazyRender(targetRef: Ref<HTMLElement | null>, options?: LazyRenderOptions): {
+    isVisible: Ref<boolean, boolean>;
+};
+export {};

package/dist/composables/useLazyRender.mjs

@@ -0,0 +1,33 @@
+import { onMounted, onUnmounted, ref } from "vue";
+export function useLazyRender(targetRef, options = {}) {
+  const { rootMargin = "200px", ssrEager = true } = options;
+  const isVisible = ref(typeof window === "undefined" ? ssrEager : false);
+  let observer = null;
+  onMounted(() => {
+    if (isVisible.value) return;
+    const el = targetRef.value;
+    if (!el) {
+      isVisible.value = true;
+      return;
+    }
+    observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            isVisible.value = true;
+            observer?.disconnect();
+            observer = null;
+            break;
+          }
+        }
+      },
+      { rootMargin }
+    );
+    observer.observe(el);
+  });
+  onUnmounted(() => {
+    observer?.disconnect();
+    observer = null;
+  });
+  return { isVisible };
+}

package/dist/composables/useRegistry.d.ts

@@ -0,0 +1,38 @@
+import type { Component } from 'vue';
+import type { SectionRegistration } from '@vigilkids/section-core';
+import { defineAsyncComponent } from 'vue';
+/** Vue 组件工厂函数 */
+type ComponentFactory = () => Promise<{
+    default: Component;
+} | Component>;
+/** 扩展注册信息（包含 Vue 组件工厂） */
+interface VueSectionRegistration extends SectionRegistration {
+    component: ComponentFactory;
+}
+/** Vue 适配的 Section 注册表 */
+declare class VueSectionRegistry {
+    private core;
+    private components;
+    private frozen;
+    /** 注册 Section 组件（可选 productCode 用于产品级覆盖） */
+    register(registration: VueSectionRegistration & {
+        productCode?: string;
+    }): void;
+    /** 解析组件 — 优先匹配产品级组件，回退到共享组件 */
+    resolve(type: string, productCode?: string): ReturnType<typeof defineAsyncComponent> | null;
+    /** 获取注册元数据 */
+    getRegistration(name: string): SectionRegistration | undefined;
+    /** 获取所有已注册组件名 */
+    names(): string[];
+    /** 冻结注册表 */
+    freeze(): void;
+    get isFrozen(): boolean;
+    get size(): number;
+}
+/** 获取注册表实例（Vue composable） */
+export declare function useRegistry(): VueSectionRegistry;
+/** 注册 Section 组件（全局函数，在模块 import 阶段调用） */
+export declare function registerSection(registration: VueSectionRegistration & {
+    productCode?: string;
+}): void;
+export {};

package/dist/composables/useRegistry.mjs

@@ -0,0 +1,60 @@
+import { defineAsyncComponent } from "vue";
+import { SectionRegistryCore } from "@vigilkids/section-core";
+import FallbackSection from "../renderer/FallbackSection.vue";
+class VueSectionRegistry {
+  core = new SectionRegistryCore();
+  components = /* @__PURE__ */ new Map();
+  frozen = false;
+  /** 注册 Section 组件（可选 productCode 用于产品级覆盖） */
+  register(registration) {
+    if (this.frozen) {
+      throw new Error(`[SectionRegistry] Registry is frozen, cannot register "${registration.name}"`);
+    }
+    this.core.register(registration);
+    const key = registration.productCode ? `${registration.productCode}:${registration.name}` : registration.name;
+    this.components.set(
+      key,
+      defineAsyncComponent({
+        loader: registration.component,
+        loadingComponent: FallbackSection,
+        errorComponent: FallbackSection,
+        delay: 200,
+        timeout: 1e4
+      })
+    );
+  }
+  /** 解析组件 — 优先匹配产品级组件，回退到共享组件 */
+  resolve(type, productCode) {
+    if (productCode) {
+      const productComponent = this.components.get(`${productCode}:${type}`);
+      if (productComponent) return productComponent;
+    }
+    return this.components.get(type) ?? null;
+  }
+  /** 获取注册元数据 */
+  getRegistration(name) {
+    return this.core.get(name);
+  }
+  /** 获取所有已注册组件名 */
+  names() {
+    return this.core.names();
+  }
+  /** 冻结注册表 */
+  freeze() {
+    this.frozen = true;
+    this.core.freeze();
+  }
+  get isFrozen() {
+    return this.frozen;
+  }
+  get size() {
+    return this.core.size;
+  }
+}
+const registryInstance = new VueSectionRegistry();
+export function useRegistry() {
+  return registryInstance;
+}
+export function registerSection(registration) {
+  registryInstance.register(registration);
+}

package/dist/composables/useSectionSEO.d.ts

@@ -0,0 +1,26 @@
+import type { SectionsData } from '@vigilkids/section-core';
+/** JSON-LD 结构化数据生成参数 */
+export interface SectionSEOOptions {
+    /** 页面标题 */
+    title: string;
+    /** 页面描述 */
+    description: string;
+    /** 页面 URL (完整路径) */
+    url?: string;
+    /** 发布日期 ISO 格式 */
+    datePublished?: string;
+    /** 修改日期 ISO 格式 */
+    dateModified?: string;
+    /** 作者名称 */
+    author?: string;
+}
+/** 从 SectionsData 生成 JSON-LD 结构化数据 */
+export declare function generateSectionJsonLd(sectionsData: SectionsData, options: SectionSEOOptions): Record<string, unknown>[];
+/**
+ * 生成 JSON-LD script 标签内容
+ * 用于 SSR 场景下直接注入 <head>，兼容 Nuxt useHead() 的 script 格式
+ */
+export declare function generateJsonLdScripts(sectionsData: SectionsData, options: SectionSEOOptions): Array<{
+    type: 'application/ld+json';
+    innerHTML: string;
+}>;

package/dist/composables/useSectionSEO.mjs

@@ -0,0 +1,122 @@
+function getOrderedBlocks(section) {
+  return (section.block_order ?? []).filter((id) => id in (section.blocks ?? {})).map((id) => ({
+    id,
+    settings: section.blocks[id]?.settings ?? {}
+  }));
+}
+function mapSectionToSchema(section) {
+  const settings = section.settings;
+  switch (section.type) {
+    case "hero-banner":
+      return {
+        "@type": "WPHeader",
+        "cssSelector": `[data-section-id="${section.id}"]`,
+        "headline": settings.heading ?? ""
+      };
+    case "feature-grid": {
+      const blocks = getOrderedBlocks(section);
+      return {
+        "@type": "ItemList",
+        "cssSelector": `[data-section-id="${section.id}"]`,
+        "numberOfItems": blocks.length,
+        "itemListElement": blocks.map((block, index) => ({
+          "@type": "ListItem",
+          "position": index + 1,
+          "name": block.settings.title ?? "",
+          "description": block.settings.description ?? ""
+        }))
+      };
+    }
+    case "testimonials": {
+      const blocks = getOrderedBlocks(section);
+      return {
+        "@type": "ItemList",
+        "cssSelector": `[data-section-id="${section.id}"]`,
+        "numberOfItems": blocks.length,
+        "itemListElement": blocks.map((block, index) => ({
+          "@type": "Review",
+          "position": index + 1,
+          "reviewBody": block.settings.quote ?? "",
+          "author": {
+            "@type": "Person",
+            "name": block.settings.author ?? ""
+          }
+        }))
+      };
+    }
+    case "text-with-image":
+      return {
+        "@type": "WebPageElement",
+        "cssSelector": `[data-section-id="${section.id}"]`,
+        "headline": settings.heading ?? "",
+        "text": settings.body ?? ""
+      };
+    case "cta":
+      return {
+        "@type": "WebPageElement",
+        "cssSelector": `[data-section-id="${section.id}"]`,
+        "headline": settings.heading ?? ""
+      };
+    case "rich-text":
+      return {
+        "@type": "Article",
+        "cssSelector": `[data-section-id="${section.id}"]`
+      };
+    // spacer 和 faq 不生成 hasPart 条目（faq 有独立 FAQPage schema）
+    default:
+      return null;
+  }
+}
+function generateFAQSchema(section) {
+  const blocks = getOrderedBlocks(section);
+  if (blocks.length === 0) return null;
+  return {
+    "@context": "https://schema.org",
+    "@type": "FAQPage",
+    "mainEntity": blocks.map((block) => ({
+      "@type": "Question",
+      "name": block.settings.question ?? "",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": block.settings.answer ?? ""
+      }
+    }))
+  };
+}
+export function generateSectionJsonLd(sectionsData, options) {
+  const schemas = [];
+  const orderedSections = sectionsData.section_order.map((id) => {
+    const section = sectionsData.sections[id];
+    return section ? { ...section, id } : void 0;
+  }).filter((s) => !!s && !s.disabled);
+  const webPage = {
+    "@context": "https://schema.org",
+    "@type": "WebPage",
+    "name": options.title,
+    "description": options.description
+  };
+  if (options.url) webPage.url = options.url;
+  if (options.datePublished) webPage.datePublished = options.datePublished;
+  if (options.dateModified) webPage.dateModified = options.dateModified;
+  if (options.author) {
+    webPage.author = { "@type": "Person", "name": options.author };
+  }
+  const parts = orderedSections.map((section) => mapSectionToSchema(section)).filter((p) => p !== null);
+  if (parts.length > 0) {
+    webPage.hasPart = parts;
+  }
+  schemas.push(webPage);
+  const faqSections = orderedSections.filter((s) => s.type === "faq");
+  for (const faq of faqSections) {
+    const faqSchema = generateFAQSchema(faq);
+    if (faqSchema) schemas.push(faqSchema);
+  }
+  return schemas;
+}
+export function generateJsonLdScripts(sectionsData, options) {
+  const schemas = generateSectionJsonLd(sectionsData, options);
+  return schemas.map((schema) => ({
+    type: "application/ld+json",
+    innerHTML: JSON.stringify(schema)
+  }));
+}

package/dist/composables/useSectionStyle.d.ts

@@ -0,0 +1,23 @@
+import { type Ref } from 'vue';
+export interface SectionStyleResult {
+    /** Tailwind class 列表（语义 token 映射） */
+    wrapperClasses: string;
+    /** 内联样式对象（raw 值覆盖） */
+    wrapperStyles: Record<string, string>;
+    /** Scoped CSS 文本（自定义间距 + custom_css） */
+    scopedCSS: string;
+    /** 自定义 class（用户输入的 custom_class） */
+    customClass: string;
+}
+/**
+ * Section 样式词汇表 composable
+ * 将 settings 中的约定字段自动映射为 CSS classes / inline styles / scoped CSS
+ *
+ * 三层样式覆盖：
+ * 1. 语义 Token → Tailwind class（spacing_preset, text_alignment, max_width, visibility）
+ * 2. Raw 值 → inline style / scoped CSS（background_color, text_color, border_radius, margin, padding）
+ * 3. Custom CSS → scoped style 注入（custom_css 逃生舱）
+ */
+export declare function useSectionStyle(sectionId: string | Ref<string> | (() => string), settings: Record<string, unknown> | Ref<Record<string, unknown>> | (() => Record<string, unknown>)): {
+    style: Ref<SectionStyleResult>;
+};