@supersoniks/concorde 4.9.98-visual-stack.2 → 4.9.98-visual-stack.4

package/src/docs/search/docs-search.json

@@ -1,12 +1,12 @@
 [
   {
-    "search": "Date",
+    "search": "3D",
     "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "date": {
-            "count": 2,
+          "3d": {
+            "count": 1,
             "title": "",
             "type": "page"
           }
@@ -15,42 +15,12 @@
     }
   },
   {
-    "search": "Nothing is displayed.\n",
-    "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
-        "hashes": {
-          "no-attribute": {
-            "count": 1,
-            "title": "No attribute",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Displays the current date.\n",
-    "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
-        "hashes": {
-          "now": {
-            "count": 1,
-            "title": "Now",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Displays a date from a timestamp.\n",
+    "search": "sonic-3d — viewer Three.js (glTF / GLB), caméra orbit / perspective / ortho, outputs dataProvider paresseux.\n",
     "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "date": {
+          "3d": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -60,112 +30,22 @@
     }
   },
   {
-    "search": "Displays a date from a string.\n",
-    "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
-        "hashes": {
-          "date_string": {
-            "count": 1,
-            "title": "Date_string",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Displays a period of time from start_date to end_date.When by itself start_date will act as dateif a start_date is not specified it will be set by the current date.if the end_date is anterior to start date date it will be used as the start_date. \n",
-    "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
-        "hashes": {
-          "start_date--end_date": {
-            "count": 1,
-            "title": "Start_date / end_date",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "ISO 639-1 Language Codes\n",
-    "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
-        "hashes": {
-          "language": {
-            "count": 1,
-            "title": "Language",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "For the list of supported timeZones, run Intl.supportedValuesOf('timeZone') in the console\n",
-    "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
-        "hashes": {
-          "time_zone": {
-            "count": 1,
-            "title": "Time_zone",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Deprecated\n",
+    "search": "Import opt-in (hors bundle functional) :\n",
     "files": {
-      "core/components/functional/date/date.md": {
-        "title": "Date",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "renderif": {
+          "3d": {
             "count": 1,
-            "title": ".renderIf",
+            "title": "",
             "type": "paragraph"
           }
         }
       },
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
-        "hashes": {
-          "headersdataprovider": {
-            "count": 1,
-            "title": "HeadersDataProvider",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Fetch",
-    "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
-        "hashes": {
-          "fetch": {
-            "count": 1,
-            "title": "",
-            "type": "page"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL="/docs-mock-api") to try examples offline.\n",
-    "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "fetch": {
+          "shader": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -175,12 +55,12 @@
     }
   },
   {
-    "search": "The sonic-fetch component requests and stores API data. It extends the Fetcher and Subscriber mixins.\n",
+    "search": "CDN (after the core): concorde-3d.bundle.js — see CDN addons.\n",
     "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "fetch": {
+          "3d": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -190,44 +70,14 @@
     }
   },
   {
-    "search": "In order to work properly the sonic-fetch component needs at least the following attributes.  \n",
-    "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
-        "hashes": {
-          "basic-usage": {
-            "count": 1,
-            "title": "Basic usage",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "If no endPoint is specified it will be filled by the dataProvider ID instead  \n",
-    "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
-        "hashes": {
-          "dataprovider-as-an-endpoint": {
-            "count": 1,
-            "title": "DataProvider as an endPoint",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "When the key attribute is present, only a sub-part of the data received is injected into the dataProvider.\nWe can use the dot syntax to target what we want to keep.\n",
+    "search": "DamagedHelmet (Khronos, jsDelivr). Orbit · zoom · pan · survol highlight · pick · double-clic = recentrer. Sans src : cube de démo. Molette : zoom tant qu’il reste de la marge ; aux bornes minDistance / maxDistance, le scroll page reprend.\n",
     "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "key": {
+          "démo-modèle-cdn": {
             "count": 1,
-            "title": "Key",
+            "title": "Démo (modèle CDN)",
             "type": "paragraph"
           }
         }
@@ -235,93 +85,57 @@
     }
   },
   {
-    "search": "For example if the data is {my:{data:{a:1,b:2}}} and the key is key="my.data", the data available in the dataProvider will be {a:1 , b:2}\n",
+    "search": "\n",
     "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "key": {
+          "démo-modèle-cdn": {
             "count": 1,
-            "title": "Key",
+            "title": "Démo (modèle CDN)",
             "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "if the mime type of the content returned by the service begins with text/, then the dataProvider has a key named "text" which contains the text returned by the service.\n",
-    "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
-        "hashes": {
-          "text-mode": {
+          },
+          "form-auto-bind-formdataprovider": {
             "count": 1,
-            "title": "Text mode",
+            "title": "Form auto-bind (`formDataProvider`)",
             "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "The noLoader attribute disables display of the default loader\n",
-    "files": {
-      "core/components/functional/fetch/fetch.md": {
-        "title": "Fetch",
-        "hashes": {
-          "noloader": {
+          },
+          "sortie--dataprovider": {
             "count": 1,
-            "title": "NoLoader",
+            "title": "Sortie / dataProvider",
             "type": "paragraph"
           }
         }
-      }
-    }
-  },
-  {
-    "search": "if",
-    "files": {
+      },
       "core/components/functional/if/if.md": {
         "title": "if",
         "hashes": {
           "if": {
             "count": 1,
             "title": "",
-            "type": "page"
+            "type": "paragraph"
           }
         }
-      }
-    }
-  },
-  {
-    "search": "The sonic-if component shows its slot when .condition is true. In Lit, bind .condition from store-driven state (@subscribe on a formDataProvider field) — live preview and TypeScript source are the same file (docs-lit-demo):\n",
-    "files": {
-      "core/components/functional/if/if.md": {
-        "title": "if",
+      },
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
         "hashes": {
-          "if": {
+          "image--background-removal": {
             "count": 1,
-            "title": "",
+            "title": "Image — `background-removal`",
             "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "\n",
-    "files": {
-      "core/components/functional/if/if.md": {
-        "title": "if",
-        "hashes": {
-          "if": {
+          },
+          "text--zero-shot-classification": {
             "count": 1,
-            "title": "",
+            "title": "Text — `zero-shot-classification`",
             "type": "paragraph"
           }
         }
       },
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {}
+      },
       "core/components/functional/jsonata/jsonata.md": {
         "title": "Jsonata",
         "hashes": {
@@ -392,25 +206,50 @@
           }
         }
       },
-      "core/components/functional/submit/submit.md": {
-        "title": "Submit",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "form-and-result-handling": {
+          "multipass-sur-une-photo": {
             "count": 1,
-            "title": "Form and result handling",
+            "title": "Multipass sur une photo",
             "type": "paragraph"
           },
-          "native-html-form": {
+          "chaînage-deffets-officiel": {
             "count": 1,
-            "title": "Native HTML form",
+            "title": "Chaînage d’effets (officiel)",
             "type": "paragraph"
           },
-          "sendasformdata": {
+          "rollover--roll-out-hover-param": {
             "count": 1,
-            "title": "sendAsFormData",
+            "title": "Rollover / roll-out (`hover-param`)",
             "type": "paragraph"
           },
-          "submit-result-key": {
+          "sortie--sampling-sample--dataprovider": {
+            "count": 1,
+            "title": "Sortie / sampling (`sample` + dataProvider)",
+            "type": "paragraph"
+          }
+        }
+      },
+      "core/components/functional/submit/submit.md": {
+        "title": "Submit",
+        "hashes": {
+          "form-and-result-handling": {
+            "count": 1,
+            "title": "Form and result handling",
+            "type": "paragraph"
+          },
+          "native-html-form": {
+            "count": 1,
+            "title": "Native HTML form",
+            "type": "paragraph"
+          },
+          "sendasformdata": {
+            "count": 1,
+            "title": "sendAsFormData",
+            "type": "paragraph"
+          },
+          "submit-result-key": {
             "count": 1,
             "title": "submit-result-key",
             "type": "paragraph"
@@ -437,6 +276,16 @@
           }
         }
       },
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
+        "hashes": {
+          "demo--particles-compute": {
+            "count": 1,
+            "title": "Demo — particles (compute)",
+            "type": "paragraph"
+          }
+        }
+      },
       "core/components/ui/form/checkbox/checkbox.md": {
         "title": "Checkbox",
         "hashes": {
@@ -571,18 +420,48 @@
             "type": "paragraph"
           }
         }
+      },
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "demo": {
+            "count": 1,
+            "title": "Demo",
+            "type": "paragraph"
+          },
+          "3d--shader-live-gpu-bridge": {
+            "count": 1,
+            "title": "3D → shader live (GPU bridge)",
+            "type": "paragraph"
+          },
+          "3d--webgpu-live": {
+            "count": 1,
+            "title": "3D → WebGPU live",
+            "type": "paragraph"
+          },
+          "post-fx--depth-in-sonic-3d": {
+            "count": 1,
+            "title": "Post FX + depth (in sonic-3d)",
+            "type": "paragraph"
+          },
+          "harris--patches--webgpu": {
+            "count": 1,
+            "title": "Harris → patches → WebGPU",
+            "type": "paragraph"
+          }
+        }
       }
     }
   },
   {
-    "search": "Plain HTML without Lit: HTML integration.\n",
+    "search": "Comme sonic-shader : si dataProvider (ou un ancêtre formDataProvider) contient des champs aux mêmes noms que l’API, ils pilotent le viewer sans JS.\n",
     "files": {
-      "core/components/functional/if/if.md": {
-        "title": "if",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "if": {
+          "form-auto-bind-formdataprovider": {
             "count": 1,
-            "title": "",
+            "title": "Form auto-bind (`formDataProvider`)",
             "type": "paragraph"
           }
         }
@@ -590,13 +469,178 @@
     }
   },
   {
-    "search": "Jsonata",
+    "search": "Conseil : séparer out-data-provider du form. Les entrées pures (fov, exposure, autoRotate, src…) ne sont jamais réécrites en out sur un DP partagé. yaw / distance / pitch restent publiables ; un changement manuel d’orbit coupe autoRotate.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
         "hashes": {
-          "jsonata": {
+          "form-auto-bind-formdataprovider": {
+            "count": 1,
+            "title": "Form auto-bind (`formDataProvider`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Gate paresseuse : un sonic-input name="yaw" ne déclenche pas la publication out (seul un lecteur sur ready / frame / cam* / hit*… le fait).\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "form-auto-bind-formdataprovider": {
+            "count": 1,
+            "title": "Form auto-bind (`formDataProvider`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Entrée : champs ci-dessus. Sortie (Sonic3dOutput) : cam* / target* / distance / yaw / pitch / pointer* / ready / hit*… With frame-out (or a listener on frameUrl / snapshot): lazy JPEG canvas capture → frameUrl + snapshot (SonicMediaRef). Event out. Publication paresseuse.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "sortie--dataprovider": {
+            "count": 1,
+            "title": "Sortie / dataProvider",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Le viewer lit asset ou src depuis le DP — la source (fetch, upload, HF) n’est pas couplée.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "asset-neutre-hf-plus-tard": {
+            "count": 1,
+            "title": "Asset neutre (HF plus tard)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "No shared WebGL context between sonic-3d and sonic-shader.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "shader-bridging": {
+            "count": 1,
+            "title": "Shader bridging",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Demo: Visual stack — 3D → shader live.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "shader-bridging": {
+            "count": 1,
+            "title": "Shader bridging",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Un sonic-shader / sonic-webgpu qui pointe #id s’enregistre via registerFrameConsumer : le 3D continue hors viewport (pas de dispose). Option explicite : play-offscreen.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "shader-bridging": {
+            "count": 1,
+            "title": "Shader bridging",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "el.stopMotion() coupe autoRotate et l’inertie OrbitControls. Quand la caméra est immobile depuis ~8 frames : event rest + champ out moving: 0|1. Attribut damping (défaut 0.08, 0 = off).\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "arrêt-net": {
+            "count": 1,
+            "title": "Arrêt net",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "When post-image is set, the scene renders to an offscreen target with a depth texture, then ShaderToy-style passes run inside the same Three context (post-buffer-a…post-image). Same GLSL as sonic-shader (mainImage, iChannel0–3, uParam0–3, sonicLinearDepth).\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "post-fx-in-viewer": {
+            "count": 1,
+            "title": "Post FX (in-viewer)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Demo: Visual stack — post depth edges.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "post-fx-in-viewer": {
+            "count": 1,
+            "title": "Post FX (in-viewer)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Pick / orbit still use scene geometry; frame-out captures the final canvas after post.\n",
+    "files": {
+      "core/components/functional/3d/3d.md": {
+        "title": "3D",
+        "hashes": {
+          "post-fx-in-viewer": {
             "count": 1,
+            "title": "Post FX (in-viewer)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Date",
+    "files": {
+      "core/components/functional/date/date.md": {
+        "title": "Date",
+        "hashes": {
+          "date": {
+            "count": 2,
             "title": "",
             "type": "page"
           }
@@ -605,14 +649,14 @@
     }
   },
   {
-    "search": "sonic-jsonata : 1 input → expression → 1 output (readonly).\n",
+    "search": "Nothing is displayed.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/date/date.md": {
+        "title": "Date",
         "hashes": {
-          "jsonata": {
+          "no-attribute": {
             "count": 1,
-            "title": "",
+            "title": "No attribute",
             "type": "paragraph"
           }
         }
@@ -620,14 +664,14 @@
     }
   },
   {
-    "search": "Unidirectional (fetch → compute → display), unlike sonic-mix.\n",
+    "search": "Displays the current date.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/date/date.md": {
+        "title": "Date",
         "hashes": {
-          "jsonata": {
+          "now": {
             "count": 1,
-            "title": "",
+            "title": "Now",
             "type": "paragraph"
           }
         }
@@ -635,12 +679,12 @@
     }
   },
   {
-    "search": "Offline : serviceURL="/docs-mock-api" — Local API demos.\n",
+    "search": "Displays a date from a timestamp.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/date/date.md": {
+        "title": "Date",
         "hashes": {
-          "jsonata": {
+          "date": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -650,14 +694,14 @@
     }
   },
   {
-    "search": "Change Top N → recalcul sans refetch.\n",
+    "search": "Displays a date from a string.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/date/date.md": {
+        "title": "Date",
         "hashes": {
-          "groupby--top-n": {
+          "date_string": {
             "count": 1,
-            "title": "Groupby + top N",
+            "title": "Date_string",
             "type": "paragraph"
           }
         }
@@ -665,14 +709,14 @@
     }
   },
   {
-    "search": "Change Tax % → même idée.\n",
+    "search": "Displays a period of time from start_date to end_date.When by itself start_date will act as dateif a start_date is not specified it will be set by the current date.if the end_date is anterior to start date date it will be used as the start_date. \n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/date/date.md": {
+        "title": "Date",
         "hashes": {
-          "totaux-somme--taxe": {
+          "start_date--end_date": {
             "count": 1,
-            "title": "Totaux (somme + taxe)",
+            "title": "Start_date / end_date",
             "type": "paragraph"
           }
         }
@@ -680,14 +724,1323 @@
     }
   },
   {
-    "search": "$ucFirst · $currency · $percent · $date · $toChart(items, labelKey, valueKey, datasetLabel?)\n",
+    "search": "ISO 639-1 Language Codes\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/date/date.md": {
+        "title": "Date",
+        "hashes": {
+          "language": {
+            "count": 1,
+            "title": "Language",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "For the list of supported timeZones, run Intl.supportedValuesOf('timeZone') in the console\n",
+    "files": {
+      "core/components/functional/date/date.md": {
+        "title": "Date",
+        "hashes": {
+          "time_zone": {
+            "count": 1,
+            "title": "Time_zone",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Deprecated\n",
+    "files": {
+      "core/components/functional/date/date.md": {
+        "title": "Date",
+        "hashes": {
+          "renderif": {
+            "count": 1,
+            "title": ".renderIf",
+            "type": "paragraph"
+          }
+        }
+      },
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "headersdataprovider": {
+            "count": 1,
+            "title": "HeadersDataProvider",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Fetch",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "fetch": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL="/docs-mock-api") to try examples offline.\n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "fetch": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The sonic-fetch component requests and stores API data. It extends the Fetcher and Subscriber mixins.\n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "fetch": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "In order to work properly the sonic-fetch component needs at least the following attributes.  \n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "basic-usage": {
+            "count": 1,
+            "title": "Basic usage",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "If no endPoint is specified it will be filled by the dataProvider ID instead  \n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "dataprovider-as-an-endpoint": {
+            "count": 1,
+            "title": "DataProvider as an endPoint",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "When the key attribute is present, only a sub-part of the data received is injected into the dataProvider.\nWe can use the dot syntax to target what we want to keep.\n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "key": {
+            "count": 1,
+            "title": "Key",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "For example if the data is {my:{data:{a:1,b:2}}} and the key is key="my.data", the data available in the dataProvider will be {a:1 , b:2}\n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "key": {
+            "count": 1,
+            "title": "Key",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "if the mime type of the content returned by the service begins with text/, then the dataProvider has a key named "text" which contains the text returned by the service.\n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "text-mode": {
+            "count": 1,
+            "title": "Text mode",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The noLoader attribute disables display of the default loader\n",
+    "files": {
+      "core/components/functional/fetch/fetch.md": {
+        "title": "Fetch",
+        "hashes": {
+          "noloader": {
+            "count": 1,
+            "title": "NoLoader",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "if",
+    "files": {
+      "core/components/functional/if/if.md": {
+        "title": "if",
+        "hashes": {
+          "if": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The sonic-if component shows its slot when .condition is true. In Lit, bind .condition from store-driven state (@subscribe on a formDataProvider field) — live preview and TypeScript source are the same file (docs-lit-demo):\n",
+    "files": {
+      "core/components/functional/if/if.md": {
+        "title": "if",
+        "hashes": {
+          "if": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Plain HTML without Lit: HTML integration.\n",
+    "files": {
+      "core/components/functional/if/if.md": {
+        "title": "if",
+        "hashes": {
+          "if": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Hugging Face infer",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "hugging-face-infer": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-hugging-face-infer: 1 input → Hugging Face model → 1 output (readonly), computed in the browser with Transformers.js. Data never leaves the device.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "hugging-face-infer": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The name names the engine: other inference paths (server, browser AI, …) will get their own sonic-<engine>-infer, with the same attributes, states, and typed outputs.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "hugging-face-infer": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Each demo stays idle until you click Try. The model downloads only after consent.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "examples": {
+            "count": 1,
+            "title": "Examples",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Image + depth / shader chains: Visual stack.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "text--zero-shot-classification": {
+            "count": 1,
+            "title": "Text — `zero-shot-classification`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Same component, different allowlist alias. Common patterns:\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "other-tasks-markup": {
+            "count": 1,
+            "title": "Other tasks (markup)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "<!-- Translation FR → EN -->\n<sonic-hugging-face-infer\n  model="fr-en"\n  inputProvider="event.edito.description"\n  outputProvider="event.edito.descriptionEn"\n  load="consent"\n  trigger="demand"\n  triggerProvider="translateClick"\n></sonic-hugging-face-infer>\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "other-tasks-markup": {
+            "count": 1,
+            "title": "Other tasks (markup)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "<!-- Dictation (Whisper) -->\n<sonic-hugging-face-infer\n  model="whisper-tiny"\n  inputProvider="voice.clipUrl"\n  outputProvider="voice.transcript"\n  load="consent"\n></sonic-hugging-face-infer>\n  \n\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "other-tasks-markup": {
+            "count": 1,
+            "title": "Other tasks (markup)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Load concorde-hugging-face-infer.bundle.js after the core, then call ConcordeHF.configureHuggingFace(…) once. Details: CDN addons.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "cdn-script--bootstrap": {
+            "count": 1,
+            "title": "CDN (script + bootstrap)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The script checks that ONNX Runtime binaries are exactly those expected by Transformers.js. Serve the folder with Cache-Control: public, max-age=31536000, immutable: the path includes the version and never changes. To upgrade: new folder, regression tests, then change version / url in config. The previous version can stay served.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "1-pin-and-host-the-runtime": {
+            "count": 1,
+            "title": "1. Pin and host the runtime",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The script prints size (sizeBytes) and license for you to verify.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "2-host-models-pinned-revision": {
+            "count": 1,
+            "title": "2. Host models (pinned revision)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Three ways to supply the runtime (runtime.source):\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "3-configure-once-at-startup": {
+            "count": 1,
+            "title": "3. Configure (once, at startup)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "<!-- Catalog: runs when the browser is idle, cached in IndexedDB -->\n<sonic-hugging-face-infer\n  model="multilingual-mini"\n  inputProvider="events"\n  outputProvider="search.vectors"\n  options='{"text":"label + edito.sub_title + categories.title"}'\n  load="idle"\n  persistResults\n></sonic-hugging-face-infer>\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "markup": {
+            "count": 1,
+            "title": "Markup",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "<!-- Query: on each keystroke (300 ms debounce) -->\n<sonic-hugging-face-infer\n  model="multilingual-mini"\n  inputProvider="searchForm.q"\n  outputProvider="search.query"\n  statusProvider="searchAiStatus"\n  debounce="300"\n></sonic-hugging-face-infer>\n  \n\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "markup": {
+            "count": 1,
+            "title": "Markup",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Ranking combines several inputs (events, vectors, query). With the TypeScript API:\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "markup": {
+            "count": 1,
+            "title": "Markup",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "On the JSONata side, $cosine(a, b) and $rankBySimilarity(items, vectors, query, topN?, minScore?) are available in sonic-jsonata (one input: group data under the same DataProvider).\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "markup": {
+            "count": 1,
+            "title": "Markup",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Methods: run(), loadModel(), accept(), decline().\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "attributes": {
+            "count": 1,
+            "title": "Attributes",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Guards, regardless of policy: switch to consent on data-saver, slow network (2G), or when the model exceeds consentAboveMB. A cached model loads without prompting. Choice is stored per alias and revision (hf.revokeConsent(alias) to clear). Nothing downloads while the input is empty.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "model-loading": {
+            "count": 1,
+            "title": "Model loading",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Consent without JavaScript (SDUI):\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "model-loading": {
+            "count": 1,
+            "title": "Model loading",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "{outputProvider root}/_state_ → { status } (loading | ready | error | empty), like sonic-jsonata, for sonic-states.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "states": {
+            "count": 1,
+            "title": "States",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Detailed status on statusProvider:\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "states": {
+            "count": 1,
+            "title": "States",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "ONNX Runtime is a WASM binary in every case (≈ 27 MB, ≈ 6.6 MB compressed for 1.31), including WebGPU: it downloads with the first model from your CDN, then is cached. It is not part of the component.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "webgpu-and-wasm": {
+            "count": 1,
+            "title": "WebGPU and WASM",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "What you control: CPU (WASM) execution when WebGPU is missing. Allowed per model (devices) and only under allowWasmUpToMB. Beyond that → unsupported; the page keeps working without the model.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "webgpu-and-wasm": {
+            "count": 1,
+            "title": "WebGPU and WASM",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "configureHuggingFace returns an API typed by the allowlist:\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "typescript": {
+            "count": 1,
+            "title": "TypeScript",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Cleanup: hf.clearModel(alias), hf.clearAll() (models, WASM, and results).\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "typescript": {
+            "count": 1,
+            "title": "TypeScript",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Supported tasks: feature-extraction, text-classification, zero-shot-classification, translation, token-classification, fill-mask, question-answering, image-classification, zero-shot-image-classification, object-detection, zero-shot-object-detection, image-feature-extraction, image-segmentation, depth-estimation, background-removal, image-to-text, audio-classification, automatic-speech-recognition. No free-form LLM (text-generation, etc.).\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "tasks-and-light-models": {
+            "count": 1,
+            "title": "Tasks and light models",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Indicative sizes (quantized); verify with hf-vendor.mjs before allowlisting, including license:\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "tasks-and-light-models": {
+            "count": 1,
+            "title": "Tasks and light models",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Produced images (cutout, depth, segmentation) come out as { width, height, channels, blob, url } (PNG). url is an ObjectURL attached on the main thread at publish time — chainable into sonic-shader / sonic-jsonata ($mediaUrl) without app glue. Images are not stored in IndexedDB.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "tasks-and-light-models": {
+            "count": 1,
+            "title": "Tasks and light models",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "End-to-end (depth + shader / Harris) : Visual stack.\n",
+    "files": {
+      "core/components/functional/infer/hugging-face/hugging-face-infer.md": {
+        "title": "Hugging Face infer",
+        "hashes": {
+          "tasks-and-light-models": {
+            "count": 1,
+            "title": "Tasks and light models",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Interactive (SDUI)",
+    "files": {
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {
+          "interactive-sdui": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Addon opt-in @supersoniks/concorde/interactive for declarative playable UIs under a strict CSP (no eval, no inline script, no on* handlers).\n",
+    "files": {
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {
+          "interactive-sdui": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "",
+    "files": {
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {}
+      }
+    }
+  },
+  {
+    "search": "Also: sonic-if accepts dataProvider + key + equals/not/truthy/gt/lt for SDUI. sonic-value accepts format="00000" or format="intl:fr-FR".\n",
+    "files": {
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {
+          "components": {
+            "count": 1,
+            "title": "Components",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Injected: $rand, $randInt, $clamp, $range, $set, $matrix, $rotate.$random and $now throw — use $rand(seed) and $action.t.\n",
+    "files": {
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {
+          "reducer-purity": {
+            "count": 1,
+            "title": "Reducer purity",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Declarative sound, multiplayer, persistence.\n",
+    "files": {
+      "core/components/functional/interactive/interactive.md": {
+        "title": "Interactive (SDUI)",
+        "hashes": {
+          "out-of-scope-this-pass": {
+            "count": 1,
+            "title": "Out of scope (this pass)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Jsonata",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-jsonata : 1 input → expression → 1 output (readonly).\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Unidirectional (fetch → compute → display), unlike sonic-mix.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Offline : serviceURL="/docs-mock-api" — Local API demos.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Change Top N → recalcul sans refetch.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "groupby--top-n": {
+            "count": 1,
+            "title": "Groupby + top N",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Change Tax % → même idée.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "totaux-somme--taxe": {
+            "count": 1,
+            "title": "Totaux (somme + taxe)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "$ucFirst · $currency · $percent · $date · $toChart(items, labelKey, valueKey, datasetLabel?) · $cosine · $rankBySimilarity · $mediaUrl(x) (string | {url} | {blobUrl})\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "helpers": {
+            "count": 1,
+            "title": "Helpers",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Pas de DOM, pas de réseau, pas d’eval. $mediaUrl ne crée pas d’ObjectURL (les producteurs HF / extract publient déjà url).\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "helpers": {
+            "count": 1,
+            "title": "Helpers",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Pour du multi-entrées ou une fonction TS : primitive derive.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "markup": {
+            "count": 1,
+            "title": "Markup",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Visual stack (3d → HF → jsonata → shader): Visual stack.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "markup": {
+            "count": 1,
+            "title": "Markup",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "{output}/_state_ → { status, error? } (loading | ready | error | empty). Brancher avec sonic-states.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "states": {
+            "count": 1,
+            "title": "States",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "List",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "list": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Try offline: serviceURL="/docs-mock-api" and dataProvider="api/users" with key="data" — see Local API demos. Recommended patterns: Data flow.\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "list": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The sonic-list component renders one row per entry in props (array from fetch or set on the element).\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "list": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "List extends Subscriber and Fetcher:\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "list": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "From a Lit parent, pass a function on the items property (ListItems). Each row is wrapped in a sonic-subscriber with dataProvider="…/list-item/n" (hover rows with debug).\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "row-renderer-items--recommended": {
+            "count": 1,
+            "title": "Row renderer (`items`) — recommended",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use .items=${fn} (property binding): Lit passes functions only as properties, not as HTML attributes — @property({ type: Function }) does not change that. Same for .noItems, .separator, .skeleton. The callback receives each row object (replacing data-bind / <sonic-value> in a <template>).\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "row-renderer-items--recommended": {
+            "count": 1,
+            "title": "Row renderer (`items`) — recommended",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Live demo + TypeScript source (one file, no Markdown copy):\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "row-renderer-items--recommended": {
+            "count": 1,
+            "title": "Row renderer (`items`) — recommended",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Implementation: src/docs/example/docs-users-list.ts — row markup in the items callback (item.first_name, …), same idea as replacing data-bind / <sonic-value> in a <template>.\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "row-renderer-items--recommended": {
+            "count": 1,
+            "title": "Row renderer (`items`) — recommended",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use metadata (even, odd, firstChild, …) or fields on each item (e.g. tpl with templateKey):\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "alternating-row-layouts": {
+            "count": 1,
+            "title": "Alternating row layouts",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "For plain HTML hosts, you can still declare <template> children (and data-value for templateKey, separator, no-item). That path is for HTML integration — not used in Concorde doc live demos.\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "html-template-children-integration-without-lit": {
+            "count": 1,
+            "title": "HTML `<template>` children (integration without Lit)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Each list row still gets dataProvider=&quot;[list]/list-item/[index]&quot;.\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "html-template-children-integration-without-lit": {
+            "count": 1,
+            "title": "HTML `<template>` children (integration without Lit)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Mix",
+    "files": {
+      "core/components/functional/mix/mix.md": {
+        "title": "Mix",
+        "hashes": {
+          "mix": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Mix allows you to mix several subsets of dataProvider in a new key/value structure which is itself associated with a new dataProvider. The data update is then bidirectional.\n",
+    "files": {
+      "core/components/functional/mix/mix.md": {
+        "title": "Mix",
+        "hashes": {
+          "mix": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Dot notation is supported to extract a sub-part of the data.\n",
+    "files": {
+      "core/components/functional/mix/mix.md": {
+        "title": "Mix",
+        "hashes": {
+          "mix": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "For example, if we declare dataproviders as follows :\n\nWe can rearrange the data as follows\n\nThen we can change values in both dataProviders programaticaly this way, they will stay in sync\n\nOr by using a form element\n\n",
+    "files": {
+      "core/components/functional/mix/mix.md": {
+        "title": "Mix",
+        "hashes": {
+          "mix": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Queue",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "queue": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Try offline: serviceURL=&quot;/docs-mock-api&quot; — see Local API demos. Row rendering: Data flow (.items property binding).\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "queue": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-queue loads data in batches. Each batch is an internal List with its own dataProvider (…/list-item/0, …/1, …).\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "queue": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "When the expression contains $offset and $limit, the queue:\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "lazy-load--offset-and-limit": {
+            "count": 1,
+            "title": "Lazy load — `$offset` and `$limit`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The doc mock implements this on GET /docs-mock-api/api/users?offset=…&amp;per_page=… (paginateUsers in src/docs/mock-api/router.ts).\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "lazy-load--offset-and-limit": {
+            "count": 1,
+            "title": "Lazy load — `$offset` and `$limit`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Wrap the queue in a fixed height with overflow-y-auto so lazy load triggers when scrolling inside the box (same layout as the TS starter demo-queue-templates).\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "lazy-load--offset-and-limit": {
+            "count": 1,
+            "title": "Lazy load — `$offset` and `$limit`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Try scrolling after load — batches of 4 users. Search e.g. George, Bluth, or zzz for empty results.\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "lazy-load--offset-and-limit": {
+            "count": 1,
+            "title": "Lazy load — `$offset` and `$limit`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Without $offset in the expression, the queue behaves like a single list (one batch), e.g. geo communes below.\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "expression-example": {
+            "count": 1,
+            "title": "Expression example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "One search field (name=&quot;q&quot;) on formDataProvider=&quot;filter&quot;. The queue listens via dataFilterProvider=&quot;filter&quot; and, on change:\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "filter--datafilterprovider--q": {
+            "count": 1,
+            "title": "Filter — `dataFilterProvider` + `q`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use filteredFields only when the form has extra fields that must not be sent to the API (e.g. filteredFields=&quot;rememberMe internalId&quot;).\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "filter--datafilterprovider--q": {
+            "count": 1,
+            "title": "Filter — `dataFilterProvider` + `q`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The mock API filters before pagination — same haystack logic as the starter (filterDocsUsers in src/docs/mock-api/fixtures.ts, used by paginateUsers in router.ts / Service Worker):\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
+        "hashes": {
+          "filter--datafilterprovider--q": {
+            "count": 1,
+            "title": "Filter — `dataFilterProvider` + `q`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Geo communes: expression uses $limit only (no $offset) — one request, one batch.\n",
+    "files": {
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
         "hashes": {
-          "helpers": {
+          "simple-batch-no-lazy-scroll": {
             "count": 1,
-            "title": "Helpers",
+            "title": "Simple batch (no lazy scroll)",
             "type": "paragraph"
           }
         }
@@ -695,14 +2048,14 @@
     }
   },
   {
-    "search": "Pas de DOM, pas de réseau, pas d’eval.\n",
+    "search": "Optional for hosts without Lit — see HTML integration.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/queue/queue.md": {
+        "title": "Queue",
         "hashes": {
-          "helpers": {
+          "html-template-children": {
             "count": 1,
-            "title": "Helpers",
+            "title": "HTML `<template>` children",
             "type": "paragraph"
           }
         }
@@ -710,29 +2063,29 @@
     }
   },
   {
-    "search": "Pour du multi-entrées ou une fonction TS : primitive derive.\n",
+    "search": "Router",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "markup": {
+          "router": {
             "count": 1,
-            "title": "Markup",
-            "type": "paragraph"
+            "title": "",
+            "type": "page"
           }
         }
       }
     }
   },
   {
-    "search": "{output}/_state_ → { status, error? } (loading | ready | error | empty). Brancher avec sonic-states.\n",
+    "search": "sonic-router watches document.location (pathname + hash) and renders the matching view.\n",
     "files": {
-      "core/components/functional/jsonata/jsonata.md": {
-        "title": "Jsonata",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "states": {
+          "router": {
             "count": 1,
-            "title": "States",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -740,27 +2093,27 @@
     }
   },
   {
-    "search": "List",
+    "search": "From a Lit parent, pass a .routes map (property binding — same rule as .items on list): keys are path patterns, values are render functions. Use fallback when nothing matches.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "list": {
+          "router": {
             "count": 1,
             "title": "",
-            "type": "page"
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Try offline: serviceURL=&quot;/docs-mock-api&quot; and dataProvider=&quot;api/users&quot; with key=&quot;data&quot; — see Local API demos. Recommended patterns: Data flow.\n",
+    "search": "Legacy HTML &lt;template data-route=&quot;…&quot;&gt; remains for hosts without Lit — HTML integration.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "list": {
+          "router": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -770,14 +2123,14 @@
     }
   },
   {
-    "search": "The sonic-list component renders one row per entry in props (array from fetch or set on the element).\n",
+    "search": "Route keys are matched against pathname + hash. A simple hash route #home matches when the location contains that segment.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "list": {
+          "static-routes-no-parameters": {
             "count": 1,
-            "title": "",
+            "title": "Static routes (no parameters)",
             "type": "paragraph"
           }
         }
@@ -785,14 +2138,14 @@
     }
   },
   {
-    "search": "List extends Subscriber and Fetcher:\n",
+    "search": "On the doc site, the page URL is already a hash (#…/router.md/router). Demos append a second hash for in-page routes (#…/router#home), use href + autoActive=&quot;strict&quot; on sonic-button for the active state, and history.replaceState on click so markdown is not reloaded (setDocsDemoSubHash in src/docs/docs-location.ts).\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "list": {
+          "static-routes-no-parameters": {
             "count": 1,
-            "title": "",
+            "title": "Static routes (no parameters)",
             "type": "paragraph"
           }
         }
@@ -800,14 +2153,14 @@
     }
   },
   {
-    "search": "From a Lit parent, pass a function on the items property (ListItems). Each row is wrapped in a sonic-subscriber with dataProvider=&quot;…/list-item/n&quot; (hover rows with debug).\n",
+    "search": "Two styles (see router.demo.ts and docs-router-params-demo):\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "row-renderer-items--recommended": {
+          "routes-with-parameters": {
             "count": 1,
-            "title": "Row renderer (`items`) — recommended",
+            "title": "Routes with parameters",
             "type": "paragraph"
           }
         }
@@ -815,14 +2168,14 @@
     }
   },
   {
-    "search": "Use .items=${fn} (property binding): Lit passes functions only as properties, not as HTML attributes — @property({ type: Function }) does not change that. Same for .noItems, .separator, .skeleton. The callback receives each row object (replacing data-bind / &lt;sonic-value&gt; in a &lt;template&gt;).\n",
+    "search": "Key uses :param segments. The render function receives an object { param: string }.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "row-renderer-items--recommended": {
+          "url-pattern-name": {
             "count": 1,
-            "title": "Row renderer (`items`) — recommended",
+            "title": "Url-pattern (`:name`)",
             "type": "paragraph"
           }
         }
@@ -830,14 +2183,14 @@
     }
   },
   {
-    "search": "Live demo + TypeScript source (one file, no Markdown copy):\n",
+    "search": "Key is a RegExp string with (\\d+) / (\\w+) groups. The render function receives an array of captured strings (in order).\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "row-renderer-items--recommended": {
+          "regexp-capturing-groups": {
             "count": 1,
-            "title": "Row renderer (`items`) — recommended",
+            "title": "RegExp (capturing groups)",
             "type": "paragraph"
           }
         }
@@ -845,14 +2198,14 @@
     }
   },
   {
-    "search": "Implementation: src/docs/example/docs-users-list.ts — row markup in the items callback (item.first_name, …), same idea as replacing data-bind / &lt;sonic-value&gt; in a &lt;template&gt;.\n",
+    "search": "With parameters you usually render data directly in Lit (${id}). The old &lt;template data-route&gt; + dataProviderExpression pattern scoped a dataProvider for data-bind / fetch children — prefer @subscribe or explicit props when using .routes.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "row-renderer-items--recommended": {
+          "regexp-capturing-groups": {
             "count": 1,
-            "title": "Row renderer (`items`) — recommended",
+            "title": "RegExp (capturing groups)",
             "type": "paragraph"
           }
         }
@@ -860,14 +2213,14 @@
     }
   },
   {
-    "search": "Use metadata (even, odd, firstChild, …) or fields on each item (e.g. tpl with templateKey):\n",
+    "search": "Always use .routes=${…} in Lit templates: route handlers are functions and must be set as properties, not HTML attributes.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "alternating-row-layouts": {
+          "routes-binding": {
             "count": 1,
-            "title": "Alternating row layouts",
+            "title": "`.routes` binding",
             "type": "paragraph"
           }
         }
@@ -875,14 +2228,14 @@
     }
   },
   {
-    "search": "For plain HTML hosts, you can still declare &lt;template&gt; children (and data-value for templateKey, separator, no-item). That path is for HTML integration — not used in Concorde doc live demos.\n",
+    "search": "Separate component: redirect when data appears on a publisher (login steps, wizards). Not part of the .routes map.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "html-template-children-integration-without-lit": {
+          "sonic-redirect": {
             "count": 1,
-            "title": "HTML `<template>` children (integration without Lit)",
+            "title": "`sonic-redirect`",
             "type": "paragraph"
           }
         }
@@ -890,14 +2243,14 @@
     }
   },
   {
-    "search": "Each list row still gets dataProvider=&quot;[list]/list-item/[index]&quot;.\n",
+    "search": "Example: combine with .routes and submit for login / logout / profile steps.\n",
     "files": {
-      "core/components/functional/list/list.md": {
-        "title": "List",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "html-template-children-integration-without-lit": {
+          "sonic-redirect": {
             "count": 1,
-            "title": "HTML `<template>` children (integration without Lit)",
+            "title": "`sonic-redirect`",
             "type": "paragraph"
           }
         }
@@ -905,44 +2258,44 @@
     }
   },
   {
-    "search": "Mix",
+    "search": "sonic-router-demo (router.demo.ts) — home, user profile (#user/:id/:slug), products RegExp, fallback 404.\n",
     "files": {
-      "core/components/functional/mix/mix.md": {
-        "title": "Mix",
+      "core/components/functional/router/router.md": {
+        "title": "Router",
         "hashes": {
-          "mix": {
+          "package-demo": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Package demo",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Mix allows you to mix several subsets of dataProvider in a new key/value structure which is itself associated with a new dataProvider. The data update is then bidirectional.\n",
+    "search": "SDUI",
     "files": {
-      "core/components/functional/mix/mix.md": {
-        "title": "Mix",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "mix": {
+          "sdui": {
             "count": 1,
             "title": "",
-            "type": "paragraph"
+            "type": "page"
           }
         }
       }
     }
   },
   {
-    "search": "Dot notation is supported to extract a sub-part of the data.\n",
+    "search": "SDUI stands for Server Driven User Interfaces.\nBasically, it generates a user interface based on a JSON SDUI Descriptor.\n",
     "files": {
-      "core/components/functional/mix/mix.md": {
-        "title": "Mix",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "mix": {
+          "what-is-sdui": {
             "count": 1,
-            "title": "",
+            "title": "What is SDUI?",
             "type": "paragraph"
           }
         }
@@ -950,14 +2303,14 @@
     }
   },
   {
-    "search": "For example, if we declare dataproviders as follows :\n\nWe can rearrange the data as follows\n\nThen we can change values in both dataProviders programaticaly this way, they will stay in sync\n\nOr by using a form element\n\n",
+    "search": "SDUI extends the mixin Subscriber.\nThis means that you must set a dataProvider with an id pointing to the publisher that will hold your SDUI Descriptor.\nThis also means that it has a reactive property named props that you can set with the JSON SDUI Descriptor in order to configure it.\n",
     "files": {
-      "core/components/functional/mix/mix.md": {
-        "title": "Mix",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "mix": {
+          "subscriber-extension": {
             "count": 1,
-            "title": "",
+            "title": "Subscriber extension:",
             "type": "paragraph"
           }
         }
@@ -965,29 +2318,29 @@
     }
   },
   {
-    "search": "Queue",
+    "search": "SDUI extends the mixin Fetcher as Fetch and List.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "queue": {
+          "fetcher-extension": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Fetcher extension:",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Try offline: serviceURL=&quot;/docs-mock-api&quot; — see Local API demos. Row rendering: Data flow (.items property binding).\n",
+    "search": "In this case, it will parse the JSON coming from the request.\nThe JSON must comply with the SDUI descriptor format.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "queue": {
+          "fetcher-extension": {
             "count": 1,
-            "title": "",
+            "title": "Fetcher extension:",
             "type": "paragraph"
           }
         }
@@ -995,14 +2348,14 @@
     }
   },
   {
-    "search": "sonic-queue loads data in batches. Each batch is an internal List with its own dataProvider (…/list-item/0, …/1, …).\n",
+    "search": "As a fetcher, invalidating the publisher or updating the endpoint will trigger a new fetch and update accordingly.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "queue": {
+          "fetcher-extension": {
             "count": 1,
-            "title": "",
+            "title": "Fetcher extension:",
             "type": "paragraph"
           }
         }
@@ -1010,14 +2363,14 @@
     }
   },
   {
-    "search": "When the expression contains $offset and $limit, the queue:\n",
+    "search": "It has no shadowdom, and its display style is set to contents, so an empty SDUI has the fewest impact on the layout.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "lazy-load--offset-and-limit": {
+          "rendering": {
             "count": 1,
-            "title": "Lazy load — `$offset` and `$limit`",
+            "title": "Rendering:",
             "type": "paragraph"
           }
         }
@@ -1025,14 +2378,14 @@
     }
   },
   {
-    "search": "The doc mock implements this on GET /docs-mock-api/api/users?offset=…&amp;per_page=… (paginateUsers in src/docs/mock-api/router.ts).\n",
+    "search": "An SDUINode represents an HTMLElement.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "lazy-load--offset-and-limit": {
+          "descriptor": {
             "count": 1,
-            "title": "Lazy load — `$offset` and `$limit`",
+            "title": "Descriptor",
             "type": "paragraph"
           }
         }
@@ -1040,14 +2393,14 @@
     }
   },
   {
-    "search": "Wrap the queue in a fixed height with overflow-y-auto so lazy load triggers when scrolling inside the box (same layout as the TS starter demo-queue-templates).\n",
+    "search": "TypeScript definition:\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "lazy-load--offset-and-limit": {
+          "descriptor": {
             "count": 1,
-            "title": "Lazy load — `$offset` and `$limit`",
+            "title": "Descriptor",
             "type": "paragraph"
           }
         }
@@ -1055,14 +2408,14 @@
     }
   },
   {
-    "search": "Try scrolling after load — batches of 4 users. Search e.g. George, Bluth, or zzz for empty results.\n",
+    "search": "Summary of properties:\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "lazy-load--offset-and-limit": {
+          "descriptor": {
             "count": 1,
-            "title": "Lazy load — `$offset` and `$limit`",
+            "title": "Descriptor",
             "type": "paragraph"
           }
         }
@@ -1070,14 +2423,14 @@
     }
   },
   {
-    "search": "Without $offset in the expression, the queue behaves like a single list (one batch), e.g. geo communes below.\n",
+    "search": "Use it if you prefer to define your node entirely using an HTML string.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "expression-example": {
+          "markup": {
             "count": 1,
-            "title": "Expression example",
+            "title": "Markup",
             "type": "paragraph"
           }
         }
@@ -1085,14 +2438,14 @@
     }
   },
   {
-    "search": "One search field (name=&quot;q&quot;) on formDataProvider=&quot;filter&quot;. The queue listens via dataFilterProvider=&quot;filter&quot; and, on change:\n",
+    "search": "Here we use the field tagName of SDUINode to create an element with tag name sonic-input.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "filter--datafilterprovider--q": {
+          "tag-name": {
             "count": 1,
-            "title": "Filter — `dataFilterProvider` + `q`",
+            "title": "Tag name",
             "type": "paragraph"
           }
         }
@@ -1100,14 +2453,14 @@
     }
   },
   {
-    "search": "Use filteredFields only when the form has extra fields that must not be sent to the API (e.g. filteredFields=&quot;rememberMe internalId&quot;).\n",
+    "search": "A string key/value pair storing each attribute name/value of the HTML element created.\nAs no tag name is defined, a div element is created.\nHere we define the style attribute to create a tiny red square.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "filter--datafilterprovider--q": {
+          "attributes": {
             "count": 1,
-            "title": "Filter — `dataFilterProvider` + `q`",
+            "title": "Attributes",
             "type": "paragraph"
           }
         }
@@ -1115,14 +2468,14 @@
     }
   },
   {
-    "search": "The mock API filters before pagination — same haystack logic as the starter (filterDocsUsers in src/docs/mock-api/fixtures.ts, used by paginateUsers in router.ts / Service Worker):\n",
+    "search": "Children of the current node can be added using the field nodes recursively.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "filter--datafilterprovider--q": {
+          "nodes": {
             "count": 1,
-            "title": "Filter — `dataFilterProvider` + `q`",
+            "title": "Nodes",
             "type": "paragraph"
           }
         }
@@ -1130,14 +2483,14 @@
     }
   },
   {
-    "search": "Geo communes: expression uses $limit only (no $offset) — one request, one batch.\n",
+    "search": "As no tag name is defined, a div element is created, and then we use innerHTML to add content to it.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "simple-batch-no-lazy-scroll": {
+          "innerhtml": {
             "count": 1,
-            "title": "Simple batch (no lazy scroll)",
+            "title": "InnerHTML",
             "type": "paragraph"
           }
         }
@@ -1145,14 +2498,14 @@
     }
   },
   {
-    "search": "Optional for hosts without Lit — see HTML integration.\n",
+    "search": "Use them if you want to wrap the component with some HTML string.\n",
     "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "html-template-children": {
+          "prefix-and-suffix": {
             "count": 1,
-            "title": "HTML `<template>` children",
+            "title": "Prefix and suffix",
             "type": "paragraph"
           }
         }
@@ -1160,29 +2513,29 @@
     }
   },
   {
-    "search": "Router",
+    "search": "The libraryKey of SDUINode is an identifier that points to an SDUINode description in the library to be used as a model for this node.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "router": {
+          "library-key-and-contentelementselector": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Library key and contentElementSelector",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "sonic-router watches document.location (pathname + hash) and renders the matching view.\n",
+    "search": "Note that the SDUI has a default library containing some basic component definitions useful for form declaration (see default-library.json).\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "router": {
+          "library-key-and-contentelementselector": {
             "count": 1,
-            "title": "",
+            "title": "Library key and contentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1190,14 +2543,14 @@
     }
   },
   {
-    "search": "From a Lit parent, pass a .routes map (property binding — same rule as .items on list): keys are path patterns, values are render functions. Use fallback when nothing matches.\n",
+    "search": "This example uses the library key submit which points to a sonic-submit containing a button also coming from the library.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "router": {
+          "library-key-and-contentelementselector": {
             "count": 1,
-            "title": "",
+            "title": "Library key and contentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1205,14 +2558,14 @@
     }
   },
   {
-    "search": "Legacy HTML &lt;template data-route=&quot;…&quot;&gt; remains for hosts without Lit — HTML integration.\n",
+    "search": "The element named button in the library is a sonic-button of type success containing a check icon as a prefix.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "router": {
+          "library-key-and-contentelementselector": {
             "count": 1,
-            "title": "",
+            "title": "Library key and contentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1220,14 +2573,14 @@
     }
   },
   {
-    "search": "Route keys are matched against pathname + hash. A simple hash route #home matches when the location contains that segment.\n",
+    "search": "Since the submit library element contains an attribute contentElementSelector with the value sonic-button, the &quot;injected content&quot; is put inside the button.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "static-routes-no-parameters": {
+          "library-key-and-contentelementselector": {
             "count": 1,
-            "title": "Static routes (no parameters)",
+            "title": "Library key and contentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1235,14 +2588,14 @@
     }
   },
   {
-    "search": "On the doc site, the page URL is already a hash (#…/router.md/router). Demos append a second hash for in-page routes (#…/router#home), use href + autoActive=&quot;strict&quot; on sonic-button for the active state, and history.replaceState on click so markdown is not reloaded (setDocsDemoSubHash in src/docs/docs-location.ts).\n",
+    "search": "We used innerHTML for the sake of simplicity, but you can use nodes to add any complex content.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "static-routes-no-parameters": {
+          "library-key-and-contentelementselector": {
             "count": 1,
-            "title": "Static routes (no parameters)",
+            "title": "Library key and contentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1250,14 +2603,14 @@
     }
   },
   {
-    "search": "Two styles (see router.demo.ts and docs-router-params-demo):\n",
+    "search": "This special field lets you inject the content at any place in the HTML flow already set inside the parent SDUI component by using a CSS selector.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "routes-with-parameters": {
+          "parentelementselector": {
             "count": 1,
-            "title": "Routes with parameters",
+            "title": "parentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1265,14 +2618,14 @@
     }
   },
   {
-    "search": "Key uses :param segments. The render function receives an object { param: string }.\n",
+    "search": "⚠️ Note that it doesn&#39;t work with top-level nodes.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "url-pattern-name": {
+          "parentelementselector": {
             "count": 1,
-            "title": "Url-pattern (`:name`)",
+            "title": "parentElementSelector",
             "type": "paragraph"
           }
         }
@@ -1280,14 +2633,14 @@
     }
   },
   {
-    "search": "Key is a RegExp string with (\\d+) / (\\w+) groups. The render function receives an array of captured strings (in order).\n",
+    "search": "The transformers let you transform the structure of the SDUI Descriptor into a new one before parsing and rendering it.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "regexp-capturing-groups": {
+          "transformers": {
             "count": 1,
-            "title": "RegExp (capturing groups)",
+            "title": "Transformers:",
             "type": "paragraph"
           }
         }
@@ -1295,14 +2648,14 @@
     }
   },
   {
-    "search": "With parameters you usually render data directly in Lit (${id}). The old &lt;template data-route&gt; + dataProviderExpression pattern scoped a dataProvider for data-bind / fetch children — prefer @subscribe or explicit props when using .routes.\n",
+    "search": "To enable it, you must fill the transformation attribute of the component with a URL pointing to a Transform descriptor.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "regexp-capturing-groups": {
+          "transformers": {
             "count": 1,
-            "title": "RegExp (capturing groups)",
+            "title": "Transformers:",
             "type": "paragraph"
           }
         }
@@ -1310,14 +2663,14 @@
     }
   },
   {
-    "search": "Always use .routes=${…} in Lit templates: route handlers are functions and must be set as properties, not HTML attributes.\n",
+    "search": "Each key of the library will be merged with the current library in the SDUI Descriptor, by replacing or creating items library key by key.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "routes-binding": {
+          "the-library": {
             "count": 1,
-            "title": "`.routes` binding",
+            "title": "The library:",
             "type": "paragraph"
           }
         }
@@ -1325,14 +2678,14 @@
     }
   },
   {
-    "search": "Separate component: redirect when data appears on a publisher (login steps, wizards). Not part of the .routes map.\n",
+    "search": "Each transform represents an action that will be done on the SDUI descriptor before the creation of the entire UI.\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "sonic-redirect": {
+          "the-transform-actions": {
             "count": 1,
-            "title": "`sonic-redirect`",
+            "title": "The transform actions:",
             "type": "paragraph"
           }
         }
@@ -1340,14 +2693,14 @@
     }
   },
   {
-    "search": "Example: combine with .routes and submit for login / logout / profile steps.\n",
+    "search": "The action that will be done is a verb:\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "sonic-redirect": {
+          "the-transform-actions": {
             "count": 1,
-            "title": "`sonic-redirect`",
+            "title": "The transform actions:",
             "type": "paragraph"
           }
         }
@@ -1355,14 +2708,14 @@
     }
   },
   {
-    "search": "sonic-router-demo (router.demo.ts) — home, user profile (#user/:id/:slug), products RegExp, fallback 404.\n",
+    "search": "This is an HTML attribute to set on the component if needed. In this case, the component will not treat its props value directly as an SDUI descriptor. Internally, it will basically extract the SDUIDescriptor by doing something like this: const sduiDescriptor = this.props[this.sduikey].\n",
     "files": {
-      "core/components/functional/router/router.md": {
-        "title": "Router",
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
         "hashes": {
-          "package-demo": {
+          "sduikey": {
             "count": 1,
-            "title": "Package demo",
+            "title": "sduiKey",
             "type": "paragraph"
           }
         }
@@ -1370,29 +2723,29 @@
     }
   },
   {
-    "search": "SDUI",
+    "search": "This is an HTML attribute to set on the component if needed. In this case, the component will automatically create a sonic-toast-message-subscriber component. The data found in props[messageKey] will be treated as the data expected by the sonic-toast-message-subscriber. So, by respecting the format of data supported by this component, you will be able to show multiple toasts in the result of a request.\n",
     "files": {
       "core/components/functional/sdui/sdui.md": {
         "title": "SDUI",
         "hashes": {
-          "sdui": {
+          "messagekey": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "messageKey",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "SDUI stands for Server Driven User Interfaces.\nBasically, it generates a user interface based on a JSON SDUI Descriptor.\n",
+    "search": "Example of JSON with messageKey=messages:\n\n",
     "files": {
       "core/components/functional/sdui/sdui.md": {
         "title": "SDUI",
         "hashes": {
-          "what-is-sdui": {
+          "messagekey": {
             "count": 1,
-            "title": "What is SDUI?",
+            "title": "messageKey",
             "type": "paragraph"
           }
         }
@@ -1400,14 +2753,14 @@
     }
   },
   {
-    "search": "SDUI extends the mixin Subscriber.\nThis means that you must set a dataProvider with an id pointing to the publisher that will hold your SDUI Descriptor.\nThis also means that it has a reactive property named props that you can set with the JSON SDUI Descriptor in order to configure it.\n",
+    "search": "This is an HTML attribute to set on the component if needed. You can set a URL pointing to a JSON describing a library with the same structure as the library in the SDUIDescriptor. The component will simply override its library with the given one.\n",
     "files": {
       "core/components/functional/sdui/sdui.md": {
         "title": "SDUI",
         "hashes": {
-          "subscriber-extension": {
+          "library": {
             "count": 1,
-            "title": "Subscriber extension:",
+            "title": "library",
             "type": "paragraph"
           }
         }
@@ -1415,14 +2768,14 @@
     }
   },
   {
-    "search": "SDUI extends the mixin Fetcher as Fetch and List.\n",
+    "search": "Here is a little playground to let you test some simple tricks.\n",
     "files": {
       "core/components/functional/sdui/sdui.md": {
         "title": "SDUI",
         "hashes": {
-          "fetcher-extension": {
+          "playground": {
             "count": 1,
-            "title": "Fetcher extension:",
+            "title": "Playground",
             "type": "paragraph"
           }
         }
@@ -1430,29 +2783,29 @@
     }
   },
   {
-    "search": "In this case, it will parse the JSON coming from the request.\nThe JSON must comply with the SDUI descriptor format.\n",
+    "search": "Shader",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "fetcher-extension": {
+          "shader": {
             "count": 1,
-            "title": "Fetcher extension:",
-            "type": "paragraph"
+            "title": "",
+            "type": "page"
           }
         }
       }
     }
   },
   {
-    "search": "As a fetcher, invalidating the publisher or updating the endpoint will trigger a new fetch and update accordingly.\n",
+    "search": "sonic-shader — renderer WebGL2 compatible ShaderToy (pass Image + buffers A–D + Common).\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "fetcher-extension": {
+          "shader": {
             "count": 1,
-            "title": "Fetcher extension:",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -1460,14 +2813,14 @@
     }
   },
   {
-    "search": "It has no shadowdom, and its display style is set to contents, so an empty SDUI has the fewest impact on the layout.\n",
+    "search": "For WGSL / WebGPU (1 pass, same DP glue): sonic-webgpu.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "rendering": {
+          "shader": {
             "count": 1,
-            "title": "Rendering:",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -1475,14 +2828,14 @@
     }
   },
   {
-    "search": "An SDUINode represents an HTMLElement.\n",
+    "search": "CDN (after the core): concorde-shader.bundle.js — see CDN addons.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "descriptor": {
+          "shader": {
             "count": 1,
-            "title": "Descriptor",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -1490,14 +2843,14 @@
     }
   },
   {
-    "search": "TypeScript definition:\n",
+    "search": "Uniforms supportés : iResolution, iTime, iTimeDelta, iFrame, iFrameRate, iMouse, iDate, iChannel0–3, iChannelResolution, iChannelTime, iSampleRate, uParam0–3.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "descriptor": {
+          "shader": {
             "count": 1,
-            "title": "Descriptor",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -1505,14 +2858,14 @@
     }
   },
   {
-    "search": "Summary of properties:\n",
+    "search": "Textures channel0–3 : images, vidéos (.webm / .mp4 / …), ou éléments page via #id (&lt;img&gt;, &lt;video&gt;, &lt;canvas&gt;, sonic-3d / sonic-webgpu / sonic-shader).\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "descriptor": {
+          "shader": {
             "count": 1,
-            "title": "Descriptor",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -1520,14 +2873,14 @@
     }
   },
   {
-    "search": "Use it if you prefer to define your node entirely using an HTML string.\n",
+    "search": "Buffer A simule une height-map d’ondes (ripple) ; Image réfracte la photo via le gradient — sans teinte. Glisser la souris pour faire des vagues.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "markup": {
+          "multipass-sur-une-photo": {
             "count": 1,
-            "title": "Markup",
+            "title": "Multipass sur une photo",
             "type": "paragraph"
           }
         }
@@ -1535,14 +2888,14 @@
     }
   },
   {
-    "search": "Here we use the field tagName of SDUINode to create an element with tag name sonic-input.\n",
+    "search": "Photo + depth parallax (HF): Visual stack.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "tag-name": {
+          "multipass-sur-une-photo": {
             "count": 1,
-            "title": "Tag name",
+            "title": "Multipass sur une photo",
             "type": "paragraph"
           }
         }
@@ -1550,14 +2903,14 @@
     }
   },
   {
-    "search": "A string key/value pair storing each attribute name/value of the HTML element created.\nAs no tag name is defined, a div element is created.\nHere we define the style attribute to create a tiny red square.\n",
+    "search": "Live 3D → shader (no JPEG): Visual stack.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "attributes": {
+          "multipass-sur-une-photo": {
             "count": 1,
-            "title": "Attributes",
+            "title": "Multipass sur une photo",
             "type": "paragraph"
           }
         }
@@ -1565,14 +2918,14 @@
     }
   },
   {
-    "search": "Children of the current node can be added using the field nodes recursively.\n",
+    "search": "Règle : brancher des passes dans un sonic-shader (buffers A–D → Image), pas deux composants via dataProvider — sauf pont live #élément (copie canvas chaque frame).\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "nodes": {
+          "chaînage-deffets-officiel": {
             "count": 1,
-            "title": "Nodes",
+            "title": "Chaînage d’effets (officiel)",
             "type": "paragraph"
           }
         }
@@ -1580,14 +2933,14 @@
     }
   },
   {
-    "search": "As no tag name is defined, a div element is created, and then we use innerHTML to add content to it.\n",
+    "search": "Les passes intermédiaires sont déjà offscreen (FBO). Pas besoin d’un second sonic-shader invisible pour du multipass interne.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "innerhtml": {
+          "chaînage-deffets-officiel": {
             "count": 1,
-            "title": "InnerHTML",
+            "title": "Chaînage d’effets (officiel)",
             "type": "paragraph"
           }
         }
@@ -1595,14 +2948,14 @@
     }
   },
   {
-    "search": "Use them if you want to wrap the component with some HTML string.\n",
+    "search": "Deux instances séparées ne partagent pas leurs textures WebGL (contextes distincts). Le pont live #id copie le canvas source ; frame-out JPEG reste pour export / freeze.\nDémo pédagogique : Buffer&nbsp;A = Sobel → Image = overlay + param0.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "prefix-and-suffix": {
+          "chaînage-deffets-officiel": {
             "count": 1,
-            "title": "Prefix and suffix",
+            "title": "Chaînage d’effets (officiel)",
             "type": "paragraph"
           }
         }
@@ -1610,14 +2963,14 @@
     }
   },
   {
-    "search": "The libraryKey of SDUINode is an identifier that points to an SDUINode description in the library to be used as a model for this node.\n",
+    "search": "Exemple de câblage :\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library-key-and-contentelementselector": {
+          "chaînage-deffets-officiel": {
             "count": 1,
-            "title": "Library key and contentElementSelector",
+            "title": "Chaînage d’effets (officiel)",
             "type": "paragraph"
           }
         }
@@ -1625,14 +2978,14 @@
     }
   },
   {
-    "search": "Note that the SDUI has a default library containing some basic component definitions useful for form declaration (see default-library.json).\n",
+    "search": "Au survol, le composant anime un uParamN de 0 → 1 (et l’inverse au leave), avec easing hover-speed. Le shader lit ce param pour mixer l’effet on/off (zoom, aberration, ripple…). play-on-hover n’anime que pendant le hover / la transition.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library-key-and-contentelementselector": {
+          "rollover--roll-out-hover-param": {
             "count": 1,
-            "title": "Library key and contentElementSelector",
+            "title": "Rollover / roll-out (`hover-param`)",
             "type": "paragraph"
           }
         }
@@ -1640,14 +2993,14 @@
     }
   },
   {
-    "search": "This example uses the library key submit which points to a sonic-submit containing a button also coming from the library.\n",
+    "search": "Type : ShaderHoverParam = 0 | 1 | 2 | 3 | &quot;param0&quot;…&quot;param3&quot; | &quot;&quot;.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library-key-and-contentelementselector": {
+          "rollover--roll-out-hover-param": {
             "count": 1,
-            "title": "Library key and contentElementSelector",
+            "title": "Rollover / roll-out (`hover-param`)",
             "type": "paragraph"
           }
         }
@@ -1655,14 +3008,14 @@
     }
   },
   {
-    "search": "The element named button in the library is a sonic-button of type success containing a check icon as a prefix.\n",
+    "search": "dataProvider est bidirectionnel : param0… en entrée ; en sortie mouseX / mouseY / hovering / frame (+ param0… si out-data-provider est séparé, ou le slot hover-param seul si le DP est partagé avec le formulaire). Avec sample, lit la couleur sous le curseur → sampleR/G/B/A + sampleLuma (SonicShaderOutput). Event out (payload complet, y compris les params). Optionnel : out-data-provider pour séparer l’écriture.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library-key-and-contentelementselector": {
+          "sortie--sampling-sample--dataprovider": {
             "count": 1,
-            "title": "Library key and contentElementSelector",
+            "title": "Sortie / sampling (`sample` + dataProvider)",
             "type": "paragraph"
           }
         }
@@ -1670,14 +3023,14 @@
     }
   },
   {
-    "search": "Since the submit library element contains an attribute contentElementSelector with the value sonic-button, the &quot;injected content&quot; is put inside the button.\n",
+    "search": "Publication paresseuse : rien n’est écrit (ni readPixels) tant qu’aucun champ méta/sample n’a de lecteur DP (@handle(frame) / @subscribe / sonic-value…) et qu’aucun listener out n’est branché. Un sonic-input name=&quot;param0&quot; ne compte pas comme consommateur out (évite le write-back qui remettait les champs à 0). Dès qu’un vrai consommateur apparaît, les maj partent au rythme de out-interval. Avec sample, le readPixels suit le même gate.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library-key-and-contentelementselector": {
+          "sortie--sampling-sample--dataprovider": {
             "count": 1,
-            "title": "Library key and contentElementSelector",
+            "title": "Sortie / sampling (`sample` + dataProvider)",
             "type": "paragraph"
           }
         }
@@ -1685,14 +3038,14 @@
     }
   },
   {
-    "search": "We used innerHTML for the sake of simplicity, but you can use nodes to add any complex content.\n",
+    "search": "Pattern typique — écoute frame + lecture massive :\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library-key-and-contentelementselector": {
+          "sortie--sampling-sample--dataprovider": {
             "count": 1,
-            "title": "Library key and contentElementSelector",
+            "title": "Sortie / sampling (`sample` + dataProvider)",
             "type": "paragraph"
           }
         }
@@ -1700,14 +3053,14 @@
     }
   },
   {
-    "search": "This special field lets you inject the content at any place in the HTML flow already set inside the parent SDUI component by using a CSS selector.\n",
+    "search": "A GPU pass writes a score mask (R channel) into a buffer; extract scans it, crops patches around peaks, and publishes scalars + blobUrl for downstream use.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "parentelementselector": {
+          "extraction-patches--singularities-extract": {
             "count": 1,
-            "title": "parentElementSelector",
+            "title": "Extraction patches / singularities (`extract`)",
             "type": "paragraph"
           }
         }
@@ -1715,14 +3068,14 @@
     }
   },
   {
-    "search": "⚠️ Note that it doesn&#39;t work with top-level nodes.\n",
+    "search": "detect scores: mask R channel (prefer a soft map, not hard-clipped), then renormalized to the best peak in the batch (1 = strongest). findPeaks sorts and keeps the top ones (NMS ≈ min(patch/3, 16) px).\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "parentelementselector": {
+          "extraction-patches--singularities-extract": {
             "count": 1,
-            "title": "parentElementSelector",
+            "title": "Extraction patches / singularities (`extract`)",
             "type": "paragraph"
           }
         }
@@ -1730,14 +3083,14 @@
     }
   },
   {
-    "search": "The transformers let you transform the structure of the SDUI Descriptor into a new one before parsing and rendering it.\n",
+    "search": "Lazy: no readPixels without a DP reader / extract event listener.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "transformers": {
+          "extraction-patches--singularities-extract": {
             "count": 1,
-            "title": "Transformers:",
+            "title": "Extraction patches / singularities (`extract`)",
             "type": "paragraph"
           }
         }
@@ -1745,14 +3098,14 @@
     }
   },
   {
-    "search": "To enable it, you must fill the transformation attribute of the component with a URL pointing to a Transform descriptor.\n",
+    "search": "Live Harris → patches → WebGPU: Visual stack.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "transformers": {
+          "extraction-patches--singularities-extract": {
             "count": 1,
-            "title": "Transformers:",
+            "title": "Extraction patches / singularities (`extract`)",
             "type": "paragraph"
           }
         }
@@ -1760,14 +3113,14 @@
     }
   },
   {
-    "search": "Each key of the library will be merged with the current library in the SDUI Descriptor, by replacing or creating items library key by key.\n",
+    "search": "Par défaut, les buffers A–D sont en RGBA8 (unsigned). Un tenseur Harris naïf (Ix*Ix, Iy*Iy, Ix*Iy) perd le signe de IxIy et sature les carrés → bords au lieu de coins.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "the-library": {
+          "précision-des-buffers-buffer-format": {
             "count": 1,
-            "title": "The library:",
+            "title": "Précision des buffers (`buffer-format`)",
             "type": "paragraph"
           }
         }
@@ -1775,14 +3128,14 @@
     }
   },
   {
-    "search": "Each transform represents an action that will be done on the SDUI descriptor before the creation of the entire UI.\n",
+    "search": "Repli auto en rgba8 si EXT_color_buffer_float est absent (console.warn une fois). L’attribut reflété active-buffer-format indique le format réellement utilisé. La passe Image reste le canvas RGBA8.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "the-transform-actions": {
+          "précision-des-buffers-buffer-format": {
             "count": 1,
-            "title": "The transform actions:",
+            "title": "Précision des buffers (`buffer-format`)",
             "type": "paragraph"
           }
         }
@@ -1790,14 +3143,14 @@
     }
   },
   {
-    "search": "The action that will be done is a verb:\n",
+    "search": "Un shader qui garde un état via self (feedback frame précédente) n’est plus réinitialisé quand il sort de l’écran : avec release-offscreen=&quot;auto&quot; (défaut), seuls le RAF et les vidéos sont mis en pause ; les FBO restent. Forcer release-offscreen (attribut booléen / true) restaure l’ancien comportement (libération hors viewport même avec self).\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "the-transform-actions": {
+          "état-et-visibilité": {
             "count": 1,
-            "title": "The transform actions:",
+            "title": "État et visibilité",
             "type": "paragraph"
           }
         }
@@ -1805,14 +3158,14 @@
     }
   },
   {
-    "search": "This is an HTML attribute to set on the component if needed. In this case, the component will not treat its props value directly as an SDUI descriptor. Internally, it will basically extract the SDUIDescriptor by doing something like this: const sduiDescriptor = this.props[this.sduikey].\n",
+    "search": "Changer channel0…3 / *-ch* re-lie les textures sans recompiler ni vider les buffers.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "sduikey": {
+          "état-et-visibilité": {
             "count": 1,
-            "title": "sduiKey",
+            "title": "État et visibilité",
             "type": "paragraph"
           }
         }
@@ -1820,14 +3173,14 @@
     }
   },
   {
-    "search": "This is an HTML attribute to set on the component if needed. In this case, the component will automatically create a sonic-toast-message-subscriber component. The data found in props[messageKey] will be treated as the data expected by the sonic-toast-message-subscriber. So, by respecting the format of data supported by this component, you will be able to show multiple toasts in the result of a request.\n",
+    "search": "Assigne le GLSL via .image (et .bufferA, …) depuis JS / Lit.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "messagekey": {
+          "markup": {
             "count": 1,
-            "title": "messageKey",
+            "title": "Markup",
             "type": "paragraph"
           }
         }
@@ -1835,14 +3188,14 @@
     }
   },
   {
-    "search": "Example of JSON with messageKey=messages:\n\n",
+    "search": "error — compile / link / WebGL (detail.message, detail.pass, detail.infoLog).\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "messagekey": {
+          "events": {
             "count": 1,
-            "title": "messageKey",
+            "title": "Events",
             "type": "paragraph"
           }
         }
@@ -1850,14 +3203,14 @@
     }
   },
   {
-    "search": "This is an HTML attribute to set on the component if needed. You can set a URL pointing to a JSON describing a library with the same structure as the library in the SDUIDescriptor. The component will simply override its library with the given one.\n",
+    "search": "out — snapshot SonicShaderOutput (throttlé par out-interval, seulement s’il y a un listener) : souris, params, samples.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "library": {
+          "events": {
             "count": 1,
-            "title": "library",
+            "title": "Events",
             "type": "paragraph"
           }
         }
@@ -1865,14 +3218,14 @@
     }
   },
   {
-    "search": "Here is a little playground to let you test some simple tricks.\n",
+    "search": "extract — snapshot ShaderExtractOutput (throttlé, paresseux) : patches manuels + détectés.\n",
     "files": {
-      "core/components/functional/sdui/sdui.md": {
-        "title": "SDUI",
+      "core/components/functional/shader/shader.md": {
+        "title": "Shader",
         "hashes": {
-          "playground": {
+          "events": {
             "count": 1,
-            "title": "Playground",
+            "title": "Events",
             "type": "paragraph"
           }
         }
@@ -2302,7 +3655,142 @@
           },
           "args": {
             "count": 1,
-            "title": "Args",
+            "title": "Args",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Permet de mapper un nom de propriété de donnée source vers une propriété du subscriber à la volée\n",
+    "files": {
+      "core/components/functional/subscriber/subscriber.md": {
+        "title": "Subscriber",
+        "hashes": {
+          "propertymap": {
+            "count": 1,
+            "title": "PropertyMap",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "On peut utiliser cette fonction pour lier un publisher spécifique au composant si besoin.\n",
+    "files": {
+      "core/components/functional/subscriber/subscriber.md": {
+        "title": "Subscriber",
+        "hashes": {
+          "bindpublisher": {
+            "count": 1,
+            "title": "BindPublisher",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Par défaut on crée un shadow dom mais on peut demander à ne pas en avoir via cette propriété et un attribut associé.Cela se fait à l&#39;initialisation uniquement et n&#39;est pas modifiable lors de la vie du composant.\n",
+    "files": {
+      "core/components/functional/subscriber/subscriber.md": {
+        "title": "Subscriber",
+        "hashes": {
+          "noshadowdom": {
+            "count": 1,
+            "title": "NoShadowDom",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "styles ??title ??_props ??onAssign ??defferedDebug ??\n",
+    "files": {
+      "core/components/functional/subscriber/subscriber.md": {
+        "title": "Subscriber",
+        "hashes": {
+          "other-attributes-gathered-from-subscriberstoriests": {
+            "count": 1,
+            "title": "Other attributes gathered from subscriber.stories.ts",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Value",
+    "files": {
+      "core/components/functional/value/value.md": {
+        "title": "Value",
+        "hashes": {
+          "value": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Simply shows a value from a data provider.\nYou can target sub data value using dot syntax.\nThe value reacts to changes.\n",
+    "files": {
+      "core/components/functional/value/value.md": {
+        "title": "Value",
+        "hashes": {
+          "value": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "WebGPU",
+    "files": {
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
+        "hashes": {
+          "webgpu": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-webgpu — GPU compute / effects (companion to sonic-shader, not a clone).\n",
+    "files": {
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
+        "hashes": {
+          "webgpu": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Opt-in import:\n",
+    "files": {
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
+        "hashes": {
+          "webgpu": {
+            "count": 1,
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -2310,14 +3798,14 @@
     }
   },
   {
-    "search": "Permet de mapper un nom de propriété de donnée source vers une propriété du subscriber à la volée\n",
+    "search": "Harris → patches → WebGPU mosaic: Visual stack.\n",
     "files": {
-      "core/components/functional/subscriber/subscriber.md": {
-        "title": "Subscriber",
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
         "hashes": {
-          "propertymap": {
+          "webgpu": {
             "count": 1,
-            "title": "PropertyMap",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -2325,14 +3813,14 @@
     }
   },
   {
-    "search": "On peut utiliser cette fonction pour lier un publisher spécifique au composant si besoin.\n",
+    "search": "Simulation: param0 = speed, param1 = mouse attraction. WebGPU compute when available, otherwise CPU.\n",
     "files": {
-      "core/components/functional/subscriber/subscriber.md": {
-        "title": "Subscriber",
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
         "hashes": {
-          "bindpublisher": {
+          "demo--particles-compute": {
             "count": 1,
-            "title": "BindPublisher",
+            "title": "Demo — particles (compute)",
             "type": "paragraph"
           }
         }
@@ -2340,14 +3828,14 @@
     }
   },
   {
-    "search": "Par défaut on crée un shadow dom mais on peut demander à ne pas en avoir via cette propriété et un attribut associé.Cela se fait à l&#39;initialisation uniquement et n&#39;est pas modifiable lors de la vie du composant.\n",
+    "search": "Comme sonic-shader : channel0=&quot;#plateau&quot; copie le canvas source chaque frameSeq (copyExternalImageToTexture). La texture GPU est réutilisée tant que la taille ne change pas (pas de createTexture / rebuild bind group chaque frame).\n",
     "files": {
-      "core/components/functional/subscriber/subscriber.md": {
-        "title": "Subscriber",
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
         "hashes": {
-          "noshadowdom": {
+          "live-bridge-id": {
             "count": 1,
-            "title": "NoShadowDom",
+            "title": "Live bridge (`#id`)",
             "type": "paragraph"
           }
         }
@@ -2355,14 +3843,14 @@
     }
   },
   {
-    "search": "styles ??title ??_props ??onAssign ??defferedDebug ??\n",
+    "search": "Demo: Visual stack — 3D → WebGPU live.\n",
     "files": {
-      "core/components/functional/subscriber/subscriber.md": {
-        "title": "Subscriber",
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
         "hashes": {
-          "other-attributes-gathered-from-subscriberstoriests": {
+          "live-bridge-id": {
             "count": 1,
-            "title": "Other attributes gathered from subscriber.stories.ts",
+            "title": "Live bridge (`#id`)",
             "type": "paragraph"
           }
         }
@@ -2370,29 +3858,29 @@
     }
   },
   {
-    "search": "Value",
+    "search": "Same MediaRef / DP bridge as the rest of the stack. Live textures entre composants : pont #id / { element } (copie canvas), pas de contexte WebGPU partagé avec sonic-shader.\n",
     "files": {
-      "core/components/functional/value/value.md": {
-        "title": "Value",
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
         "hashes": {
-          "value": {
+          "chaining": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Chaining",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Simply shows a value from a data provider.\nYou can target sub data value using dot syntax.\nThe value reacts to changes.\n",
+    "search": "concorde-webgpu.bundle.js after the core.\n",
     "files": {
-      "core/components/functional/value/value.md": {
-        "title": "Value",
+      "core/components/functional/webgpu/webgpu.md": {
+        "title": "WebGPU",
         "hashes": {
-          "value": {
+          "cdn": {
             "count": 1,
-            "title": "",
+            "title": "CDN",
             "type": "paragraph"
           }
         }
@@ -3869,6 +5357,21 @@
       }
     }
   },
+  {
+    "search": "Opt-in addons (HF / shader / WebGPU): Visual stack.\n",
+    "files": {
+      "docs/_core-concept/dataFlow.md": {
+        "title": "Data flow",
+        "hashes": {
+          "quick-map": {
+            "count": 1,
+            "title": "Quick map",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Skill: concorde-get-set-dp in the package ai/ folder.\n",
     "files": {
@@ -7759,6 +9262,96 @@
       }
     }
   },
+  {
+    "search": "CDN addons",
+    "files": {
+      "docs/_getting-started/cdn-addons.md": {
+        "title": "CDN addons",
+        "hashes": {
+          "cdn-addons": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Heavy opt-in features stay out of concorde-core.bundle.js. Load the core bundle first, then the addon you need.\n",
+    "files": {
+      "docs/_getting-started/cdn-addons.md": {
+        "title": "CDN addons",
+        "hashes": {
+          "cdn-addons": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "npm: @supersoniks/concorde/bundle/3d, …/bundle/shader, …/bundle/webgpu, …/bundle/hugging-face-infer (IIFE). ESM twins: …/bundle/3d/es, etc.\n",
+    "files": {
+      "docs/_getting-started/cdn-addons.md": {
+        "title": "CDN addons",
+        "hashes": {
+          "cdn-addons": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Scripts in the descriptor are awaited before nodes are created. A failed loadJS throws (no UI parse without deps). Prefer the IIFE .bundle.js files. Descriptors (js[], markup, innerHTML) must be trusted.\n",
+    "files": {
+      "docs/_getting-started/cdn-addons.md": {
+        "title": "CDN addons",
+        "hashes": {
+          "sdui-js": {
+            "count": 1,
+            "title": "SDUI (`js[]`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The CE alone is not enough: configure runtime + allowlist once (page script or app entry). The IIFE exposes window.ConcordeHF.\n",
+    "files": {
+      "docs/_getting-started/cdn-addons.md": {
+        "title": "CDN addons",
+        "hashes": {
+          "hugging-face--minimal-bootstrap": {
+            "count": 1,
+            "title": "Hugging Face — minimal bootstrap",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Peer deps (npm, optional): three@0.180.0, @huggingface/transformers@4.3.0. Not needed when using the CDN IIFE addons (Three is inlined in concorde-3d; Transformers.js stays on its own CDN via configureHuggingFace).\n",
+    "files": {
+      "docs/_getting-started/cdn-addons.md": {
+        "title": "CDN addons",
+        "hashes": {
+          "hugging-face--minimal-bootstrap": {
+            "count": 1,
+            "title": "Hugging Face — minimal bootstrap",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Manual installation (Vite)",
     "files": {
@@ -8285,7 +9878,7 @@
     }
   },
   {
-    "search": "In the case where it can be directly used in a page, it should also be globally referenced, especially considering the creation of specific bundles in the future.\n",
+    "search": "In the case where it can be directly used in a page, it should also be globally referenced. Heavy / optional features (3d, shader, webgpu, hugging-face) use CDN addon bundles — see CDN addons — and must not be added to functional.ts / ui.ts.\n",
     "files": {
       "docs/_getting-started/create-a-component.md": {
         "title": "Creating components",
@@ -10133,5 +11726,215 @@
         }
       }
     }
+  },
+  {
+    "search": "Visual stack",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "visual-stack": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Examples of chaining opt-in addons (HF, shader, WebGPU, 3D). Outside the main “functional” flow.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "visual-stack": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Photo → sonic-hugging-face-infer (depth) → sonic-shader (parallax) → extract → sonic-jsonata (stats / thresholds).\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "hf-depth--parallax": {
+            "count": 1,
+            "title": "HF depth → parallax",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Do not pipe texture channels through jsonata on every frame / slider: that forces rebuilds. JSONata is for scalar derivatives, not the media bus.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "golden-rule": {
+            "count": 1,
+            "title": "Golden rule",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-3d and sonic-shader keep separate WebGL contexts. For realtime post, point a channel at the 3D host with #id — the shader copies the canvas each frame (texImage2D), no JPEG.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "3d--shader-live-gpu-bridge": {
+            "count": 1,
+            "title": "3D → shader live (GPU bridge)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Also accepted: &lt;img&gt;, &lt;video&gt;, &lt;canvas&gt;, or another Concorde host that implements SonicFrameSource (getFrameCanvas + frameSeq). DP form: { element: &quot;#plateau&quot; } or { element: el }.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "3d--shader-live-gpu-bridge": {
+            "count": 1,
+            "title": "3D → shader live (GPU bridge)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "frame-out (JPEG ObjectURL) remains for export / HF / freeze — not for live post.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "3d--shader-live-gpu-bridge": {
+            "count": 1,
+            "title": "3D → shader live (GPU bridge)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Same #id bridge as the shader: sonic-webgpu channel0=&quot;#plateau-gpu&quot; copies the 3D canvas each frameSeq via copyExternalImageToTexture (persistent texture — no recreate when size is stable).\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "3d--webgpu-live": {
+            "count": 1,
+            "title": "3D → WebGPU live",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Scene → offscreen color + depth → GLSL passes (post-*) in the same WebGL context. Use post-image-ch1=&quot;depth&quot; for edge / DoF-style effects without a second component.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "post-fx--depth-in-sonic-3d": {
+            "count": 1,
+            "title": "Post FX + depth (in sonic-3d)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-shader detects corners (Harris, buffer-format=&quot;rgba16f&quot; + NMS 5×5 / shape filter) and extracts patches → channel0…3 on sonic-webgpu (kernel=&quot;image&quot;): GPU mosaic.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "harris--patches--webgpu": {
+            "count": 1,
+            "title": "Harris → patches → WebGPU",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use buffer-format=&quot;rgba16f&quot; so signed IxIy / non-clamped Ix² survive the buffer (RGBA8 zeros negatives and saturates). See Shader — buffer precision.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "harris--patches--webgpu": {
+            "count": 1,
+            "title": "Harris → patches → WebGPU",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Channel rebinds and release-offscreen=&quot;auto&quot; (keep FBO state when a pass uses self) : Shader — état et visibilité.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "harris--patches--webgpu": {
+            "count": 1,
+            "title": "Harris → patches → WebGPU",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-3d live sources keep playing off-screen when a #id consumer is registered (or play-offscreen) — see 3D — bridging.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "harris--patches--webgpu": {
+            "count": 1,
+            "title": "Harris → patches → WebGPU",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "SonicMediaRef / SonicFrameSource / toMediaUrl / cloneMediaRef — @supersoniks/concorde/core/utils/mediaRef.\n",
+    "files": {
+      "docs/_misc/visual-stack.md": {
+        "title": "Visual stack",
+        "hashes": {
+          "media-contract": {
+            "count": 1,
+            "title": "Media contract",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
   }
-]
+]