[{"data":1,"prerenderedAt":807},["ShallowReactive",2],{"navigation_docs":3,"-ai-agents-extend":412,"-ai-agents-extend-surround":802},[4,38,84,326,386],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":37},"Getting started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15,20,24,28,32],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-book-open",{"title":16,"path":17,"stem":18,"icon":19},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":6},"Quick start: Nuxt","\u002Fgetting-started\u002Fquick-start-nuxt","1.getting-started\u002F3.quick-start-nuxt",{"title":25,"path":26,"stem":27,"icon":6},"Quick start: plain Vue","\u002Fgetting-started\u002Fquick-start-vue","1.getting-started\u002F4.quick-start-vue",{"title":29,"path":30,"stem":31,"icon":6},"Quick start: React","\u002Fgetting-started\u002Fquick-start-react","1.getting-started\u002F5.quick-start-react",{"title":33,"path":34,"stem":35,"icon":36},"Glossary","\u002Fgetting-started\u002Fglossary","1.getting-started\u002F6.glossary","i-lucide-book-a",false,{"title":39,"icon":40,"path":41,"stem":42,"children":43,"page":37},"Tutorial","i-lucide-graduation-cap","\u002Ftutorial","2.tutorial",[44,49,54,59,64,69,74,79],{"title":45,"path":46,"stem":47,"icon":48},"Tutorial: overview","\u002Ftutorial\u002Foverview","2.tutorial\u002F1.overview","i-lucide-map",{"title":50,"path":51,"stem":52,"icon":53},"Chapter 2: A simple editor","\u002Ftutorial\u002Fsimple-editor","2.tutorial\u002F2.simple-editor","i-lucide-pencil",{"title":55,"path":56,"stem":57,"icon":58},"Chapter 3: Compose features","\u002Ftutorial\u002Fcompose-features","2.tutorial\u002F3.compose-features","i-lucide-blocks",{"title":60,"path":61,"stem":62,"icon":63},"Chapter 4: Your own block, path A","\u002Ftutorial\u002Fown-block-path-a","2.tutorial\u002F4.own-block-path-a","i-lucide-square-plus",{"title":65,"path":66,"stem":67,"icon":68},"Chapter 5: Your own feature, path B","\u002Ftutorial\u002Fown-feature-path-b","2.tutorial\u002F5.own-feature-path-b","i-lucide-puzzle",{"title":70,"path":71,"stem":72,"icon":73},"Chapter 6: Backend and collaboration","\u002Ftutorial\u002Fbackend-and-collaboration","2.tutorial\u002F6.backend-and-collaboration","i-lucide-users",{"title":75,"path":76,"stem":77,"icon":78},"Chapter 7: AI","\u002Ftutorial\u002Fai","2.tutorial\u002F7.ai","i-lucide-sparkles",{"title":80,"path":81,"stem":82,"icon":83},"Chapter 8: The React surface","\u002Ftutorial\u002Freact-surface","2.tutorial\u002F8.react-surface","i-lucide-atom",{"title":85,"icon":14,"path":86,"stem":87,"children":88,"page":37},"Guides","\u002Fguides","3.guides",[89,93,98,103,108,112,116,121,126,130,134,139,144,149,154,159,164,169,174,179,184,189,194,199,204,209,213,218,223,228,233,237,242,247,251,256,261,266,271,276,281,286,291,295,302,307,311,316,321],{"title":90,"path":91,"stem":92,"icon":58},"Feature composition and entries","\u002Fguides\u002Fcomposition","3.guides\u002F1.composition",{"title":94,"path":95,"stem":96,"icon":97},"Media, mentions and transcript features","\u002Fguides\u002Fmedia-mentions-transcript","3.guides\u002F10.media-mentions-transcript","i-lucide-image",{"title":99,"path":100,"stem":101,"icon":102},"Authors and comments","\u002Fguides\u002Fauthors-and-comments","3.guides\u002F11.authors-and-comments","i-lucide-message-square-text",{"title":104,"path":105,"stem":106,"icon":107},"Themes (Obsidian)","\u002Fguides\u002Fthemes","3.guides\u002F12.themes","i-lucide-palette",{"title":109,"path":110,"stem":111,"icon":58},"Composites and the settings UI","\u002Fguides\u002Fcomposites","3.guides\u002F13.composites",{"title":113,"path":114,"stem":115,"icon":78},"AI","\u002Fguides\u002Fai","3.guides\u002F14.ai",{"title":117,"path":118,"stem":119,"icon":120},"Document tree","\u002Fguides\u002Fdocument-tree","3.guides\u002F15.document-tree","i-lucide-folder-tree",{"title":122,"path":123,"stem":124,"icon":125},"Markdown and code","\u002Fguides\u002Fmarkdown-and-code","3.guides\u002F16.markdown-and-code","i-lucide-file-code",{"title":127,"path":128,"stem":129,"icon":83},"Advanced editor in React","\u002Fguides\u002Fadvanced-react","3.guides\u002F17.advanced-react",{"title":131,"path":132,"stem":133,"icon":6},"Kitchen sink: learning path","\u002Fguides\u002Fadvanced-nuxt-example","3.guides\u002F18.advanced-nuxt-example",{"title":135,"path":136,"stem":137,"icon":138},"Production","\u002Fguides\u002Fproduction","3.guides\u002F19.production","i-lucide-server",{"title":140,"path":141,"stem":142,"icon":143},"Register the Nuxt module","\u002Fguides\u002Fnuxt-module","3.guides\u002F2.nuxt-module","i-lucide-package",{"title":145,"path":146,"stem":147,"icon":148},"Storage adapters, comment stores, Nitro host","\u002Fguides\u002Fstorage-adapters","3.guides\u002F20.storage-adapters","i-lucide-database",{"title":150,"path":151,"stem":152,"icon":153},"Migrating from #tiptap-editor","\u002Fguides\u002Fmigration","3.guides\u002F21.migration","i-lucide-arrow-right-left",{"title":155,"path":156,"stem":157,"icon":158},"Content tree mechanics","\u002Fguides\u002Fcontent-tree","3.guides\u002F22.content-tree","i-lucide-git-fork",{"title":160,"path":161,"stem":162,"icon":163},"Block capabilities, abilities and actions","\u002Fguides\u002Fblock-capabilities","3.guides\u002F23.block-capabilities","i-lucide-shield-check",{"title":165,"path":166,"stem":167,"icon":168},"Block types in code and JSON","\u002Fguides\u002Fblock-types","3.guides\u002F24.block-types","i-lucide-shapes",{"title":170,"path":171,"stem":172,"icon":173},"Derive methods and the Derivation index","\u002Fguides\u002Fderive-methods","3.guides\u002F25.derive-methods","i-lucide-git-branch-plus",{"title":175,"path":176,"stem":177,"icon":178},"Block properties and Property definitions","\u002Fguides\u002Fblock-properties","3.guides\u002F26.block-properties","i-lucide-sliders-horizontal",{"title":180,"path":181,"stem":182,"icon":183},"Image studio","\u002Fguides\u002Fimage-studio","3.guides\u002F27.image-studio","i-lucide-image-plus",{"title":185,"path":186,"stem":187,"icon":188},"Prüfung and Freigabestatus","\u002Fguides\u002Fpruefung","3.guides\u002F28.pruefung","i-lucide-stamp",{"title":190,"path":191,"stem":192,"icon":193},"Workspace: find, read, reference and embed Blocks across Documents","\u002Fguides\u002Fworkspace","3.guides\u002F29.workspace","i-lucide-network",{"title":195,"path":196,"stem":197,"icon":198},"EditorPorts: auth and storage","\u002Fguides\u002Feditor-ports","3.guides\u002F3.editor-ports","i-lucide-plug",{"title":200,"path":201,"stem":202,"icon":203},"Collections: an ordered list of Blocks","\u002Fguides\u002Fcollections","3.guides\u002F30.collections","i-lucide-list-checks",{"title":205,"path":206,"stem":207,"icon":208},"Data views: a query shown as table, list or board","\u002Fguides\u002Fdata-views","3.guides\u002F31.data-views","i-lucide-table-properties",{"title":210,"path":211,"stem":212,"icon":193},"Explore: backlinks, related Blocks and the trail","\u002Fguides\u002Fexplore","3.guides\u002F32.explore",{"title":214,"path":215,"stem":216,"icon":217},"Render: export a Block or a Document to a file","\u002Fguides\u002Frender","3.guides\u002F33.render","i-lucide-file-output",{"title":219,"path":220,"stem":221,"icon":222},"Importers: what a dropped file becomes","\u002Fguides\u002Fimporters","3.guides\u002F34.importers","i-lucide-file-input",{"title":224,"path":225,"stem":226,"icon":227},"Templates: start a Document from a Dokumentvorlage","\u002Fguides\u002Ftemplates","3.guides\u002F35.templates","i-lucide-file-stack",{"title":229,"path":230,"stem":231,"icon":232},"Citations","\u002Fguides\u002Fcitations","3.guides\u002F36.citations","i-lucide-quote",{"title":234,"path":235,"stem":236,"icon":163},"AI proposals and the export check","\u002Fguides\u002Fexport-check","3.guides\u002F37.export-check",{"title":238,"path":239,"stem":240,"icon":241},"Query: filter, sort, group and total Blocks","\u002Fguides\u002Fquery","3.guides\u002F38.query","i-lucide-list-filter",{"title":243,"path":244,"stem":245,"icon":246},"Edges: backlinks and authored connections","\u002Fguides\u002Fedges","3.guides\u002F39.edges","i-lucide-link-2",{"title":248,"path":249,"stem":250,"icon":163},"Server routes and authentication","\u002Fguides\u002Froutes-and-auth","3.guides\u002F4.routes-and-auth",{"title":252,"path":253,"stem":254,"icon":255},"Speech: text to audio, and subtitle files","\u002Fguides\u002Fspeech","3.guides\u002F41.speech","i-lucide-audio-lines",{"title":257,"path":258,"stem":259,"icon":260},"Graph: the Edges around a Block","\u002Fguides\u002Fgraph","3.guides\u002F42.graph","i-lucide-waypoints",{"title":262,"path":263,"stem":264,"icon":265},"PDF viewer: passages, anchors and quotes","\u002Fguides\u002Fpdf-viewer","3.guides\u002F43.pdf-viewer","i-lucide-file-search",{"title":267,"path":268,"stem":269,"icon":270},"Obsidian: import and export a vault","\u002Fguides\u002Fobsidian","3.guides\u002F44.obsidian","i-lucide-folder-input",{"title":272,"path":273,"stem":274,"icon":275},"Typst: render a Document as a PDF with citations","\u002Fguides\u002Ftypst","3.guides\u002F45.typst","i-lucide-file-text",{"title":277,"path":278,"stem":279,"icon":280},"Audio: read aloud, mixdown and ElevenLabs","\u002Fguides\u002Faudio","3.guides\u002F46.audio","i-lucide-audio-waveform",{"title":282,"path":283,"stem":284,"icon":285},"Slides: decks, slide layouts and exports","\u002Fguides\u002Fslides","3.guides\u002F47.slides","i-lucide-presentation",{"title":287,"path":288,"stem":289,"icon":290},"Knowledge graph: sources and concepts beside the Documents","\u002Fguides\u002Fknowledge-graph","3.guides\u002F49.knowledge-graph","i-lucide-share-2",{"title":292,"path":293,"stem":294,"icon":78},"AI configuration and secrets","\u002Fguides\u002Fai-configuration","3.guides\u002F5.ai-configuration",{"title":296,"path":297,"stem":298,"children":299,"icon":301},"Index on Postgres: typos, meaning and SQL pushdown","\u002Fguides\u002Findex-pg","3.guides\u002F50.index-pg",[300],{"title":296,"path":297,"stem":298,"icon":301},"i-lucide-database-zap",{"title":303,"path":304,"stem":305,"icon":306},"Charts: bar, line, pie and scatter over a query","\u002Fguides\u002Fcharts","3.guides\u002F51.charts","i-lucide-chart-column",{"title":308,"path":309,"stem":310,"icon":73},"Collaboration on the client","\u002Fguides\u002Fcollaboration","3.guides\u002F6.collaboration",{"title":312,"path":313,"stem":314,"icon":315},"Block UI (drag handle, hover actions)","\u002Fguides\u002Fblock-ui","3.guides\u002F7.block-ui","i-lucide-grip-vertical",{"title":317,"path":318,"stem":319,"icon":320},"Settings and app lifetime","\u002Fguides\u002Fsettings","3.guides\u002F8.settings","i-lucide-settings",{"title":322,"path":323,"stem":324,"icon":325},"Language","\u002Fguides\u002Flanguage","3.guides\u002F9.language","i-lucide-languages",{"title":327,"icon":14,"path":328,"stem":329,"children":330,"page":37},"Reference","\u002Freference","4.reference",[331,335,339,344,348,352,356,360,364,368,373,378,382],{"title":332,"path":333,"stem":334,"icon":143},"Public exports","\u002Freference\u002Fexports","4.reference\u002F1.exports",{"title":336,"path":337,"stem":338,"icon":173},"Derive method contract","\u002Freference\u002Fderive-methods","4.reference\u002F10.derive-methods",{"title":340,"path":341,"stem":342,"icon":343},"Changelog","\u002Freference\u002Fchangelog","4.reference\u002F11.changelog","i-lucide-history",{"title":345,"path":346,"stem":347,"icon":217},"Renderer port","\u002Freference\u002Frenderer-port","4.reference\u002F12.renderer-port",{"title":349,"path":350,"stem":351,"icon":255},"Speech port","\u002Freference\u002Fspeech-port","4.reference\u002F13.speech-port",{"title":353,"path":354,"stem":355,"icon":58},"Presets and features","\u002Freference\u002Fpresets-and-features","4.reference\u002F2.presets-and-features",{"title":357,"path":358,"stem":359,"icon":68},"Feature contract","\u002Freference\u002Ffeature-contract","4.reference\u002F3.feature-contract",{"title":361,"path":362,"stem":363,"icon":107},"CSS and UI-provider requirements","\u002Freference\u002Fcss-and-ui","4.reference\u002F4.css-and-ui",{"title":365,"path":366,"stem":367,"icon":148},"Vue-free advanced schema","\u002Freference\u002Fadvanced-schema","4.reference\u002F5.advanced-schema",{"title":369,"path":370,"stem":371,"icon":372},"Dependency rules","\u002Freference\u002Fdependency-rules","4.reference\u002F6.dependency-rules","i-lucide-git-branch",{"title":374,"path":375,"stem":376,"icon":377},"Commands","\u002Freference\u002Fcommands","4.reference\u002F7.commands","i-lucide-terminal",{"title":379,"path":380,"stem":381,"icon":163},"Block capability contract","\u002Freference\u002Fblock-capabilities","4.reference\u002F8.block-capabilities",{"title":383,"path":384,"stem":385,"icon":168},"Block type contract","\u002Freference\u002Fblock-types","4.reference\u002F9.block-types",{"title":387,"path":388,"stem":389,"children":390,"icon":393},"AI agents","\u002Fai-agents","5.ai-agents\u002F1.index",[391,394,398,402,407],{"title":392,"path":388,"stem":389,"icon":393},"Overview","i-lucide-bot",{"title":395,"path":396,"stem":397,"icon":198},"Integrate the editor","\u002Fai-agents\u002Fintegrate","5.ai-agents\u002F2.integrate",{"title":399,"path":400,"stem":401,"icon":68},"Add a block or feature","\u002Fai-agents\u002Fextend","5.ai-agents\u002F3.extend",{"title":403,"path":404,"stem":405,"icon":406},"Pitfalls and invariants","\u002Fai-agents\u002Finvariants","5.ai-agents\u002F4.invariants","i-lucide-shield-alert",{"title":408,"path":409,"stem":410,"icon":411},"Verify","\u002Fai-agents\u002Fverify","5.ai-agents\u002F5.verify","i-lucide-check-check",{"id":413,"title":399,"body":414,"description":795,"extension":796,"links":797,"meta":798,"navigation":799,"path":400,"seo":800,"stem":401,"__hash__":801},"docs\u002F5.ai-agents\u002F3.extend.md",{"type":415,"value":416,"toc":791},"minimark",[417,447,784],[418,419,420,421,425,426,430,431,434,435,438,439,442,443,446],"p",{},"Two ways to add a block: ",[422,423,424],"strong",{},"Path A"," passes ",[427,428,429],"code",{},"extensions"," and a ",[427,432,433],{},"commands"," transformer to ",[427,436,437],{},"SimpleEditor"," (no feature object); ",[422,440,441],{},"Path B"," ships an ",[427,444,445],{},"EditorFeature"," that composes with any preset. The tutorial builds the same „Hinweis\" callout both ways; follow the chapters in order and use this list as the checklist.",[448,449,450,485,496,515,543,566,583,644,681,713,758],"ol",{},[451,452,453,456,457,460,461,464,465,468,469,472,473,476,477,480,481],"li",{},[422,454,455],{},"Node."," ",[427,458,459],{},"Node.create"," in a Vue-free ",[427,462,463],{},"node.ts","; ",[427,466,467],{},"group",", ",[427,470,471],{},"content",", attributes with ",[427,474,475],{},"parseHTML","\u002F",[427,478,479],{},"renderHTML",", commands and a free shortcut. ",[482,483,484],"a",{"href":61},"Tutorial: own block, path A",[451,486,487,456,490,493,494],{},[422,488,489],{},"Block IDs.",[427,491,492],{},"editorBlock: true"," if AI operations, flash\u002Freveal, paste de-duplication or the server ID backfill should reach it. ",[482,495,484],{"href":61},[451,497,498,456,501,504,505,507,508,511,512],{},[422,499,500],{},"Abilities.",[427,502,503],{},"abilities"," on the node for what is allowed inside; for a custom ability id, grant it through the ",[427,506,503],{}," prop (",[427,509,510],{},"root","). ",[482,513,514],{"href":66},"Tutorial: own feature, path B",[451,516,517,456,520,468,523,468,526,468,529,532,533,536,537,540,541],{},[422,518,519],{},"Markdown.",[427,521,522],{},"renderMarkdown",[427,524,525],{},"markdownTokenName",[427,527,528],{},"markdownTokenizer",[427,530,531],{},"parseMarkdown"," with syntax no other stage claims; test the round trip (",[427,534,535],{},"getMarkdown()"," → ",[427,538,539],{},"parseBlocks","), including multi-block bodies. ",[482,542,484],{"href":61},[451,544,545,548,549,552,553,556,557,560,561,563,564],{},[422,546,547],{},"View and CSS."," Node view in a separate ",[427,550,551],{},"index.ts"," (",[427,554,555],{},"Node.extend","), stylesheet imported after ",[427,558,559],{},"core.css",". ",[482,562,484],{"href":61},", CSS order: ",[482,565,361],{"href":362},[451,567,568,456,571,573,574,576,577,580,581],{},[422,569,570],{},"Path A.",[427,572,429],{}," (constant) and the ",[427,575,433],{}," transformer prop (a command with ",[427,578,579],{},"slash: {}","), nothing else needed. ",[482,582,484],{"href":61},[451,584,585,588,589,591,592,594,595,597,598,601,602,605,606,609,610,468,613,616,617,620,621,624,625,468,627,630,631,634,635,638,639,641,642],{},[422,586,587],{},"Path B."," An ",[427,590,445],{},": ",[427,593,429],{},", then ",[427,596,433],{}," (one ",[427,599,600],{},"CommandDef"," per command with ",[427,603,604],{},"toolbar"," and\u002For ",[427,607,608],{},"slash"," placement, ",[427,611,612],{},"creates",[427,614,615],{},"ability",") and ",[427,618,619],{},"toolbarGroups"," if you need a new group, ",[427,622,623],{},"blockActions"," with your ",[427,626,615],{},[427,628,629],{},"conversions"," with a ",[427,632,633],{},"custom"," target; ",[427,636,637],{},"requires"," for features you depend on. ",[482,640,514],{"href":66},", every member: ",[482,643,357],{"href":358},[451,645,646,456,649,652,653,656,657,660,661,664,665,668,669,671,672,675,676,468,679],{},[422,647,648],{},"Compose.",[427,650,651],{},"defineEditor({ features: [...advancedEditor().features, yourFeature()] })"," in setup (",[427,654,655],{},"advancedEditor"," from ",[427,658,659],{},"\u002Fvue\u002Fadvanced"," or ",[427,662,663],{},"\u002Freact\u002Fadvanced","); mount with ",[427,666,667],{},"EditorSurface"," and pass ",[427,670,503],{}," for custom ability ids; add ",[427,673,674],{},"blockUiFeature()"," to a smaller list when you use hover actions. ",[482,677,678],{"href":56},"Tutorial: compose features",[482,680,514],{"href":66},[451,682,683,686,687,690,691,694,695,698,699,702,703,706,707,468,710],{},[422,684,685],{},"Server."," When documents with your block are collaborative, pass ",[427,688,689],{},"YourNode"," in the server's ",[427,692,693],{},"schema"," option (",[427,696,697],{},"provideEditorServer({ ports, schema: () => [...advancedSchemaExtensions(), YourNode] })","; the collab server uses it instead of ",[427,700,701],{},"advancedSchemaExtensions()","), or build ",[427,704,705],{},"getSchema([...advancedSchemaExtensions(), YourNode])"," in your own Hocuspocus server. ",[482,708,709],{"href":71},"Tutorial: backend and collaboration",[482,711,712],{"href":366},"Vue-free schema for servers",[451,714,715,718,719,721,722,552,725,468,728,468,731,468,734,468,737,740,741,744,745,747,748,751,752,468,755],{},[422,716,717],{},"AI."," Decide what the model should see (",[427,720,522],{},") and write; describe the block in ",[427,723,724],{},"aiContext.blocks",[427,726,727],{},"id",[427,729,730],{},"label",[427,732,733],{},"description",[427,735,736],{},"syntax",[427,738,739],{},"example",", matching your Markdown); ",[427,742,743],{},"aiContext"," is additive, a block id may be described only once; add a ",[427,746,633],{}," conversion provider if the block should be a ",[427,749,750],{},"convert"," target. ",[482,753,754],{"href":76},"Tutorial: AI",[482,756,757],{"href":114},"AI guide",[451,759,760,763,764,767,768,552,771,773,774,777,778,781,782],{},[422,761,762],{},"Bundle proof."," If you ship the block in a package, add a fixture and a ",[427,765,766],{},"FIXTURES"," entry for ",[427,769,770],{},"bun run check:editor-entries",[482,772,369],{"href":370},"); ",[427,775,776],{},"bun run check:editor-composition"," covers ",[427,779,780],{},"defineEditor"," validation. ",[482,783,408],{"href":409},[418,785,786,787,790],{},"Then check the ",[482,788,789],{"href":404},"invariants",".",{"title":792,"searchDepth":793,"depth":793,"links":794},"",2,[],"Agent playbook for adding an own block or feature to @skaile\u002Fforge-editor: an ordered checklist where each step links to the tutorial chapter that shows it.","md",null,{},{"icon":68},{"title":399,"description":795},"qQaGpAV81xVvKHfdZhW-tHViTAKXQW3fiqshJNr3VQQ",[803,805],{"title":395,"path":396,"stem":397,"description":804,"icon":198,"children":-1},"Agent playbook for adding @skaile\u002Fforge-editor to an app: choose the surface, then the entry to import, then follow the matching setup page.",{"title":403,"path":404,"stem":405,"description":806,"icon":406,"children":-1},"Rules that must stay true when integrating or changing @skaile\u002Fforge-editor: CSS order, mandatory context, SSR, mount-time props, bundle isolation, entries.",1793213910340]