@supersoniks/concorde 4.9.96 → 4.9.98-visual-stack.0

package/scripts/pre-build.mjs

@@ -1,22 +1,18 @@
-// console.log("hey");
-
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
 
-const __dirname = path.dirname(__filename);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
-/**
- * Generates concorde icons from svgs
- */
 console.log("🚀 Génération des Icones");
-let icons = { core: {} };
-let svgsPath = path.resolve("src/core/components/ui/icon/svgs");
-let iconFiles = fs.readdirSync(svgsPath, { withFileTypes: true });
+const icons = { core: {} };
+const svgsPath = path.resolve("src/core/components/ui/icon/svgs");
+const iconFiles = fs.readdirSync(svgsPath, { withFileTypes: true });
+
 iconFiles.forEach((file) => {
-  let fileName = file.name.split(".")[0];
-  icons["core"][fileName] = fs
+
+  const fileName = file.name.split(".")[0];
+  icons.core[fileName] = fs
     .readFileSync(svgsPath + "/" + file.name)
     .toString();
 });
@@ -26,78 +22,122 @@ fs.writeFileSync(
 );
 
 console.log("🚀 Maintenance des shortPath");
+
 function listFiles(dir) {
+
   let files = [];
-  let list = fs.readdirSync(dir);
+  const list = fs.readdirSync(dir);
+
   list.forEach((file) => {
-    const path = dir + "/" + file;
-    let stat = fs.statSync(path);
+
+    const filePath = dir + "/" + file;
+    const stat = fs.statSync(filePath);
+
     if (stat && stat.isDirectory()) {
-      files = files.concat(listFiles(path));
-    } else {
-      if (path.indexOf(".ts") != -1) {
-        files.push(path);
-      }
+
+      files = files.concat(listFiles(filePath));
+    } else if (filePath.indexOf(".ts") !== -1) {
+
+      files.push(filePath);
+
     }
+
   });
   return files;
+
 }
+
 const componentsFiles = listFiles(path.resolve(__dirname, "../src"));
+const isPublishableTs = (file) =>
+  file.match(/\.ts$/) &&
+  !file.match(/\.(spec|test|demo|stories|type-test)\.ts$/) &&
+  !file.includes("/docs/");
 //short notation for ts file
+
 const shortPathMapping = {};
