iobroker.autodoc 0.9.35

package/admin/jsonConfig.json

@@ -0,0 +1,1490 @@
+{
+	"i18n": true,
+	"type": "tabs",
+	"items": {
+		"tabBasic": {
+			"type": "panel",
+			"label": "Basic settings",
+			"items": {
+				"_basicOrientation": {
+					"type": "staticText",
+					"text": "Admin tab orientation basic",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_basicSectionProfile": {
+					"type": "header",
+					"text": "Basic section profile",
+					"size": 4,
+					"newLine": true
+				},
+				"profile": {
+					"type": "select",
+					"label": "Documentation profile",
+					"help": "Target audience for Markdown export and default focus. HTML always includes all three profiles (admin, user, onboarding). AI text for User/Onboarding HTML runs whenever a KI provider is set, regardless of this selection.",
+					"options": [
+						{
+							"label": "Admin",
+							"value": "admin"
+						},
+						{
+							"label": "User/Family",
+							"value": "user"
+						},
+						{
+							"label": "Onboarding",
+							"value": "onboarding"
+						}
+					],
+					"default": "admin",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"language": {
+					"type": "select",
+					"label": "Documentation language",
+					"help": "Language for the generated documentation",
+					"options": [
+						{
+							"label": "English",
+							"value": "en"
+						},
+						{
+							"label": "German",
+							"value": "de"
+						},
+						{
+							"label": "French",
+							"value": "fr"
+						}
+					],
+					"default": "en",
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_basicSectionTriggers": {
+					"type": "header",
+					"text": "Basic section triggers",
+					"size": 4,
+					"newLine": true
+				},
+				"autoGenerateOnStart": {
+					"type": "checkbox",
+					"label": "Generate documentation on adapter start",
+					"default": true,
+					"help": "If enabled, documentation is queued each time the adapter starts (runs in the background; the instance can show green before it finishes). If disabled, a run still happens once after an update when the built-in HTML renderer version no longer matches info.templateVersion. Check the log for \"Documentation generated via startup\" and state info.lastTrigger.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"autoGenerateOnEvents": {
+					"type": "checkbox",
+					"label": "Generate documentation on adapter changes",
+					"help": "If enabled, documentation is regenerated automatically when adapters are installed, removed, or enabled/disabled (30 second debounce)",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"autoGenerateInterval": {
+					"type": "number",
+					"label": "Scheduled interval (hours)",
+					"help": "Optional timer: regenerate every X hours, independent of start and adapter-change options above. 0 = no scheduled runs (events and start still work).",
+					"min": 0,
+					"max": 168,
+					"default": 0,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_basicSectionDiscovery": {
+					"type": "header",
+					"text": "Basic section discovery",
+					"size": 4,
+					"newLine": true
+				},
+				"readLiveStates": {
+					"type": "checkbox",
+					"label": "Read live state values (opt-in)",
+					"help": "If enabled, current values for selected state roles are read and shown in User/Onboarding room cards and the Admin device table (badges next to device names). Includes e.g. temperature, blinds (level.blind), dimmers, lights (switch.light), outlets (switch/plug), humidity, power metrics, locks, door/window/contact, motion, alarm. Room members may be channels or devices — matching child states are found automatically. Very custom or empty roles are skipped.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_basicSectionManual": {
+					"type": "header",
+					"text": "Basic section manual",
+					"size": 4,
+					"newLine": true
+				},
+				"_generateHint": {
+					"type": "staticText",
+					"text": "Generate now hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_generateButton": {
+					"type": "setState",
+					"id": "autodoc.0.action.generate",
+					"val": true,
+					"label": "Generate documentation now",
+					"variant": "contained",
+					"confirm": {
+						"title": "Generate documentation",
+						"text": "Start documentation generation now? This may take a few seconds.",
+						"ok": "Generate",
+						"cancel": "Cancel"
+					},
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 4,
+					"xl": 3
+				},
+				"_lastGenStatus": {
+					"type": "textSendTo",
+					"command": "getStatus",
+					"label": "Last generated",
+					"container": "div",
+					"copyToClipboard": false,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_forumCardSendTo": {
+					"type": "textSendTo",
+					"command": "getForumCard",
+					"label": "Forum system card (plaintext)",
+					"container": "div",
+					"copyToClipboard": true,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				}
+			}
+		},
+		"tabManual": {
+			"type": "panel",
+			"label": "My documentation",
+			"items": {
+				"_documentationOrientation": {
+					"type": "staticText",
+					"text": "Admin tab orientation documentation",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_manualHint": {
+					"type": "staticText",
+					"text": "Manual documentation hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_manualSectionProject": {
+					"type": "header",
+					"text": "Manual section project",
+					"size": 4,
+					"newLine": true
+				},
+				"projectName": {
+					"type": "text",
+					"label": "Project name",
+					"help": "Name of the ioBroker project or installation",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"projectDescription": {
+					"type": "text",
+					"label": "Project description",
+					"help": "What does this system do? e.g. 'Single-family home, heating + lighting + security on 3 floors'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"manualContact": {
+					"type": "text",
+					"label": "Contact person",
+					"help": "Who manages this system? e.g. 'Max Mustermann, Telegram @max' - shown so guests and family know who to ask",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"additionalNotes": {
+					"type": "text",
+					"label": "General notes",
+					"help": "Anything that doesn't fit elsewhere: e.g. 'Backup runs every Sunday, server is in the basement'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_guestFamilyPlainHeader": {
+					"type": "header",
+					"text": "Guest & family (plain language)",
+					"size": 4,
+					"newLine": true
+				},
+				"guestHelpNote": {
+					"type": "text",
+					"label": "Help & emergencies (guests/family)",
+					"help": "Who to call, what to try if something fails, where the fuse box is — your words only; nothing is invented automatically.",
+					"minRows": 4,
+					"maxRows": 16,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"homeRoutinesNote": {
+					"type": "text",
+					"label": "Routines & automations (your words)",
+					"help": "Describe in everyday language what often runs by itself (lights, heating, blinds). Shown near the script list; complements technical script names.",
+					"minRows": 4,
+					"maxRows": 18,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"ownerPlaybookNote": {
+					"type": "text",
+					"label": "How we run this home (your playbook)",
+					"help": "Step-by-step or bullet notes only you maintain: typical order of doing things, what must be done, what guests or family must not change (your words; nothing is invented automatically). Shown as its own section in family and guest docs.",
+					"minRows": 4,
+					"maxRows": 22,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"manualMermaidDiagram": {
+					"type": "text",
+					"label": "Mermaid diagram (optional)",
+					"help": "Optional Mermaid diagram you write yourself (flowchart, sequence, …). **HTML exports:** With `@mermaid-js/mermaid-cli` installed on the ioBroker host (optional npm dependency), diagrams are rendered to **embedded SVG during generation** — works in offline `file://` copies without network. Without the CLI the export uses `<pre class=\"mermaid\">` and loads **Mermaid 10.9.1** from jsDelivr when you open the page in a browser (**online**). **When all diagrams are embedded as SVG, the export no longer loads jsDelivr** (the script is only injected if a `<pre class=\"mermaid\">` remains). **Markdown** always emits a ```mermaid source fence (not pre-rendered). Hide your manual diagram in User/Onboarding with chapter id **`mermaid`** (**`mermaidAuto`** is only for the optional auto-host diagram below). Very long input is truncated. Tip: `flowchart LR` uses horizontal page width; `flowchart TB` (default) stacks top-to-bottom.",
+					"placeholder": "flowchart LR\n    DEMOROOM --> DEMOGW",
+					"minRows": 4,
+					"maxRows": 28,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"autoMermaidHostGraph": {
+					"type": "checkbox",
+					"label": "Auto host topology diagram (Mermaid)",
+					"help": "When enabled, adds a second Mermaid diagram in HTML: adapter instances grouped by ioBroker host (helps in multihost setups). Instance node count is capped (next setting); not a full wiring graph. In User/Onboarding hide lists, use **`mermaidAuto`** to hide **only** this auto diagram (**`mermaid`** hides your manual diagram above). Same HTML embedding as manual Mermaid: embedded SVG when the CLI runs on the host, otherwise `<pre>` + jsDelivr in the browser.",
+					"default": false,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"autoMermaidHostGraphMaxNodes": {
+					"type": "number",
+					"label": "Max instances in auto topology diagram",
+					"help": "Maximum adapter **instance** nodes in the auto-generated diagram (8–200, default 40). Hosts are still shown; instances are chosen round-robin across hosts when there are more than this limit.",
+					"min": 8,
+					"max": 200,
+					"default": 40,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_troubleshootQuickHeader": {
+					"type": "header",
+					"text": "Troubleshooting — quick lines (optional)",
+					"size": 4,
+					"newLine": true
+				},
+				"_troubleshootQuickHint": {
+					"type": "staticText",
+					"text": "Troubleshooting quick lines hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"troubleshootWifiHint": {
+					"type": "text",
+					"label": "Quick: Wi-Fi / network",
+					"help": "One line, e.g. guest Wi-Fi name or where a repeater is — optional.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"troubleshootPowerHint": {
+					"type": "text",
+					"label": "Quick: power / fuses",
+					"help": "One line, e.g. where the electrical panel is — optional.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"troubleshootWaterHint": {
+					"type": "text",
+					"label": "Quick: water shutoff",
+					"help": "One line, e.g. where to turn off main water — optional.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"troubleshootExtraHint": {
+					"type": "text",
+					"label": "Quick: other",
+					"help": "One more short line (alarm code location, key box, etc.) — optional.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_adapterNotesHeader": {
+					"type": "header",
+					"text": "Per-adapter notes",
+					"size": 4,
+					"newLine": true
+				},
+				"adapterNotes": {
+					"type": "table",
+					"label": "Adapter notes",
+					"help": "Add a human-readable note for specific adapters (shown in all profiles)",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12,
+					"items": [
+						{
+							"attr": "adapter",
+							"type": "text",
+							"title": "Adapter (e.g. telegram)",
+							"width": "30%"
+						},
+						{
+							"attr": "note",
+							"type": "text",
+							"title": "Note",
+							"width": "70%"
+						}
+					]
+				},
+				"_roomNotesHeader": {
+					"type": "header",
+					"text": "Per-room notes",
+					"size": 4,
+					"newLine": true
+				},
+				"roomNotes": {
+					"type": "table",
+					"label": "Room notes",
+					"help": "Add a human-readable note for specific rooms (shown in User and Onboarding profiles)",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12,
+					"items": [
+						{
+							"attr": "room",
+							"type": "text",
+							"title": "Room name",
+							"width": "30%"
+						},
+						{
+							"attr": "note",
+							"type": "text",
+							"title": "Note",
+							"width": "70%"
+						}
+					]
+				},
+				"_onboardingHideHeader": {
+					"type": "header",
+					"text": "Onboarding - hide from guests",
+					"size": 4,
+					"newLine": true
+				},
+				"_onboardingHideHint": {
+					"type": "staticText",
+					"text": "Onboarding hide hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"onboardingHideRooms": {
+					"type": "table",
+					"label": "Hidden rooms (Onboarding)",
+					"help": "Onboarding hidden rooms help",
+					"newLine": true,
+					"xs": 12,
+					"sm": 6,
+					"md": 6,
+					"lg": 6,
+					"xl": 6,
+					"items": [
+						{
+							"attr": "room",
+							"type": "text",
+							"title": "Room name (exact)",
+							"width": "100%"
+						}
+					]
+				},
+				"onboardingHideAdapters": {
+					"type": "table",
+					"label": "Hidden adapters (Onboarding)",
+					"help": "Onboarding hidden adapters help",
+					"newLine": false,
+					"xs": 12,
+					"sm": 6,
+					"md": 6,
+					"lg": 6,
+					"xl": 6,
+					"items": [
+						{
+							"attr": "adapter",
+							"type": "text",
+							"title": "Adapter name (e.g. backitup)",
+							"width": "100%"
+						}
+					]
+				},
+				"onboardingGuestShowScriptNames": {
+					"type": "checkbox",
+					"label": "Onboarding guest view — list internal JavaScript file names",
+					"help": "onboarding guest script names help",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_userHideHeader": {
+					"type": "header",
+					"text": "User/Family - hide from family",
+					"size": 4,
+					"newLine": true
+				},
+				"_userHideHint": {
+					"type": "staticText",
+					"text": "User hide hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"userHideRooms": {
+					"type": "table",
+					"label": "Hidden rooms (User/Family)",
+					"help": "User hidden rooms help",
+					"newLine": true,
+					"xs": 12,
+					"sm": 6,
+					"md": 6,
+					"lg": 6,
+					"xl": 6,
+					"items": [
+						{
+							"attr": "room",
+							"type": "text",
+							"title": "Room name (exact)",
+							"width": "100%"
+						}
+					]
+				},
+				"userHideAdapters": {
+					"type": "table",
+					"label": "Hidden adapters (User/Family)",
+					"help": "User hidden adapters help",
+					"newLine": false,
+					"xs": 12,
+					"sm": 6,
+					"md": 6,
+					"lg": 6,
+					"xl": 6,
+					"items": [
+						{
+							"attr": "adapter",
+							"type": "text",
+							"title": "Adapter name (e.g. backitup)",
+							"width": "100%"
+						}
+					]
+				}
+			}
+		},
+		"tabAdvanced": {
+			"type": "panel",
+			"label": "Advanced",
+			"items": {
+				"_exportScriptsHint": {
+					"type": "staticText",
+					"text": "Admin export scripts hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_advancedSectionContent": {
+					"type": "header",
+					"text": "Advanced section content",
+					"size": 4,
+					"newLine": true
+				},
+				"onlyEnabledInstances": {
+					"type": "checkbox",
+					"label": "Only document enabled instances",
+					"help": "If enabled, only active adapter instances are included in the documentation",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"hideInstanceDetailsInMarkdown": {
+					"type": "checkbox",
+					"label": "Hide instance details in markdown",
+					"help": "If enabled, the markdown output contains only summary information without the full instance list",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"maxDocumentedInstances": {
+					"type": "number",
+					"label": "Maximum documented instances",
+					"help": "Limits how many adapter instances are included in the generated documentation, 0 means unlimited",
+					"min": 0,
+					"default": 0,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"maxStoredFiles": {
+					"type": "number",
+					"label": "Maximum stored documentation files",
+					"help": "How many timestamped file sets to keep (per type: .md, .html, .json). Oldest are deleted automatically. 0 = use default (3).",
+					"min": 0,
+					"default": 3,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_advancedSectionStates": {
+					"type": "header",
+					"text": "Advanced section states",
+					"size": 4,
+					"newLine": true
+				},
+				"documentationStatesMode": {
+					"type": "select",
+					"label": "Documentation states storage",
+					"help": "Documentation states storage help",
+					"options": [
+						{
+							"label": "Doc states mode full",
+							"value": "full"
+						},
+						{
+							"label": "Doc states mode metadata",
+							"value": "metadata"
+						}
+					],
+					"default": "full",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"baseUrl": {
+					"type": "text",
+					"label": "ioBroker base URL (optional)",
+					"help": "Used for the info.htmlUrl state. Include port, e.g. 192.168.1.100:8081 or http://myserver:8082. Protocol is optional. Leave empty for auto-detection (may fail in Docker).",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 8,
+					"lg": 8,
+					"xl": 8
+				},
+				"_advancedSetupScoreIntro": {
+					"type": "staticText",
+					"text": "Advanced setup score intro",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_advancedSectionMaintenanceScore": {
+					"type": "header",
+					"text": "Advanced section maintenance score",
+					"size": 4,
+					"newLine": true
+				},
+				"maintenanceScoreCheckDescription": {
+					"type": "checkbox",
+					"label": "Maintenance score include description check",
+					"help": "Maintenance score description check help",
+					"default": true,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"maintenanceScoreCheckBaseUrl": {
+					"type": "checkbox",
+					"label": "Maintenance score include base URL check",
+					"help": "Maintenance score base URL check help",
+					"default": true,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"maintenanceScoreCheckUnassigned": {
+					"type": "checkbox",
+					"label": "Maintenance score include unassigned check",
+					"help": "Maintenance score unassigned check help",
+					"default": true,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"maintenanceScoreMinDescriptionChars": {
+					"type": "number",
+					"label": "Maintenance score min description length",
+					"help": "Maintenance score min description length help",
+					"min": 5,
+					"max": 2000,
+					"default": 40,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"maintenanceScoreUnassignedWarnAt": {
+					"type": "number",
+					"label": "Maintenance score unassigned warn at",
+					"help": "Maintenance score unassigned warn at help",
+					"min": 1,
+					"max": 500,
+					"default": 10,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_advancedSectionFilesystem": {
+					"type": "header",
+					"text": "Advanced section filesystem",
+					"size": 4,
+					"newLine": true
+				},
+				"exportPath": {
+					"type": "text",
+					"label": "Filesystem export path (optional)",
+					"help": "Export path hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_advancedSectionPdf": {
+					"type": "header",
+					"text": "Advanced section pdf export",
+					"size": 4,
+					"newLine": true
+				},
+				"pdfExportAfterGeneration": {
+					"type": "checkbox",
+					"label": "Pdf export after generation label",
+					"help": "Pdf export after generation help",
+					"default": false,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				}
+			}
+		},
+		"tabDocLayout": {
+			"type": "panel",
+			"label": "HTML export & extra sections",
+			"items": {
+				"_docLayoutIntro": {
+					"type": "staticText",
+					"text": "Doc layout intro",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_docLayoutPdfHint": {
+					"type": "staticText",
+					"text": "Doc layout pdf hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_docSectionAppearance": {
+					"type": "header",
+					"text": "Doc section appearance",
+					"size": 4,
+					"newLine": true
+				},
+				"htmlColorScheme": {
+					"type": "select",
+					"label": "HTML color scheme",
+					"help": "HTML color scheme help",
+					"options": [
+						{
+							"label": "Auto (viewer toggle + saved preference)",
+							"value": "auto"
+						},
+						{
+							"label": "Light only",
+							"value": "light"
+						},
+						{
+							"label": "Dark only",
+							"value": "dark"
+						}
+					],
+					"default": "auto",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"htmlThemePreset": {
+					"type": "select",
+					"label": "HTML theme preset",
+					"help": "HTML theme preset help",
+					"options": [
+						{
+							"label": "HTML theme preset default",
+							"value": "default"
+						},
+						{
+							"label": "HTML theme preset high contrast",
+							"value": "highContrast"
+						},
+						{
+							"label": "HTML theme preset warm",
+							"value": "warm"
+						},
+						{
+							"label": "HTML theme preset slate",
+							"value": "slate"
+						}
+					],
+					"default": "default",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"htmlHeaderLogoUrl": {
+					"type": "text",
+					"label": "Sidebar logo URL",
+					"help": "Sidebar logo URL help",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_docSectionChapters": {
+					"type": "header",
+					"text": "Doc section chapters",
+					"size": 4,
+					"newLine": true
+				},
+				"_adminChaptersHeader": {
+					"type": "header",
+					"text": "Admin HTML — hide chapters",
+					"size": 4,
+					"newLine": true
+				},
+				"_adminChaptersHint": {
+					"type": "staticText",
+					"text": "Admin hidden chapters hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_adminChapterOrderHint": {
+					"type": "staticText",
+					"text": "Admin chapter order hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"adminChapterOrderJson": {
+					"type": "text",
+					"label": "Admin chapter order (JSON array)",
+					"help": "Admin chapter order JSON help",
+					"placeholder": "[ \"system\", \"adapters\", \"manual\" ]",
+					"minRows": 2,
+					"maxRows": 8,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"adminHiddenChaptersJson": {
+					"type": "text",
+					"label": "Hidden chapter IDs (JSON array)",
+					"help": "Admin hidden chapters JSON help",
+					"placeholder": "[]",
+					"minRows": 3,
+					"maxRows": 8,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_userChaptersHeader": {
+					"type": "header",
+					"text": "User/Family HTML — hide chapters",
+					"size": 4,
+					"newLine": true
+				},
+				"_userChaptersHint": {
+					"type": "staticText",
+					"text": "User hidden chapters hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"userHiddenChaptersJson": {
+					"type": "text",
+					"label": "User profile — hidden chapter IDs (JSON)",
+					"help": "User hidden chapters JSON help",
+					"placeholder": "[]",
+					"minRows": 3,
+					"maxRows": 8,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_userChapterOrderHint": {
+					"type": "staticText",
+					"text": "User chapter order hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"userChapterOrderJson": {
+					"type": "text",
+					"label": "User chapter order (JSON array)",
+					"help": "User chapter order JSON help",
+					"placeholder": "[ \"atAGlance\", \"rooms\", \"manual\" ]",
+					"minRows": 2,
+					"maxRows": 8,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_onboardingChaptersHeader": {
+					"type": "header",
+					"text": "Onboarding HTML — hide chapters",
+					"size": 4,
+					"newLine": true
+				},
+				"_onboardingChaptersHint": {
+					"type": "staticText",
+					"text": "Onboarding hidden chapters hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"onboardingHiddenChaptersJson": {
+					"type": "text",
+					"label": "Onboarding profile — hidden chapter IDs (JSON)",
+					"help": "Onboarding hidden chapters JSON help",
+					"placeholder": "[]",
+					"minRows": 3,
+					"maxRows": 8,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_onboardingChapterOrderHint": {
+					"type": "staticText",
+					"text": "Onboarding chapter order hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"onboardingChapterOrderJson": {
+					"type": "text",
+					"label": "Onboarding chapter order (JSON array)",
+					"help": "Onboarding chapter order JSON help",
+					"placeholder": "[ \"welcome\", \"quickstart\", \"rooms\" ]",
+					"minRows": 2,
+					"maxRows": 8,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_customSectionsHeader": {
+					"type": "header",
+					"text": "Custom Markdown sections",
+					"size": 4,
+					"newLine": true
+				},
+				"_customSectionsHint": {
+					"type": "staticText",
+					"text": "Custom sections JSON hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"customDocSectionsJson": {
+					"type": "text",
+					"label": "Custom sections (JSON)",
+					"help": "Custom sections JSON help",
+					"placeholder": "[ { \"title\": \"DEMO title\", \"body\": \"Markdown only — replace DEMO text.\", \"profiles\": [ \"onboarding\" ] } ]",
+					"minRows": 8,
+					"maxRows": 24,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_docSectionExpertStyling": {
+					"type": "header",
+					"text": "Doc section expert styling",
+					"size": 4,
+					"newLine": true
+				},
+				"_advancedStylingOpenHint": {
+					"type": "staticText",
+					"text": "Advanced styling open hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_advancedStylingHint": {
+					"type": "staticText",
+					"text": "Advanced HTML styling hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"htmlFontStack": {
+					"type": "text",
+					"label": "Font stack (CSS)",
+					"help": "Font stack help",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"htmlExtraCss": {
+					"type": "text",
+					"label": "Extra CSS",
+					"help": "Extra CSS help",
+					"minRows": 3,
+					"maxRows": 16,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				}
+			}
+		},
+		"tabNotify": {
+			"type": "panel",
+			"label": "Notifications",
+			"items": {
+				"_notifyOrientation": {
+					"type": "staticText",
+					"text": "Admin tab orientation notify",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_notifySection": {
+					"type": "header",
+					"text": "Notify section",
+					"size": 4,
+					"newLine": true
+				},
+				"notifyEnabled": {
+					"type": "checkbox",
+					"label": "Send notification after documentation generation",
+					"help": "If enabled, a message is sent via the configured adapter after each generation",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"notifyInstance": {
+					"type": "text",
+					"label": "Messaging adapter instance",
+					"help": "Instance to send the notification through, e.g. telegram.0, pushover.0, email.0",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"notifyTarget": {
+					"type": "text",
+					"label": "Recipient (optional)",
+					"help": "Telegram username, Pushover device, or email address - leave empty for adapter default",
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"notifyMessage": {
+					"type": "text",
+					"label": "Custom message template (optional)",
+					"help": "Use {project}, {summary}, {version}, {trigger} as placeholders. Leave empty for default message.",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				}
+			}
+		},
+		"tabAi": {
+			"type": "panel",
+			"label": "AI documentation",
+			"items": {
+				"_aiOrientation": {
+					"type": "staticText",
+					"text": "Admin tab orientation AI",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_aiPrivacyWarning": {
+					"type": "staticText",
+					"text": "AI privacy warning",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_aiHardwareHint": {
+					"type": "staticText",
+					"text": "AI hardware hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_aiSectionProvider": {
+					"type": "header",
+					"text": "AI section provider",
+					"size": 4,
+					"newLine": true
+				},
+				"aiProvider": {
+					"type": "select",
+					"label": "AI provider",
+					"help": "Ollama recommended: runs locally, no data leaves your network. Cloud providers send adapter/room/script names to external servers.",
+					"options": [
+						{
+							"label": "Disabled",
+							"value": "none"
+						},
+						{
+							"label": "Ollama — local, private, free (recommended)",
+							"value": "ollama"
+						},
+						{
+							"label": "Mistral AI — EU/GDPR, free tier",
+							"value": "mistral"
+						},
+						{
+							"label": "Groq — US, free tier (data may be used for training)",
+							"value": "groq"
+						},
+						{
+							"label": "Anthropic Claude — paid, no training on data",
+							"value": "anthropic"
+						}
+					],
+					"default": "none",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 8,
+					"lg": 8,
+					"xl": 8
+				},
+				"aiModel": {
+					"type": "text",
+					"label": "AI model (optional)",
+					"help": "Leave empty for default. Ollama: llama3.2 / gemma3. Mistral: mistral-small-latest. Groq: llama-3.3-70b-versatile. Anthropic: claude-haiku-4-5-20251001",
+					"hidden": "data.aiProvider === 'none'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"aiApiKey": {
+					"type": "password",
+					"label": "API key",
+					"help": "Mistral: console.mistral.ai | Groq: starts with gsk_... | Anthropic: starts with sk-ant-... | Ollama: leave empty",
+					"hidden": "data.aiProvider === 'none' || data.aiProvider === 'ollama'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 8,
+					"lg": 8,
+					"xl": 8
+				},
+				"aiBaseUrl": {
+					"type": "text",
+					"label": "Ollama base URL",
+					"help": "Only for Ollama. Default: http://localhost:11434",
+					"hidden": "data.aiProvider !== 'ollama'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"aiRequestTimeoutSeconds": {
+					"type": "text",
+					"label": "AI request timeout seconds (optional)",
+					"help": "Maximum wait for one LLM HTTP request. Default 300. Each generation uses several calls (user, onboarding, sometimes a German polish pass). Increase for slow local models on CPU (e.g. 480 or 600 for llama3.1:8b on NAS). Range 30–900.",
+					"hidden": "data.aiProvider === 'none'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_aiHintsHeader": {
+					"type": "header",
+					"text": "AI context hints",
+					"size": 4,
+					"newLine": true,
+					"hidden": "data.aiProvider === 'none'"
+				},
+				"_aiHintsHint": {
+					"type": "staticText",
+					"text": "AI context hints hint",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12,
+					"hidden": "data.aiProvider === 'none'"
+				},
+				"aiOwnerHints": {
+					"type": "text",
+					"label": "AI context hints (owner notes)",
+					"help": "AI context hints help",
+					"minRows": 6,
+					"maxRows": 18,
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12,
+					"hidden": "data.aiProvider === 'none'"
+				},
+				"_aiSectionTuning": {
+					"type": "header",
+					"text": "AI section tuning",
+					"size": 4,
+					"newLine": true,
+					"hidden": "data.aiProvider === 'none'"
+				},
+				"aiTemperatureUser": {
+					"type": "text",
+					"label": "AI temperature — user profile (optional)",
+					"help": "Sampling temperature for resident-facing AI text. Leave empty for the provider default. Typical range 0–2 (Ollama, Groq, Mistral); Anthropic accepts 0–1 (values above 1 are clamped). Lower ≈ steadier wording; higher ≈ more variation — tune after testing.",
+					"hidden": "data.aiProvider === 'none'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"aiTemperatureOnboarding": {
+					"type": "text",
+					"label": "AI temperature — onboarding (optional)",
+					"help": "Sampling temperature for guest/onboarding AI text. Same rules as user profile. The German Sie polish pass uses a fixed low temperature and ignores this field.",
+					"hidden": "data.aiProvider === 'none'",
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_aiSectionScripts": {
+					"type": "header",
+					"text": "AI section scripts",
+					"size": 4,
+					"newLine": true,
+					"hidden": "data.aiProvider === 'none'"
+				},
+				"aiAnalyzeScriptSources": {
+					"type": "checkbox",
+					"label": "AI explain JavaScript scripts (opt-in)",
+					"help": "Sends sanitized script source to the same AI provider to add short plain-language explanations in User/Onboarding docs. Lines matching common secret patterns are redacted first; still review before enabling on production systems.",
+					"default": false,
+					"hidden": "data.aiProvider === 'none'",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"aiMaxScriptCharsForAi": {
+					"type": "number",
+					"label": "Max characters of script source per KI call",
+					"help": "How many characters of each script (after redaction) are sent to the model; longer sources are truncated. Default 12000. Lower to speed up or fit small context; raise only if your model and timeout allow. Range 2000–100000. State info.aiScriptSourceProgress shows e.g. 5/12 while processing.",
+					"min": 2000,
+					"max": 100000,
+					"default": 12000,
+					"hidden": "data.aiProvider === 'none' || !data.aiAnalyzeScriptSources",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 6,
+					"xl": 6
+				},
+				"_cancelScriptHint": {
+					"type": "staticText",
+					"text": "Cancel script KI hint",
+					"hidden": "data.aiProvider === 'none' || !data.aiAnalyzeScriptSources",
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 12,
+					"lg": 12,
+					"xl": 12
+				},
+				"_cancelScriptButton": {
+					"type": "setState",
+					"id": "autodoc.0.action.cancelScriptSourceAi",
+					"val": true,
+					"label": "Cancel script KI (running generation)",
+					"variant": "outlined",
+					"hidden": "data.aiProvider === 'none' || !data.aiAnalyzeScriptSources",
+					"confirm": {
+						"title": "Cancel script KI",
+						"text": "Stop the optional per-script KI pass? The request that is already running may still finish; further scripts will not be started. (The main user/onboarding KI calls run before this phase.)",
+						"ok": "Cancel script KI",
+						"cancel": "Back"
+					},
+					"newLine": true,
+					"xs": 12,
+					"sm": 12,
+					"md": 6,
+					"lg": 4,
+					"xl": 4
+				}
+			}
+		}
+	}
+}