gltfjsx-rbl 0.0.1

package/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

package/README.md

@@ -0,0 +1,49 @@
+# gltfjsx-rbl
+
+Turns `.glb`/`.gltf` files into typed, declarative [react-babylon-lite](https://github.com/brianzinn/react-babylon-lite)
+components — a [pmndrs/gltfjsx](https://github.com/pmndrs/gltfjsx) for Babylon Lite.
+
+```bash
+npx gltfjsx-rbl public/models/Fox.glb --name FoxModel --url /models/Fox.glb --output src/models/fox-model.tsx
+```
+
+```tsx
+<FoxModel scaling={[0.028, 0.028, 0.028]} onAnimations={(api) => api.crossFade('Survey', 'Run', 300)} />
+```
+
+## How it works
+
+The CLI reads ONLY the node graph (names, hierarchy, mesh/skin/material assignments, clip
+names) via `@gltf-transform/core` — no GPU, no `@babylonjs/lite` import (lite cannot load
+glTF headlessly). The generated component references the loaded objects by name at runtime
+through `useGltfGraph(url)` and mounts each mesh with `<Primitive object={nodes.x}>`; when
+the file has animation clips it wires `useAnimations` and exposes the clip api via an
+`onAnimations` callback prop. The output is yours to edit: delete nodes, hang physics/gizmo/
+pointer-event children on them, override transforms and material fields.
+
+## Options
+
+| Flag              | Meaning                                                      |
+| ----------------- | ------------------------------------------------------------ |
+| `--name` (`-n`)   | Component name (default derived from the file name)          |
+| `--url` (`-u`)    | Runtime URL the app loads the asset from (default `/<file>`) |
+| `--output` (`-o`) | Output path (default `<ComponentName>.tsx`)                  |
+| `--shadows`       | Emit `receiveShadows` on each mesh                           |
+
+The exact command is echoed into the generated file's header so it is reproducible.
+
+## Notes
+
+- On Windows, run from PowerShell — Git Bash rewrites `--url /models/x.glb` into a Windows
+  path (MSYS argument conversion).
+- Node keys mirror `useGltfGraph`'s runtime indexing exactly; material keys are best-effort
+  (lite's loader may not carry every glTF material name through).
+- Multi-primitive meshes are flagged with a comment — lite may split them into one mesh per
+  primitive at load; verify the runtime names.
+- Clips live on the renderer's shared animation manager (the container is never scene-added),
+  which also makes remounting safe.
+- **glTF cameras are noted, not used.** Babylon Lite's glTF loader does not parse cameras
+  (they never reach the runtime container), so a camera in the file is reported in the header
+  comment — supply your own (`<ArcRotateCamera>`).
+- Nameless nodes aren't addressable at runtime (lite drops them from the graph), so a file
+  whose only mesh is nameless generates a component that renders nothing.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { writeFile } from 'node:fs/promises';
+import { basename, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { emitComponent } from './emit.js';
+import { readGraphModel } from './graph.js';
+const { values, positionals } = parseArgs({
+    allowPositionals: true,
+    options: {
+        output: { type: 'string', short: 'o' },
+        url: { type: 'string', short: 'u' },
+        name: { type: 'string', short: 'n' },
+        shadows: { type: 'boolean' },
+    },
+});
+const file = positionals[0];
+if (file === undefined) {
+    console.error('usage: gltfjsx-rbl <file.glb|file.gltf> [--name Model] [--url /models/x.glb] [--output Model.tsx] [--shadows]');
+    process.exit(1);
+}
+const toComponentName = (fileName) => {
+    const stem = fileName.replace(/\.(glb|gltf)$/i, '');
+    const pascal = stem
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part[0].toUpperCase() + part.slice(1))
+        .join('');
+    return /^[0-9]/.test(pascal) || pascal.length === 0 ? `Model${pascal}` : `${pascal}Model`;
+};
+const model = await readGraphModel(resolve(file));
+const componentName = values.name ?? toComponentName(basename(file));
+const code = await emitComponent(model, {
+    componentName,
+    url: values.url ?? `/${basename(file)}`,
+    version: process.env['npm_package_version'] ?? '',
+    // Echo the exact invocation so the generated file records how to reproduce it.
+    command: `npx gltfjsx-rbl ${process.argv.slice(2).join(' ')}`,
+    shadows: values.shadows === true,
+});
+const outPath = resolve(values.output ?? `${componentName}.tsx`);
+await writeFile(outPath, code, 'utf8');
+console.log(`wrote ${outPath} (${model.flat.length} nodes, ${model.materials.length} materials, ${model.animations.length} clips)`);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACxC,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE;QACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QACtC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QACnC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QACpC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC7B;CACF,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAC5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CACX,+GAA+G,CAChH,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAU,EAAE;IACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI;SAChB,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACrD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACrE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE;IACtC,aAAa;IACb,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE;IACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,EAAE;IACjD,+EAA+E;IAC/E,OAAO,EAAE,mBAAmB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;IAC7D,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;CACjC,CAAC,CAAC;AACH,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,MAAM,CAAC,CAAC;AACjE,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,OAAO,CAAC,GAAG,CACT,SAAS,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,KAAK,CAAC,SAAS,CAAC,MAAM,eAAe,KAAK,CAAC,UAAU,CAAC,MAAM,SAAS,CACvH,CAAC"}

package/dist/emit.d.ts

@@ -0,0 +1,16 @@
+import type { GraphModel } from './graph.js';
+export interface EmitOptions {
+    /** Generated component name, e.g. "FoxModel". */
+    componentName: string;
+    /** Runtime URL the app loads the asset from, e.g. "/models/Fox.glb". */
+    url: string;
+    /** Tool version stamped into the header. */
+    version?: string;
+    /** The exact CLI invocation, echoed into the header so the file is reproducible. */
+    command?: string;
+    /** Emit `receiveShadows` on each mesh (gltfjsx `--shadows`). */
+    shadows?: boolean;
+}
+/** Graph model → a typed react-babylon-lite component module (TSX source, prettier-formatted). */
+export declare const emitComponent: (model: GraphModel, options: EmitOptions) => Promise<string>;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAWD,kGAAkG;AAClG,eAAO,MAAM,aAAa,GAAU,OAAO,UAAU,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,MAAM,CA6G3F,CAAC"}

package/dist/emit.js

@@ -0,0 +1,99 @@
+import { format } from 'prettier';
+const primitiveLine = (node, shadows) => {
+    const receiveShadows = shadows ? ' receiveShadows' : '';
+    const warning = node.primitiveCount > 1
+        ? ` {/* ${node.primitiveCount} primitives — lite may split this mesh; verify the runtime name */}`
+        : '';
+    return `      <Primitive object={nodes.${node.identifier}}${receiveShadows} />${warning}`;
+};
+/** Graph model → a typed react-babylon-lite component module (TSX source, prettier-formatted). */
+export const emitComponent = async (model, options) => {
+    const { componentName, url, shadows = false } = options;
+    // Babylon Lite's glTF loader drops camera nodes entirely (they never reach the runtime
+    // AssetContainer), so cameras are NOTED but never emitted as runtime nodes — doing so would
+    // type `nodes.x` as present when it is actually undefined at runtime.
+    const runtime = model.flat.filter((node) => node.kind !== 'camera');
+    const named = runtime.filter((node) => node.identifier !== null);
+    const meshNodes = named.filter((node) => node.kind === 'mesh');
+    const plainNodes = named.filter((node) => node.kind === 'node');
+    const cameraCount = model.flat.filter((node) => node.kind === 'camera').length;
+    const nameless = runtime.length - named.length;
+    const hasAnimations = model.animations.length > 0;
+    const hasMaterials = model.materials.length > 0;
+    const nodesType = named.length > 0
+        ? `export interface ${componentName}Nodes {
+${named.map((node) => `  ${node.identifier}: ${node.kind === 'mesh' ? 'Mesh' : 'SceneNode'};`).join('\n')}
+}`
+        : `export type ${componentName}Nodes = Record<string, never>;`;
+    // Import only the types actually referenced (verbatimModuleSyntax + no-unused-vars).
+    const liteTypes = [
+        meshNodes.length > 0 ? 'Mesh' : '',
+        hasMaterials ? 'PbrMaterialProps' : '',
+        plainNodes.length > 0 ? 'SceneNode' : '',
+    ].filter(Boolean);
+    const liteTypeImport = liteTypes.length > 0 ? `import type { ${liteTypes.join(', ')} } from '@babylonjs/lite';\n` : '';
+    const commandLine = options.command !== undefined ? `\n * Command: ${options.command}` : '';
+    const cameraNote = cameraCount > 0
+        ? `\n * Note: the source declares ${cameraCount} camera(s), but Babylon Lite's glTF loader
+ *   does not parse cameras — supply your own (e.g. <ArcRotateCamera>).`
+        : '';
+    const header = `/*
+ * Auto-generated by gltfjsx-rbl ${options.version ?? ''} — edit freely, it's yours.${commandLine}
+ * Source: ${model.source} (${named.length} named nodes, ${model.materials.length} materials${hasAnimations ? `, clips: ${model.animations.join(', ')}` : ''})
+ * Node keys mirror useGltfGraph's runtime indexing; material keys are best-effort (lite's
+ * loader may not carry every glTF material name through).${nameless > 0 ? `\n * ${nameless} nameless node(s) are not addressable at runtime.` : ''}${cameraNote}
+ */`;
+    const animationImports = hasAnimations
+        ? `import { useAnimations } from 'react-babylon-lite/animation';
+import type { AnimationsApi } from 'react-babylon-lite/animation';
+import { useEffect } from 'react';
+`
+        : '';
+    const materialsType = hasMaterials
+        ? `export interface ${componentName}Materials {
+${model.materials.map((material) => `  ${material.identifier}: PbrMaterialProps;`).join('\n')}
+}`
+        : `export type ${componentName}Materials = Record<string, never>;`;
+    const propsType = hasAnimations
+        ? `export interface ${componentName}Props extends ComponentProps<typeof TransformNode> {
+  /** Clip api (play / crossFade / setSpeed / …). Clips: ${model.animations.join(', ')}. */
+  onAnimations?: (animations: AnimationsApi) => void;
+}`
+        : `export type ${componentName}Props = ComponentProps<typeof TransformNode>;`;
+    const signature = hasAnimations
+        ? `{ onAnimations, ...props }: ${componentName}Props`
+        : `props: ${componentName}Props`;
+    const graphDestructure = hasAnimations ? '{ nodes, animationGroups }' : '{ nodes }';
+    const animationBody = hasAnimations
+        ? `  const animations = useAnimations(animationGroups);
+  useEffect(() => onAnimations?.(animations), [animations, onAnimations]);
+`
+        : '';
+    const children = meshNodes.length > 0
+        ? meshNodes.map((node) => primitiveLine(node, shadows)).join('\n')
+        : '      {/* no mesh nodes in this file */}';
+    const code = `${header}
+${liteTypeImport}import type { ComponentProps } from 'react';
+${animationImports}import { useGltfGraph } from 'react-babylon-lite';
+import { Primitive, TransformNode } from 'react-babylon-lite/components';
+
+export const MODEL_URL = '${url}';
+
+${nodesType}
+
+${materialsType}
+
+${propsType}
+
+export function ${componentName}(${signature}) {
+  const ${graphDestructure} = useGltfGraph<${componentName}Nodes, ${componentName}Materials>(MODEL_URL);
+${animationBody}  return (
+    <TransformNode name="${componentName}" {...props}>
+${children}
+    </TransformNode>
+  );
+}
+`;
+    return format(code, { parser: 'typescript', singleQuote: true, printWidth: 110 });
+};
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"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"}

package/dist/graph.d.ts

@@ -0,0 +1,32 @@
+export interface GraphNodeModel {
+    /** Unique JS identifier (null when the glTF node is nameless — unreachable at runtime). */
+    identifier: string | null;
+    name: string;
+    kind: 'mesh' | 'camera' | 'node';
+    skinned: boolean;
+    /** >1 means lite may split this into one Mesh per primitive — flagged in the output. */
+    primitiveCount: number;
+    /** Identifiers of the materials this node's mesh primitives use. */
+    materials: string[];
+    children: GraphNodeModel[];
+}
+export interface GraphMaterialModel {
+    identifier: string;
+    name: string;
+}
+export interface GraphModel {
+    source: string;
+    roots: GraphNodeModel[];
+    /** Depth-first flattening of roots — the emission and runtime-claim order. */
+    flat: GraphNodeModel[];
+    materials: GraphMaterialModel[];
+    /** Clip names in file order (lite auto-plays the first). */
+    animations: string[];
+}
+/**
+ * Reads ONLY the node graph — names, hierarchy, mesh/material/skin assignments, clip names —
+ * via @gltf-transform/core. No geometry decoding, no GPU, so this runs anywhere node does
+ * (lite itself cannot load glTF headlessly — it needs a WebGPU engine).
+ */
+export declare const readGraphModel: (filePath: string) => Promise<GraphModel>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,8EAA8E;IAC9E,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,UAAU,CA0DzE,CAAC"}

package/dist/graph.js

@@ -0,0 +1,64 @@
+import { NodeIO } from '@gltf-transform/core';
+import { basename } from 'node:path';
+import { claimName, sanitizeName } from './sanitize.js';
+/**
+ * Reads ONLY the node graph — names, hierarchy, mesh/material/skin assignments, clip names —
+ * via @gltf-transform/core. No geometry decoding, no GPU, so this runs anywhere node does
+ * (lite itself cannot load glTF headlessly — it needs a WebGPU engine).
+ */
+export const readGraphModel = async (filePath) => {
+    const document = await new NodeIO().read(filePath);
+    const root = document.getRoot();
+    const nodeNames = new Set();
+    const materialNames = new Set();
+    const materialIds = new Map();
+    const materials = [];
+    let materialIndex = 0;
+    const flat = [];
+    // Mirrors the runtime walk: materials claimed at first encounter during the node DFS,
+    // nameless ones falling back to their discovery index.
+    const claimMaterial = (material) => {
+        const existing = materialIds.get(material);
+        if (existing !== undefined)
+            return existing;
+        const rawName = material.getName();
+        const base = rawName.length > 0 ? rawName : `material_${materialIndex}`;
+        materialIndex += 1;
+        const identifier = claimName(sanitizeName(base), materialNames);
+        materialIds.set(material, identifier);
+        materials.push({ identifier, name: rawName });
+        return identifier;
+    };
+    const visit = (node) => {
+        const name = node.getName();
+        const mesh = node.getMesh();
+        const primitives = mesh?.listPrimitives() ?? [];
+        const model = {
+            identifier: name.length > 0 ? claimName(sanitizeName(name), nodeNames) : null,
+            name,
+            kind: mesh !== null ? 'mesh' : node.getCamera() !== null ? 'camera' : 'node',
+            skinned: node.getSkin() !== null,
+            primitiveCount: primitives.length,
+            materials: [],
+            children: [],
+        };
+        for (const primitive of primitives) {
+            const material = primitive.getMaterial();
+            if (material !== null) {
+                const id = claimMaterial(material);
+                if (!model.materials.includes(id))
+                    model.materials.push(id);
+            }
+        }
+        flat.push(model);
+        model.children = node.listChildren().map(visit);
+        return model;
+    };
+    const scene = root.getDefaultScene() ?? root.listScenes()[0];
+    const roots = scene === undefined ? [] : scene.listChildren().map(visit);
+    const animations = root
+        .listAnimations()
+        .map((animation, index) => (animation.getName().length > 0 ? animation.getName() : `animation_${index}`));
+    return { source: basename(filePath), roots, flat, materials, animations };
+};
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { readGraphModel } from './graph.js';
+export type { GraphMaterialModel, GraphModel, GraphNodeModel } from './graph.js';
+export { emitComponent } from './emit.js';
+export type { EmitOptions } from './emit.js';
+export { claimName, sanitizeName } from './sanitize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { readGraphModel } from './graph.js';
+export { emitComponent } from './emit.js';
+export { claimName, sanitizeName } from './sanitize.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/sanitize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * glTF names → JS identifiers. MUST stay in sync with react-babylon-lite's sanitizeGraphName
+ * and its claim() suffixing — the generated component's keys are only valid because the
+ * runtime hook reproduces them from the same names in the same depth-first order.
+ */
+export declare const sanitizeName: (name: string) => string;
+export declare const claimName: (base: string, taken: Set<string>) => string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAG3C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAG,MAM5D,CAAC"}

package/dist/sanitize.js

@@ -0,0 +1,18 @@
+/**
+ * glTF names → JS identifiers. MUST stay in sync with react-babylon-lite's sanitizeGraphName
+ * and its claim() suffixing — the generated component's keys are only valid because the
+ * runtime hook reproduces them from the same names in the same depth-first order.
+ */
+export const sanitizeName = (name) => {
+    const cleaned = name.replace(/[^A-Za-z0-9_$]/g, '_');
+    return /^[0-9]/.test(cleaned) || cleaned.length === 0 ? `_${cleaned}` : cleaned;
+};
+export const claimName = (base, taken) => {
+    let name = base;
+    let suffix = 1;
+    while (taken.has(name))
+        name = `${base}_${suffix++}`;
+    taken.add(name);
+    return name;
+};
+//# sourceMappingURL=sanitize.js.map

package/dist/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAkB,EAAU,EAAE;IACpE,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,IAAI,GAAG,GAAG,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;IACrD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "gltfjsx-rbl",
+  "version": "0.0.1",
+  "description": "Turns glTF/GLB files into typed, declarative react-babylon-lite components (a pmndrs/gltfjsx for Babylon Lite)",
+  "keywords": [
+    "gltfjsx",
+    "gltf",
+    "glb",
+    "react",
+    "babylon-lite",
+    "react-babylon-lite",
+    "codegen"
+  ],
+  "type": "module",
+  "bin": {
+    "gltfjsx-rbl": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "author": "Brian Zinn <542756+brianzinn@users.noreply.github.com>",
+  "license": "Unlicense",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brianzinn/react-babylon-lite.git",
+    "directory": "packages/gltfjsx"
+  },
+  "homepage": "https://github.com/brianzinn/react-babylon-lite#readme",
+  "bugs": {
+    "url": "https://github.com/brianzinn/react-babylon-lite/issues"
+  },
+  "dependencies": {
+    "@gltf-transform/core": "^4.0.0",
+    "prettier": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}