@glboost/react 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chase Holdren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @glboost/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [GLBoost](https://glboost.com) 3D viewer as a React component. It renders `<glboost-viewer>`
+(model-viewer under the hood, with GLBoost's presets, LOD, AR, hotspots, variants, measurement, and
+review pins) and loads `embed.js` from the CDN once per page.
+
+```sh
+npm install @glboost/react
+```
+
+```tsx
+import { GLBoostViewer } from '@glboost/react';
+
+export function Product({ assetId }: { assetId: string }) {
+  return (
+    <GLBoostViewer
+      asset={assetId}
+      preset="auto"
+      ar
+      autoRotate
+      style={{ width: '100%', height: 480 }}
+      onLoad={({ spec, loadMs }) => console.log(spec, loadMs)}
+    />
+  );
+}
+```
+
+Attributes are props in camelCase (`variantPicker`, `measureUnits`, `noControls`), events are
+callbacks (`onLoad`, `onHotspotClick`, `onCameraChange`, `onVariantChange`, `onMeasureChange`,
+`onLodChange`, `onPinClick`, `onError`), `pins` renders review pins, and a `ref` gives the element's
+JavaScript API (`GLBoostViewerElement`: `getCamera`, `setCamera`, `play`, `setVariant`,
+`startMeasure`, `pickPoint`, …).
+
+Docs: https://glboost.com/docs/viewer

package/dist/index.d.ts

@@ -0,0 +1,218 @@
+import * as react from 'react';
+import { CSSProperties, Ref } from 'react';
+
+/**
+ * Plain shapes shared with `<glboost-viewer>` (`packages/viewer`): the config the CDN serves,
+ * hotspots, review pins, camera poses, LOD levels, and measurements. They are declared here so the
+ * published package needs no types from the private viewer; the tests check the element class still
+ * satisfies `GLBoostViewerElement`.
+ */
+/** Camera orbit: yaw and pitch in degrees, distance in model units. */
+interface Pose {
+    yaw: number;
+    pitch: number;
+    distance: number;
+    fov?: number;
+}
+type Vec3 = [number, number, number];
+interface Measurement {
+    a: Vec3;
+    b: Vec3;
+    /** Model units (metres for a correctly scaled glTF). */
+    distance: number;
+}
+interface Hotspot {
+    id: string;
+    title: string;
+    body?: string;
+    position: Vec3;
+    normal: Vec3;
+    camera?: Pose;
+    /** Material variant to switch to when the hotspot is clicked. */
+    variant?: string;
+}
+/** A review comment anchored on the model. */
+interface Pin {
+    id: string;
+    label: string;
+    position: Vec3;
+    normal: Vec3;
+    active?: boolean;
+}
+interface LodLevel {
+    /** Canonical spec of the variant. */
+    spec: string;
+    /** Share of the base triangle count this level keeps; 1 for the base itself. */
+    ratio: number;
+    triangles: number;
+    bytes: number;
+}
+/** Per-variant size, triangles, and score, keyed by canonical spec. */
+type VariantStats = Record<string, {
+    bytes: number;
+    triangles?: number;
+    score?: {
+        grade: string;
+        points: number;
+    };
+}>;
+/** The material-variant chip row: labels and swatches keyed by `KHR_materials_variants` name. */
+interface VariantPicker {
+    enabled: boolean;
+    labels?: Record<string, string>;
+    /** A CSS colour or an https image URL. */
+    swatches?: Record<string, string>;
+}
+interface ViewerSettings {
+    camera?: Pose;
+    target?: Vec3;
+    exposure?: number;
+    shadowIntensity?: number;
+    environment?: string;
+    background?: string;
+    autoRotate?: boolean;
+    animation?: string | null;
+    variant?: string | null;
+    ar?: boolean;
+    variantPicker?: VariantPicker;
+}
+/** Shape of `https://cdn.glboost.com/<assetId>/config.json`. */
+interface ViewerConfig {
+    assetId: string;
+    name: string;
+    versionId: string | null;
+    status: 'ready' | 'processing';
+    variants: string[];
+    /** Canonical spec the request resolved to. */
+    spec?: string;
+    variantStats?: VariantStats;
+    /** Ready export extensions per spec plus `original`. */
+    exports?: Record<string, string[]>;
+    /** Spec whose `.usdz` Quick Look should open, null when none exists. */
+    usdz?: string | null;
+    usdzMatchesRequest?: boolean;
+    viewerSettings: ViewerSettings | null;
+    hotspots: Hotspot[];
+    watermark: boolean;
+    thumbnail: boolean;
+}
+
+/**
+ * The JavaScript API of `<glboost-viewer>` once `embed.js` has defined it: what a `ref` on
+ * `<GLBoostViewer>` gives you. Mirrors the public members of the element class in
+ * `packages/viewer/src/element.ts` (the React package's tests check the class satisfies it).
+ */
+interface GLBoostViewerElement extends HTMLElement {
+    /** Resolves once the current model has loaded. */
+    readonly ready: Promise<void>;
+    /** CDN origin the element loads from. */
+    get base(): string;
+    set base(value: string | null | undefined);
+    /** The `config.json` the element resolved, once loaded. */
+    readonly currentConfig: ViewerConfig | null;
+    /** The preset in use after `preset="auto"` was resolved for this device. */
+    readonly resolvedPreset: string | null;
+    get lod(): string | null;
+    set lod(value: string | null | undefined);
+    /** The LOD ladder of the current version, lightest first. */
+    readonly lods: LodLevel[];
+    readonly currentLod: LodLevel | null;
+    getCamera(): Pose;
+    setCamera(pose: Partial<Pose>): void;
+    recenter(): void;
+    readonly animations: string[];
+    play(name?: string, options?: {
+        speed?: number;
+        repetitions?: number;
+    }): void;
+    pause(): void;
+    /** `KHR_materials_variants` names. */
+    readonly variants: string[];
+    setVariant(name: string | null): void;
+    reload(): Promise<void>;
+    /** Surface point and normal under a client-space coordinate, or null when the click missed the model. */
+    pickPoint(clientX: number, clientY: number): {
+        position: [number, number, number];
+        normal: [number, number, number];
+    } | null;
+    /** True while a measurement waits for its endpoints. */
+    readonly measuring: boolean;
+    readonly measure: Measurement | null;
+    startMeasure(): void;
+    showMeasure(a: Vec3, b: Vec3): void;
+    clearMeasure(): void;
+    /** Review pins to render on the model. */
+    setPins(pins: Pin[]): void;
+}
+
+/** Injects `<base>/_/embed.js` once per page. */
+declare function loadEmbedScript(base?: string): Promise<void>;
+interface GLBoostViewerProps {
+    asset: string;
+    base?: string;
+    preset?: string;
+    spec?: string;
+    v?: string;
+    exp?: string | number;
+    sig?: string;
+    poster?: 'auto' | string;
+    ar?: boolean;
+    autoRotate?: boolean;
+    noControls?: boolean;
+    environment?: string;
+    noSettings?: boolean;
+    noHotspots?: boolean;
+    watermark?: boolean;
+    variant?: string;
+    alt?: string;
+    /** `auto`, `progressive`, or a fixed ratio such as `0.5`; needs a project LOD ladder. */
+    lod?: string;
+    /** `interaction` shows the poster with a play glyph until the viewer is touched. */
+    reveal?: 'auto' | 'interaction' | 'manual';
+    loading?: 'auto' | 'lazy' | 'eager';
+    /** Chip row for `KHR_materials_variants`; the saved viewer settings can turn it on too. */
+    variantPicker?: boolean;
+    /** Space-separated tool buttons; `measure` adds the ruler. */
+    tools?: string;
+    /** `m` (default), `cm`, `mm`, `in`, or `ft`. */
+    measureUnits?: string;
+    /** Model units per metre for models not built at 1 unit = 1 m. */
+    measureScale?: number | string;
+    className?: string;
+    style?: CSSProperties;
+    onLoad?: (detail: {
+        assetId: string;
+        versionId: string | null;
+        spec: string;
+        loadMs: number;
+    }) => void;
+    onHotspotClick?: (hotspot: Hotspot) => void;
+    /** Review pins to render; re-applied whenever the array identity changes or the model loads. */
+    pins?: Pin[];
+    onPinClick?: (id: string) => void;
+    onCameraChange?: (pose: Pose & {
+        source?: string;
+    }) => void;
+    onError?: (message: string) => void;
+    onLodChange?: (detail: {
+        ratio: number;
+        spec: string;
+    }) => void;
+    onVariantChange?: (name: string | null) => void;
+    onMeasureChange?: (measurement: (Measurement & {
+        text: string;
+    }) | null) => void;
+    ref?: Ref<GLBoostViewerElement | null>;
+}
+/**
+ * React wrapper around `<glboost-viewer>`; loads the embed script from the CDN on first use. Props
+ * mirror the element's attributes (camelCase), events become callbacks, and `ref` gives the
+ * element's JavaScript API (`GLBoostViewerElement`).
+ */
+declare function GLBoostViewer(props: GLBoostViewerProps): react.ReactElement<{
+    style: CSSProperties | undefined;
+    ref: react.RefObject<GLBoostViewerElement | null>;
+}, string | react.JSXElementConstructor<any>>;
+
+export { GLBoostViewer, loadEmbedScript };
+export type { GLBoostViewerElement, GLBoostViewerProps, Hotspot, LodLevel, Measurement, Pin, Pose, VariantPicker, VariantStats, Vec3, ViewerConfig, ViewerSettings };

package/dist/index.js

@@ -0,0 +1,157 @@
+"use client";
+
+// src/index.tsx
+import {
+  createElement,
+  useEffect,
+  useImperativeHandle,
+  useRef
+} from "react";
+var DEFAULT_BASE = "https://cdn.glboost.com";
+var loaders = /* @__PURE__ */ new Map();
+function loadEmbedScript(base = DEFAULT_BASE) {
+  const src = `${base.replace(/\/+$/, "")}/_/embed.js`;
+  if (typeof window === "undefined") return Promise.resolve();
+  if (customElements.get("glboost-viewer")) return Promise.resolve();
+  let pending = loaders.get(src);
+  if (!pending) {
+    pending = new Promise((resolve, reject) => {
+      const script = document.createElement("script");
+      script.src = src;
+      script.async = true;
+      script.onload = () => resolve();
+      script.onerror = () => reject(new Error(`failed to load ${src}`));
+      document.head.appendChild(script);
+    });
+    loaders.set(src, pending);
+  }
+  return pending;
+}
+function GLBoostViewer(props) {
+  const {
+    asset,
+    base,
+    preset,
+    spec,
+    v,
+    exp,
+    sig,
+    poster,
+    ar,
+    autoRotate,
+    noControls,
+    environment,
+    noSettings,
+    noHotspots,
+    watermark,
+    variant,
+    alt,
+    lod,
+    reveal,
+    loading,
+    variantPicker,
+    tools,
+    measureUnits,
+    measureScale,
+    className,
+    style,
+    onLoad,
+    onHotspotClick,
+    pins,
+    onPinClick,
+    onCameraChange,
+    onError,
+    onLodChange,
+    onVariantChange,
+    onMeasureChange,
+    ref
+  } = props;
+  const elementRef = useRef(null);
+  useImperativeHandle(ref, () => elementRef.current, []);
+  useEffect(() => {
+    loadEmbedScript(base).catch((e) => onError?.(e.message));
+  }, [base, onError]);
+  useEffect(() => {
+    const el = elementRef.current;
+    if (!el) return;
+    const load = (e) => onLoad?.(e.detail);
+    const hotspot = (e) => onHotspotClick?.(e.detail.hotspot);
+    const camera = (e) => onCameraChange?.(e.detail);
+    const error = (e) => onError?.(e.detail?.message ?? "error");
+    const pin = (e) => onPinClick?.(e.detail.id);
+    const lodChange = (e) => onLodChange?.(e.detail);
+    const variantChange = (e) => onVariantChange?.(e.detail.name);
+    const measureChange = (e) => onMeasureChange?.(e.detail);
+    el.addEventListener("load", load);
+    el.addEventListener("hotspot-click", hotspot);
+    el.addEventListener("camera-change", camera);
+    el.addEventListener("error", error);
+    el.addEventListener("pin-click", pin);
+    el.addEventListener("lod-change", lodChange);
+    el.addEventListener("variant-change", variantChange);
+    el.addEventListener("measure-change", measureChange);
+    return () => {
+      el.removeEventListener("load", load);
+      el.removeEventListener("hotspot-click", hotspot);
+      el.removeEventListener("camera-change", camera);
+      el.removeEventListener("error", error);
+      el.removeEventListener("pin-click", pin);
+      el.removeEventListener("lod-change", lodChange);
+      el.removeEventListener("variant-change", variantChange);
+      el.removeEventListener("measure-change", measureChange);
+    };
+  }, [
+    onLoad,
+    onHotspotClick,
+    onCameraChange,
+    onError,
+    onPinClick,
+    onLodChange,
+    onVariantChange,
+    onMeasureChange
+  ]);
+  useEffect(() => {
+    const el = elementRef.current;
+    if (!el || !pins) return;
+    const apply = () => {
+      if (typeof el.setPins === "function") el.setPins(pins);
+    };
+    apply();
+    el.addEventListener("load", apply);
+    return () => el.removeEventListener("load", apply);
+  }, [pins]);
+  const attrs = {
+    asset,
+    base,
+    preset,
+    spec,
+    v,
+    exp: exp === void 0 ? void 0 : String(exp),
+    sig,
+    poster,
+    environment,
+    variant,
+    alt,
+    lod,
+    reveal,
+    loading,
+    tools,
+    "measure-units": measureUnits,
+    "measure-scale": measureScale === void 0 ? void 0 : String(measureScale),
+    class: className
+  };
+  if (ar) attrs.ar = "";
+  if (autoRotate) attrs["auto-rotate"] = "";
+  if (noControls) attrs["no-controls"] = "";
+  if (noSettings) attrs["no-settings"] = "";
+  if (noHotspots) attrs["no-hotspots"] = "";
+  if (watermark) attrs.watermark = "";
+  if (variantPicker) attrs["variant-picker"] = "";
+  for (const key of Object.keys(attrs)) if (attrs[key] === void 0) delete attrs[key];
+  return createElement("glboost-viewer", { ...attrs, style, ref: elementRef });
+}
+export {
+  GLBoostViewer,
+  loadEmbedScript
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createElement,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  type CSSProperties,\n  type Ref,\n} from 'react';\nimport type { Hotspot, Measurement, Pin, Pose } from './types';\nimport type { GLBoostViewerElement } from './element';\n\nconst DEFAULT_BASE = 'https://cdn.glboost.com';\nconst loaders = new Map<string, Promise<void>>();\n\n/** Injects `<base>/_/embed.js` once per page. */\nexport function loadEmbedScript(base: string = DEFAULT_BASE): Promise<void> {\n  const src = `${base.replace(/\\/+$/, '')}/_/embed.js`;\n  if (typeof window === 'undefined') return Promise.resolve();\n  if (customElements.get('glboost-viewer')) return Promise.resolve();\n  let pending = loaders.get(src);\n  if (!pending) {\n    pending = new Promise<void>((resolve, reject) => {\n      const script = document.createElement('script');\n      script.src = src;\n      script.async = true;\n      script.onload = () => resolve();\n      script.onerror = () => reject(new Error(`failed to load ${src}`));\n      document.head.appendChild(script);\n    });\n    loaders.set(src, pending);\n  }\n  return pending;\n}\n\nexport interface GLBoostViewerProps {\n  asset: string;\n  base?: string;\n  preset?: string;\n  spec?: string;\n  v?: string;\n  exp?: string | number;\n  sig?: string;\n  poster?: 'auto' | string;\n  ar?: boolean;\n  autoRotate?: boolean;\n  noControls?: boolean;\n  environment?: string;\n  noSettings?: boolean;\n  noHotspots?: boolean;\n  watermark?: boolean;\n  variant?: string;\n  alt?: string;\n  /** `auto`, `progressive`, or a fixed ratio such as `0.5`; needs a project LOD ladder. */\n  lod?: string;\n  /** `interaction` shows the poster with a play glyph until the viewer is touched. */\n  reveal?: 'auto' | 'interaction' | 'manual';\n  loading?: 'auto' | 'lazy' | 'eager';\n  /** Chip row for `KHR_materials_variants`; the saved viewer settings can turn it on too. */\n  variantPicker?: boolean;\n  /** Space-separated tool buttons; `measure` adds the ruler. */\n  tools?: string;\n  /** `m` (default), `cm`, `mm`, `in`, or `ft`. */\n  measureUnits?: string;\n  /** Model units per metre for models not built at 1 unit = 1 m. */\n  measureScale?: number | string;\n  className?: string;\n  style?: CSSProperties;\n  onLoad?: (detail: {\n    assetId: string;\n    versionId: string | null;\n    spec: string;\n    loadMs: number;\n  }) => void;\n  onHotspotClick?: (hotspot: Hotspot) => void;\n  /** Review pins to render; re-applied whenever the array identity changes or the model loads. */\n  pins?: Pin[];\n  onPinClick?: (id: string) => void;\n  onCameraChange?: (pose: Pose & { source?: string }) => void;\n  onError?: (message: string) => void;\n  onLodChange?: (detail: { ratio: number; spec: string }) => void;\n  onVariantChange?: (name: string | null) => void;\n  onMeasureChange?: (measurement: (Measurement & { text: string }) | null) => void;\n  ref?: Ref<GLBoostViewerElement | null>;\n}\n\n/**\n * React wrapper around `<glboost-viewer>`; loads the embed script from the CDN on first use. Props\n * mirror the element's attributes (camelCase), events become callbacks, and `ref` gives the\n * element's JavaScript API (`GLBoostViewerElement`).\n */\nexport function GLBoostViewer(props: GLBoostViewerProps) {\n  const {\n    asset,\n    base,\n    preset,\n    spec,\n    v,\n    exp,\n    sig,\n    poster,\n    ar,\n    autoRotate,\n    noControls,\n    environment,\n    noSettings,\n    noHotspots,\n    watermark,\n    variant,\n    alt,\n    lod,\n    reveal,\n    loading,\n    variantPicker,\n    tools,\n    measureUnits,\n    measureScale,\n    className,\n    style,\n    onLoad,\n    onHotspotClick,\n    pins,\n    onPinClick,\n    onCameraChange,\n    onError,\n    onLodChange,\n    onVariantChange,\n    onMeasureChange,\n    ref,\n  } = props;\n  const elementRef = useRef<GLBoostViewerElement | null>(null);\n  useImperativeHandle(ref as Ref<GLBoostViewerElement>, () => elementRef.current!, []);\n\n  useEffect(() => {\n    loadEmbedScript(base).catch((e: Error) => onError?.(e.message));\n  }, [base, onError]);\n\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n    const load = (e: Event) => onLoad?.((e as CustomEvent).detail);\n    const hotspot = (e: Event) => onHotspotClick?.((e as CustomEvent).detail.hotspot);\n    const camera = (e: Event) => onCameraChange?.((e as CustomEvent).detail);\n    const error = (e: Event) => onError?.((e as CustomEvent).detail?.message ?? 'error');\n    const pin = (e: Event) => onPinClick?.((e as CustomEvent).detail.id);\n    const lodChange = (e: Event) => onLodChange?.((e as CustomEvent).detail);\n    const variantChange = (e: Event) => onVariantChange?.((e as CustomEvent).detail.name);\n    const measureChange = (e: Event) => onMeasureChange?.((e as CustomEvent).detail);\n    el.addEventListener('load', load);\n    el.addEventListener('hotspot-click', hotspot);\n    el.addEventListener('camera-change', camera);\n    el.addEventListener('error', error);\n    el.addEventListener('pin-click', pin);\n    el.addEventListener('lod-change', lodChange);\n    el.addEventListener('variant-change', variantChange);\n    el.addEventListener('measure-change', measureChange);\n    return () => {\n      el.removeEventListener('load', load);\n      el.removeEventListener('hotspot-click', hotspot);\n      el.removeEventListener('camera-change', camera);\n      el.removeEventListener('error', error);\n      el.removeEventListener('pin-click', pin);\n      el.removeEventListener('lod-change', lodChange);\n      el.removeEventListener('variant-change', variantChange);\n      el.removeEventListener('measure-change', measureChange);\n    };\n  }, [\n    onLoad,\n    onHotspotClick,\n    onCameraChange,\n    onError,\n    onPinClick,\n    onLodChange,\n    onVariantChange,\n    onMeasureChange,\n  ]);\n\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el || !pins) return;\n    // The element only exists once embed.js has defined it; apply now and again after each load.\n    const apply = () => {\n      if (typeof el.setPins === 'function') el.setPins(pins);\n    };\n    apply();\n    el.addEventListener('load', apply);\n    return () => el.removeEventListener('load', apply);\n  }, [pins]);\n\n  const attrs: Record<string, string | undefined> = {\n    asset,\n    base,\n    preset,\n    spec,\n    v,\n    exp: exp === undefined ? undefined : String(exp),\n    sig,\n    poster,\n    environment,\n    variant,\n    alt,\n    lod,\n    reveal,\n    loading,\n    tools,\n    'measure-units': measureUnits,\n    'measure-scale': measureScale === undefined ? undefined : String(measureScale),\n    class: className,\n  };\n  if (ar) attrs.ar = '';\n  if (autoRotate) attrs['auto-rotate'] = '';\n  if (noControls) attrs['no-controls'] = '';\n  if (noSettings) attrs['no-settings'] = '';\n  if (noHotspots) attrs['no-hotspots'] = '';\n  if (watermark) attrs.watermark = '';\n  if (variantPicker) attrs['variant-picker'] = '';\n  for (const key of Object.keys(attrs)) if (attrs[key] === undefined) delete attrs[key];\n  return createElement('glboost-viewer', { ...attrs, style, ref: elementRef });\n}\n\nexport type { GLBoostViewerElement } from './element';\nexport type * from './types';\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@glboost/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "React wrapper for the GLBoost <glboost-viewer> embed: 3D model viewer with AR, hotspots, LOD, and review pins.",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chaseholdren/glboost.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://glboost.com/docs/viewer",
+  "keywords": [
+    "gltf",
+    "glb",
+    "3d",
+    "react",
+    "model-viewer",
+    "glboost"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@google/model-viewer": "^4.3.1",
+    "@types/node": "^24.13.3",
+    "@types/react": "^19",
+    "@types/react-dom": "^19.2.7",
+    "jsdom": "^30.0.1",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "tsup": "^9.0.0",
+    "typescript": "~5.9.3",
+    "vitest": "~4.1.11",
+    "@glboost/viewer": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint --config ../../eslint.config.js .",
+    "test": "vitest run"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
 }