+
 componentsFiles.forEach((file) => {
-  if (!file.match(/\.ts$/)) {
+
+  if (!isPublishableTs(file)) {
+
     return;
+
   }
+
   //add simplified path to tsconfig paths
+
   const filePath = file
     .replace(path.resolve(__dirname, "../src") + "/", "")
     .replace(".ts", "");
   //add path to tsconfig paths
+
   const split = filePath.split("/");
+
   if (split[1] == "components") {
+
     const last = split.pop();
+
     if (last == "types") {
+
       return;
+
     }
+
     const type = split[2];
     const subType = split[3];
+
     if (!last) {
+
       return;
+
     }
+
     if (shortPathMapping[`./${last}`]) {
+
       console.warn(
         `./${last} already exists in ${shortPathMapping[`./${last}`]} : ${file}`
       );
+
     }
+
     shortPathMapping[`./${last}`] = [file];
     shortPathMapping[`./${type}/${last}`] = [file];
+
     if (subType && subType != last) {
+
       shortPathMapping[`./${type}/${subType}/${last}`] = [file];
+
     }
   } else {
+
     split.shift();
     const joined = split.join("/");
+
     if (!joined) {
+
       return;
+
     }
+
     if (shortPathMapping[`./${joined}`]) {
+
       console.warn(
         `./${joined} already exists in ${shortPathMapping[`./${joined}`]}`
       );
+
     }
+
     shortPathMapping[`./${joined}`] = [file];
+
   }
+
 });
 
 //set paths in tsconfig
+
 const tsConfigPathModel = path.resolve(__dirname, "../src/tsconfig-model.json");
 const tsConfigPath = path.resolve(__dirname, "../src/tsconfig.json");
-let jsonString = fs.readFileSync(tsConfigPathModel);
-//remove comments from tsconfig
-jsonString = jsonString;
-
-const tsConfig = JSON.parse(jsonString);
+const tsConfig = JSON.parse(fs.readFileSync(tsConfigPathModel));
 tsConfig.compilerOptions.paths = { ...shortPathMapping };
 tsConfig.compilerOptions.paths["@supersoniks/concorde/dataProviderKey"] = [
   path.resolve(__dirname, "../src/core/utils/dataProviderKey.ts"),
@@ -106,28 +146,71 @@ tsConfig.compilerOptions.paths["@supersoniks/concorde/*"] = ["./*"];
 tsConfig.compilerOptions.paths["@concorde/*"] = ["./*"];
 fs.writeFileSync(tsConfigPath, JSON.stringify(tsConfig, null, 2));
 
-//Do the same using shrotpathMapping to fill the exports un package.json
+function typesPath(srcRelative) {
+
+  if (!srcRelative.endsWith(".ts")) return null;
+  return srcRelative
+    .replace(/^\.\/src\//, "./dist/types/")
+    .replace(/\.ts$/, ".d.ts");
+
+}
+
+function jsPath(srcRelative) {
+
+  if (!srcRelative.endsWith(".ts")) return null;
+  return srcRelative
+    .replace(/^\.\/src\//, "./dist/js/")
+    .replace(/\.ts$/, ".js");
+
+}
+
+function exportEntry(srcRelative) {
+
+  const types = typesPath(srcRelative);
+  const js = jsPath(srcRelative);
+  if (!types || !js) return srcRelative;
+  return { types, default: js };
+
+}
 
 const packageJsonPath = path.resolve(__dirname, "../package.json");
-let packageJson = JSON.parse(fs.readFileSync(packageJsonPath));
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath));
 
 const pExports = {
+
+  "./bundle": "./concorde-core.bundle.js",
+  "./bundle/3d": "./concorde-3d.bundle.js",
+  "./bundle/shader": "./concorde-shader.bundle.js",
+  "./bundle/webgpu": "./concorde-webgpu.bundle.js",
+  "./bundle/hugging-face-infer": "./concorde-hugging-face-infer.bundle.js",
+  "./bundle/3d/es": "./concorde-3d.es.js",
+  "./bundle/shader/es": "./concorde-shader.es.js",
+  "./bundle/webgpu/es": "./concorde-webgpu.es.js",
+  "./bundle/hugging-face-infer/es": "./concorde-hugging-face-infer.es.js",
   "./core/components/ui/icon/icons.json":
     "./src/core/components/ui/icon/icons.json",
   "./core/components/functional/sdui/default-library.json":
     "./src/core/components/functional/sdui/default-library.json",
-  "./dataProviderKey": "./src/core/utils/dataProviderKey.ts",
-  "./*": "./src/*.ts",
+  "./dataProviderKey": exportEntry("./src/core/utils/dataProviderKey.ts"),
+
+  "./*": {
+
+    types: "./dist/types/*.d.ts",
+    default: "./dist/js/*.js",
+  },
   "./vite-config": "./vite/config.js",
   "./rollup-plugin-*": "./rollup/plugin-*.js",
+
 };
 
-for (let key in shortPathMapping) {
-  // set key relative to project root
-  let p = shortPathMapping[key][0];
-  //set path relative to project source
-  p = p.replace(path.resolve(__dirname, "../src") + "/", "./src/");
-  pExports[key] = p;
+for (const key in shortPathMapping) {
+
+  const srcRelative = shortPathMapping[key][0].replace(
+    path.resolve(__dirname, "../src") + "/",
+    "./src/"
+  );
+  pExports[key] = exportEntry(srcRelative);
+
 }
 
 packageJson.exports = pExports;

package/scripts/pre-publish.mjs

@@ -1,77 +1,99 @@
 import fs from "fs";
 
-// Liste des fichiers requis
 const requiredFiles = [
-  'concorde-core.bundle.js',
-  'concorde-core.es.js',
-  'ai/AGENTS.md',
-  'scripts/ai-init.mjs',
+  "concorde-core.bundle.js",
+  "concorde-core.es.js",
+  "concorde-3d.bundle.js",
+  "concorde-3d.es.js",
+  "concorde-shader.bundle.js",
+  "concorde-shader.es.js",
+  "concorde-webgpu.bundle.js",
+  "concorde-webgpu.es.js",
+  "concorde-hugging-face-infer.bundle.js",
+  "concorde-hugging-face-infer.es.js",
+  "dist/types/decorators.d.ts",
+  "dist/js/decorators.js",
+  "ai/AGENTS.md",
+  "scripts/ai-init.mjs",
 ];
 
 let allFilesExist = true;
 
-requiredFiles.forEach((file) => {
-    if (!fs.existsSync(file)) {
-        console.error(`Le fichier requis est manquant: ${file}`);
-        allFilesExist = false;
-    }
-});
+for (const file of requiredFiles) {
+
+  if (!fs.existsSync(file)) {
+
+    console.error(`Le fichier requis est manquant: ${file}`);
+    allFilesExist = false;
+
+  }
+
+}
 
 if (!allFilesExist) {
 
-    console.error('❌ La publication est bloquée en raison de fichiers manquants.');
-    process.exit(1);  // Bloque la publication en renvoyant un code d'erreur
-} else {
-    //emoji check mark
-    console.log('✅ Tous les fichiers requis sont présents')
+  console.error("❌ La publication est bloquée en raison de fichiers manquants.");
+  process.exit(1);
+
 }
 
-// list ts files having console.log in their code ins the src folder
-// console.log("🚀 Maintenance des console.log");
+console.log("✅ Tous les fichiers requis sont présents");
+
 const consoleLogFiles = [];
+
 function listFiles(dir) {
-    let files = [];
-    let list = fs.readdirSync(dir);
-    list.forEach((file) => {
-        const path = dir + "/" + file;
-        let stat = fs.statSync(path);
-        if (stat && stat.isDirectory()) {
-            files = files.concat(listFiles(path));
-        } else {
-            if (path.indexOf(".ts") != -1) {
-                files.push(path);
-            }
-        }
+
+  let files = [];
+  const list = fs.readdirSync(dir);
+
+  for (const file of list) {
+
+    const filePath = dir + "/" + file;
+    const stat = fs.statSync(filePath);
+
+    if (stat && stat.isDirectory()) {
+
+      files = files.concat(listFiles(filePath));
+    } else if (filePath.indexOf(".ts") !== -1) {
+
+      files.push(filePath);
+
     }
-    );
-    return files;
+
+  }
+
+  return files;
+
 }
-const componentsFiles = listFiles('src');
-componentsFiles.forEach((file) => {
-    if (!file.match(/\.ts$/)) {
-        return;
-    }
-    const content
 
-    = fs.readFileSync(file, 'utf8');
-    if (content.includes('console.log')) {
-        consoleLogFiles.push(file);
-    }
+const componentsFiles = listFiles("src");
+
+for (const file of componentsFiles) {
+
+  if (!file.match(/\.ts$/)) continue;
+  const content = fs.readFileSync(file, "utf8");
+
+  if (content.includes("console.log")) {
+
+    consoleLogFiles.push(file);
+
+  }
+
 }
-);
 
 if (consoleLogFiles.length > 0) {
-    //add an error emoji    console.error('Les fichiers suivants contiennent des console.log:');
-    consoleLogFiles.forEach((file) => {
-        // ajouter une émoji puce
-        console.error(" - "+file);
-    }
-    );
 
-    console.error('❌ La publication est bloquée en raison de la présence de console.log.');
-    process.exit(1);  // Bloque la publication en renvoyant un code d'erreur
-}else{
-    //emoji check mark
-    console.log('✅ Bavo! Aucun console.log oublié')
+  for (const file of consoleLogFiles) {
+
+    console.error(" - " + file);
+
+  }
+
+  console.error(
+    "❌ La publication est bloquée en raison de la présence de console.log."
+  );
+  process.exit(1);
+
 }
 
+console.log("✅ Bavo! Aucun console.log oublié");

package/src/addons/3d.ts

@@ -0,0 +1,5 @@
+/**
+ * Entrée CDN / IIFE pour `sonic-3d` (hors bundle core).
+ * Charger après `concorde-core.bundle.js`. Inclut Three.js.
+ */
+import "../core/components/functional/3d/3d";

package/src/addons/hugging-face-infer.ts

@@ -0,0 +1,11 @@
+/**
+ * Entrée CDN / IIFE pour `sonic-hugging-face-infer` (hors bundle core).
+ * Charger après `concorde-core.bundle.js`, puis appeler `configureHuggingFace`
+ * (exposé sur `window.ConcordeHF` en IIFE) avec runtime CDN + allowlist.
+ */
+import "../core/components/functional/infer/hugging-face/hugging-face-infer";
+
+export {
+  configureHuggingFace,
+  defineHuggingFaceModels,
+} from "../core/components/functional/infer/hugging-face/hugging-face";

package/src/addons/shader.ts

@@ -0,0 +1,5 @@
+/**
+ * Entrée CDN / IIFE pour `sonic-shader` (hors bundle core).
+ * Charger après `concorde-core.bundle.js`.
+ */
+import "../core/components/functional/shader/shader";

package/src/addons/webgpu.ts

@@ -0,0 +1,15 @@
+/**
+ * Entrée CDN / IIFE pour `sonic-webgpu` (hors bundle core).
+ * Charger après `concorde-core.bundle.js`.
+ */
+import "../core/components/functional/webgpu/webgpu";
+
+export {
+  buildWgslSource,
+  DEFAULT_MAIN_IMAGE,
+  parseBackendPrefer,
+  WebGl2FallbackRuntime,
+  WebGpuCompileError,
+  WebGpuRuntime,
+  SonicWebGpu,
+} from "../core/components/functional/webgpu/webgpu";

package/src/core/components/functional/3d/3d.md

@@ -0,0 +1,128 @@
+# 3D
+
+`sonic-3d` — viewer **Three.js** (glTF / GLB), caméra orbit / perspective / ortho, outputs dataProvider paresseux.
+
+Import opt-in (hors bundle `functional`) :
+
+<sonic-code language="javascript">
+  <template>
+import "@supersoniks/concorde/3d";
+import type {
+  Sonic3dConfig,
+  Sonic3dOutput,
+  Sonic3dAsset,
+  Sonic3dCameraMode,
+} from "@supersoniks/concorde/3d";
+  </template>
+</sonic-code>
+
+CDN (after the core): `concorde-3d.bundle.js` — see [CDN addons](#docs/_getting-started/cdn-addons.md/cdn-addons).
+
+## Démo (modèle CDN)
+
+`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.
+
+<docs-lit-demo for="docs-3d-orbit-demo"></docs-lit-demo>
+
+## Form auto-bind (`formDataProvider`)
+
+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.
+
+| Champ form | Effet |
+|------------|--------|
+| `src` / `asset` | charge le modèle |
+| `camera` | mode caméra |
+| `fov` / `exposure` | optique |
+| `autoRotate` | rotation orbit |
+| `minDistance` / `maxDistance` | bornes zoom orbit |
+| `minPolar` / `maxPolar` | bornes verticale (degrés) |
+| `yaw` / `pitch` / `distance` | position orbit sphérique |
+
+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`.
+
+Gate paresseuse : un `sonic-input name="yaw"` **ne** déclenche **pas** la publication out (seul un lecteur sur `ready` / `frame` / `cam*` / `hit*`… le fait).
+
+<docs-lit-demo for="docs-3d-form-demo"></docs-lit-demo>
+
+## Sortie / dataProvider
+
+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**.
+
+<docs-lit-demo for="docs-3d-out-demo"></docs-lit-demo>
+
+## Caméras
+
+| `camera` | Usage |
+|----------|--------|
+| `orbit` (défaut) | Produit / modèle isolé — orbit + pan, polar limité |
+| `perspective` | Scène libre + pan |
+| `ortho` | Plans techniques / UI 3D |
+
+## Asset neutre (HF plus tard)
+
+```ts
+type Sonic3dAsset = {
+  kind?: "gltf" | "glb" | "obj" | "ply" | "url";
+  url?: string;
+  blob?: Blob;
+};
+```
+
+Le viewer lit `asset` ou `src` depuis le DP — la source (fetch, upload, HF) n’est pas couplée.
+
+## Attributs
+
+| Attribut | Rôle |
+|----------|------|
+| `src` | URL glTF / GLB (vide → démo) |
+| `camera` | `orbit` \| `perspective` \| `ortho` |
+| `fov` | FOV perspective (défaut 45) |
+| `exposure` | Tone mapping (défaut 1) |
+| `min-distance` | Zoom orbit mini (défaut 0.5) |
+| `max-distance` | Zoom orbit maxi (défaut 50 ; `0` = ∞) |
+| `min-polar` / `max-polar` | Angle vertical en **degrés** (défaut 8–172) |
+| `auto-rotate` | Rotation orbit |
+| `fit` | Fit bbox après load (défaut true) |
+| `pick` | Survol highlight + clic → event `pick` + `hit*` ; double-clic = fit |
+| `play` / `play-on-hover` | Boucle RAF |
+| `release-offscreen` | Dispose renderer hors viewport (défaut true) |
+| `dpr-max` | Cap devicePixelRatio (défaut 2) |
+| `dataProvider` / `out-data-provider` | Entrée / sortie |
+| `out-interval` | Throttle publication ms (défaut 80) |
+| `frame-out` | Publishes `frameUrl` + `snapshot` (canvas JPEG) for shader chaining |
+| `snapshot-interval` | Canvas capture throttle ms (default 250) |
+
+## Markup
+
+<sonic-code language="html">
+  <template>
+&lt;sonic-3d
+  src="https://cdn.jsdelivr.net/gh/KhronosGroup/glTF-Sample-Assets@main/Models/DamagedHelmet/glTF-Binary/DamagedHelmet.glb"
+  camera="orbit"
+  auto-rotate
+  pick
+  min-distance="1"
+  max-distance="10"
+&gt;&lt;/sonic-3d&gt;
+  </template>
+</sonic-code>
+
+## Shader bridging
+
+No shared WebGL context between `sonic-3d` and `sonic-shader`.
+
+| Need | Bridge |
+|------|--------|
+| **Live post** | `channel0="#plateau"` on `sonic-shader` (or DP `{ element }`) — canvas copy each frame via `SonicFrameSource` |
+| **Export / HF / freeze** | `frame-out` → `frameUrl` + `snapshot` (`SonicMediaRef` JPEG). Clone with `cloneMediaRef` before holding a frame |
+
+```html
+<!-- Live -->
+<sonic-3d id="plateau" play auto-rotate …></sonic-3d>
+<sonic-shader channel0="#plateau" image="…" play></sonic-shader>
+
+<!-- Export / freeze -->
+<sonic-3d frame-out out-data-provider="view3d" snapshot-interval="250" …></sonic-3d>
+```
+
+Demo: [Visual stack — 3D → shader live](#docs/_misc/visual-stack.md/visual-stack).