@operato/scene-urdf 10.0.0-beta.2 → 10.0.0-beta.22

package/dist/smoothing-controller.js

@@ -0,0 +1,88 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Level 1 관절 스무딩 — 스크립트된 애니메이션이 아닌 "타겟 추적 감쇠".
+ *
+ * 구현: critically damped 2차 spring-damper ODE.
+ *   acc   = error × ω²  -  2 × ω × vel
+ *   vel  += acc × dt
+ *   pos  += vel × dt
+ * 여기서 ω는 응답 주파수(rad/s). 기본 ω=10이면 시상수 ~0.1s 수준으로 빠르게
+ * 수렴하면서도 overshoot 없음 (ζ=1).
+ *
+ * 사용자가 state.joints를 바꾸면 setTargets로 새 목표가 전달되고, tick에서
+ * 매 프레임 current가 target으로 수렴한다. 바뀐 값은 joint.setJointValue로
+ * 직접 적용.
+ */
+import { registerJointController } from './joint-controller.js';
+export class SmoothingController {
+    _joints;
+    _current = new Map();
+    _target = new Map();
+    _velocity = new Map();
+    /** 응답 주파수 (rad/s). 클수록 빠른 수렴. */
+    omega = 10;
+    /** 수렴 판정 임계값. error와 velocity가 모두 이 값 미만이면 그 조인트는 skip. */
+    epsilon = 1e-5;
+    setup(ctx) {
+        this._joints = ctx.joints;
+        this._current.clear();
+        this._target.clear();
+        this._velocity.clear();
+        for (const [name, joint] of ctx.joints) {
+            const v = joint.angle ?? 0;
+            this._current.set(name, v);
+            this._target.set(name, v);
+            this._velocity.set(name, 0);
+        }
+    }
+    setTargets(targets) {
+        for (const [name, raw] of Object.entries(targets)) {
+            const v = typeof raw === 'number' ? raw : Number(raw?.value);
+            if (Number.isFinite(v)) {
+                this._target.set(name, v);
+            }
+        }
+    }
+    tick(dt) {
+        if (!this._joints)
+            return false;
+        // dt 보정: 0 이하거나 비정상적으로 크면 (탭 전환 후 복귀 등) 스킵/클램프
+        if (dt <= 0)
+            return false;
+        if (dt > 0.1)
+            dt = 0.016;
+        const w = this.omega;
+        const w2 = w * w;
+        const twoW = 2 * w;
+        const eps = this.epsilon;
+        let changed = false;
+        for (const [name, joint] of this._joints) {
+            if (joint.jointType === 'fixed')
+                continue;
+            const target = this._target.get(name) ?? 0;
+            const cur = this._current.get(name) ?? target;
+            const vel = this._velocity.get(name) ?? 0;
+            const error = target - cur;
+            if (Math.abs(error) < eps && Math.abs(vel) < eps)
+                continue;
+            const acc = error * w2 - twoW * vel;
+            const newVel = vel + acc * dt;
+            const newCur = cur + newVel * dt;
+            this._current.set(name, newCur);
+            this._velocity.set(name, newVel);
+            joint.setJointValue(newCur);
+            changed = true;
+        }
+        return changed;
+    }
+    dispose() {
+        this._joints = undefined;
+        this._current.clear();
+        this._target.clear();
+        this._velocity.clear();
+    }
+}
+// 기본 등록. 'smooth' 이름으로 state.physics에서 선택 가능.
+registerJointController('smooth', () => new SmoothingController());
+//# sourceMappingURL=smoothing-controller.js.map

package/dist/smoothing-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoothing-controller.js","sourceRoot":"","sources":["../src/smoothing-controller.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Level 1 관절 스무딩 — 스크립트된 애니메이션이 아닌 \"타겟 추적 감쇠\".\n *\n * 구현: critically damped 2차 spring-damper ODE.\n *   acc   = error × ω²  -  2 × ω × vel\n *   vel  += acc × dt\n *   pos  += vel × dt\n * 여기서 ω는 응답 주파수(rad/s). 기본 ω=10이면 시상수 ~0.1s 수준으로 빠르게\n * 수렴하면서도 overshoot 없음 (ζ=1).\n *\n * 사용자가 state.joints를 바꾸면 setTargets로 새 목표가 전달되고, tick에서\n * 매 프레임 current가 target으로 수렴한다. 바뀐 값은 joint.setJointValue로\n * 직접 적용.\n */\n\nimport type { URDFJoint } from 'urdf-loader'\nimport type { JointController, JointControllerContext } from './joint-controller.js'\nimport { registerJointController } from './joint-controller.js'\n\nexport class SmoothingController implements JointController {\n  private _joints?: Map<string, URDFJoint>\n  private _current = new Map<string, number>()\n  private _target = new Map<string, number>()\n  private _velocity = new Map<string, number>()\n\n  /** 응답 주파수 (rad/s). 클수록 빠른 수렴. */\n  omega: number = 10\n\n  /** 수렴 판정 임계값. error와 velocity가 모두 이 값 미만이면 그 조인트는 skip. */\n  epsilon: number = 1e-5\n\n  setup(ctx: JointControllerContext): void {\n    this._joints = ctx.joints\n    this._current.clear()\n    this._target.clear()\n    this._velocity.clear()\n\n    for (const [name, joint] of ctx.joints) {\n      const v = joint.angle ?? 0\n      this._current.set(name, v)\n      this._target.set(name, v)\n      this._velocity.set(name, 0)\n    }\n  }\n\n  setTargets(targets: Record<string, number>): void {\n    for (const [name, raw] of Object.entries(targets)) {\n      const v = typeof raw === 'number' ? raw : Number((raw as { value?: number } | null)?.value)\n      if (Number.isFinite(v)) {\n        this._target.set(name, v)\n      }\n    }\n  }\n\n  tick(dt: number): boolean {\n    if (!this._joints) return false\n    // dt 보정: 0 이하거나 비정상적으로 크면 (탭 전환 후 복귀 등) 스킵/클램프\n    if (dt <= 0) return false\n    if (dt > 0.1) dt = 0.016\n\n    const w = this.omega\n    const w2 = w * w\n    const twoW = 2 * w\n    const eps = this.epsilon\n    let changed = false\n\n    for (const [name, joint] of this._joints) {\n      if (joint.jointType === 'fixed') continue\n\n      const target = this._target.get(name) ?? 0\n      const cur = this._current.get(name) ?? target\n      const vel = this._velocity.get(name) ?? 0\n      const error = target - cur\n\n      if (Math.abs(error) < eps && Math.abs(vel) < eps) continue\n\n      const acc = error * w2 - twoW * vel\n      const newVel = vel + acc * dt\n      const newCur = cur + newVel * dt\n\n      this._current.set(name, newCur)\n      this._velocity.set(name, newVel)\n      joint.setJointValue(newCur)\n      changed = true\n    }\n\n    return changed\n  }\n\n  dispose(): void {\n    this._joints = undefined\n    this._current.clear()\n    this._target.clear()\n    this._velocity.clear()\n  }\n}\n\n// 기본 등록. 'smooth' 이름으로 state.physics에서 선택 가능.\nregisterJointController('smooth', () => new SmoothingController())\n"]}

package/dist/templates/index.d.ts

@@ -9,6 +9,9 @@ declare const _default: {
         top: number;
         width: number;
         height: number;
+        depth: number;
+        upAxis: string;
+        unitScale: number;
     };
 }[];
 export default _default;

package/dist/templates/index.js

@@ -1,4 +1,3 @@
-import URDFViewer from './urdf-viewer.js';
-import URDFController from './urdf-controller.js';
-export default [URDFViewer, URDFController];
+import urdf from './urdf.js';
+export default [urdf];
 //# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,kBAAkB,CAAA;AACzC,OAAO,cAAc,MAAM,sBAAsB,CAAA;AAEjD,eAAe,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA","sourcesContent":["import URDFViewer from './urdf-viewer.js'\nimport URDFController from './urdf-controller.js'\n\nexport default [URDFViewer, URDFController]\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,eAAe,CAAC,IAAI,CAAC,CAAA","sourcesContent":["import urdf from './urdf.js'\n\nexport default [urdf]\n"]}

package/dist/templates/{urdf-controller.d.ts → urdf.d.ts}

@@ -9,6 +9,9 @@ declare const _default: {
         top: number;
         width: number;
         height: number;
+        depth: number;
+        upAxis: string;
+        unitScale: number;
     };
 };
 export default _default;

package/dist/templates/urdf.js

@@ -0,0 +1,19 @@
+const icon = new URL('../../icons/urdf.png', import.meta.url).href;
+export default {
+    type: 'urdf',
+    description: 'urdf',
+    group: '3D',
+    /* line|shape|textAndMedia|chartAndGauge|table|container|dataSource|3D|facility|storage|conveyance|transport|form|etc */
+    icon,
+    model: {
+        type: 'urdf',
+        left: 10,
+        top: 10,
+        width: 200,
+        height: 200,
+        depth: 200,
+        upAxis: 'z',
+        unitScale: 1000
+    }
+};
+//# sourceMappingURL=urdf.js.map

package/dist/templates/urdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urdf.js","sourceRoot":"","sources":["../../src/templates/urdf.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AAElE,eAAe;IACb,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,IAAI;IACX,wHAAwH;IACxH,IAAI;IACJ,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,IAAI;KAChB;CACF,CAAA","sourcesContent":["const icon = new URL('../../icons/urdf.png', import.meta.url).href\n\nexport default {\n  type: 'urdf',\n  description: 'urdf',\n  group: '3D',\n  /* line|shape|textAndMedia|chartAndGauge|table|container|dataSource|3D|facility|storage|conveyance|transport|form|etc */\n  icon,\n  model: {\n    type: 'urdf',\n    left: 10,\n    top: 10,\n    width: 200,\n    height: 200,\n    depth: 200,\n    upAxis: 'z',\n    unitScale: 1000\n  }\n}\n"]}

package/dist/urdf-object.d.ts

@@ -0,0 +1,264 @@
+import { Shape, type ComponentNature, type Control, type IRealObject } from '@hatiolab/things-scene';
+import type { URDFJointState, URDFJointMeta } from './real-object-urdf.js';
+declare const URDFObject_base: (new (...args: any[]) => {
+    contains(x: number, y: number): boolean;
+    get path(): {
+        x: any;
+        y: any;
+    }[];
+    set path(path: {
+        x: any;
+        y: any;
+    }[]): any;
+    get anchors(): {
+        name: string;
+        position: {
+            x: any;
+            y: any;
+        };
+    }[];
+    get bounds(): any;
+    set bounds(bounds: any): any;
+    render(ctx: CanvasRenderingContext2D): void;
+    _app: any;
+    _model: any;
+    _state: any;
+    _delta: any;
+    _animation: any;
+    _animate: any;
+    _parent: any;
+    _disposed: any;
+    _textHidden: any;
+    _text_substitutor: any;
+    _value_substitutor: any;
+    _mappings: any;
+    _realObject: import("@hatiolab/things-scene").IRealObject | undefined;
+    _cachedState: any;
+    updatedAt: any;
+    fontSize: any;
+    __cache__: any;
+    created(): void;
+    added(parent: any): void;
+    removed(parent: any): void;
+    ready(): Promise<void>;
+    touch(): void;
+    clearCache(...attrs: any[]): void;
+    removeSelf(completely: any): void;
+    resetAnimation(): void;
+    dispose(): void;
+    get nature(): import("@hatiolab/things-scene").ComponentNature;
+    get disposed(): boolean;
+    isLayer(): boolean;
+    isGroup(): boolean;
+    isContainer(): this is import("@hatiolab/things-scene/dist-types/types/component.js").Container;
+    isLine(): boolean;
+    isRoot(): boolean;
+    isRootModel(): boolean;
+    is3dish(): boolean;
+    get is3dMode(): boolean;
+    isIn3DSpace(): boolean;
+    isTemplate(): boolean;
+    isHTMLElement(): boolean;
+    isConnectable(): boolean;
+    isIdentifiable(): boolean;
+    isPositionable(): boolean;
+    replaceRefids(replaceMap: any): void;
+    get(property: any): any;
+    set(props: any, propval?: any): any;
+    getState(property: any): any;
+    setState(props: any, propval?: any): any;
+    get model(): any;
+    get state(): any;
+    get hierarchy(): any;
+    get volatile(): never[];
+    _applyProps(target: any, props: any, options: any): any;
+    move(offset: {
+        x: number;
+        y: number;
+    }, ...args: boolean[]): void;
+    symmetryX(x?: number): void;
+    symmetryY(y: number): void;
+    adjustResize(bounds: import("@hatiolab/things-scene").BOUNDS, origin_bounds: import("@hatiolab/things-scene").BOUNDS, diagonal: boolean): {
+        left: any;
+        top: any;
+        width: any;
+        height: any;
+    };
+    adjustRotation(rotation: number, step: boolean): number;
+    outline(progress: number): any;
+    get center(): import("@hatiolab/things-scene").POINT;
+    set center(p: import("@hatiolab/things-scene").POINT): any;
+    get location(): import("@hatiolab/things-scene").POINT;
+    set location(l: import("@hatiolab/things-scene").POINT): any;
+    get rotate(): import("@hatiolab/things-scene").POINT;
+    set rotate(r: import("@hatiolab/things-scene").POINT): any;
+    get dimension(): import("@hatiolab/things-scene").DIMENSION;
+    set dimension(d: import("@hatiolab/things-scene").DIMENSION): any;
+    get drawPath(): import("@hatiolab/things-scene").POINT[];
+    get rotatePoint(): import("@hatiolab/things-scene").POINT;
+    get mutable(): boolean;
+    get resizable(): boolean;
+    get rotatable(): boolean;
+    buildRealObject(): import("@hatiolab/things-scene").IRealObject | undefined;
+    get realObject(): import("@hatiolab/things-scene").IRealObject | undefined;
+    draw(context?: import("@hatiolab/things-scene").SceneRenderContext): void;
+    prerender(context: import("@hatiolab/things-scene").SceneRenderContext): void;
+    postrender(context: import("@hatiolab/things-scene").SceneRenderContext): void;
+    prepare(resolve: (component: import("@hatiolab/things-scene").Component) => void, reject: (reason: any) => void): void;
+    prepareIf(condition: boolean): void;
+    drawText(context: import("@hatiolab/things-scene").SceneRenderContext): void;
+    drawStroke(context: import("@hatiolab/things-scene").SceneRenderContext, override?: Record<string, unknown>): void;
+    drawFill(context: import("@hatiolab/things-scene").SceneRenderContext, override?: Record<string, unknown>): void;
+    get strokeStyle(): any;
+    set strokeStyle(v: any): any;
+    get fillStyle(): any;
+    set fillStyle(v: any): any;
+    get fontColor(): string;
+    set fontColor(v: string): any;
+    get rotation(): number;
+    set rotation(v: number): any;
+    get decorators(): string[];
+    get decotag(): string;
+    get hidden(): boolean;
+    set hidden(v: boolean): any;
+    get tag(): string;
+    set tag(v: string): any;
+    get appendum(): any;
+    set appendum(v: any): any;
+    defaultTextSubstitutor(): string;
+    textLines(context?: import("@hatiolab/things-scene").SceneRenderContext): any[][];
+    get font(): string;
+    get lineHeight(): number;
+    get textSubstitutor(): () => string;
+    get text(): string;
+    set text(v: string): any;
+    get textBounds(): import("@hatiolab/things-scene").BOUNDS;
+    get textRotation(): number;
+    get textHidden(): boolean;
+    set textHidden(v: boolean): any;
+    get hasTextProperty(): boolean;
+    animate(opts: import("@hatiolab/things-scene").AnimationConfig): any;
+    effect(context: import("@hatiolab/things-scene").SceneRenderContext, model: any): void;
+    serialize(...others: any[]): string;
+    trim(): void;
+    closeScene(data: any): void;
+    delta(attr?: string | object, value?: any): any;
+    invalidate(): void;
+    get value(): any;
+    set value(v: any): any;
+    get data(): any;
+    set data(v: any): any;
+    set tap(v: any): any;
+    get mappings(): any[];
+    get retention(): number;
+    get animation(): import("@hatiolab/things-scene").AnimationController | undefined;
+    get started(): boolean;
+    set started(v: boolean): any;
+    get controls(): import("@hatiolab/things-scene").Control[] | undefined;
+    findFirst(finder: string | ((c: import("@hatiolab/things-scene").Component) => boolean), ...others: any[]): import("@hatiolab/things-scene").Component | undefined;
+    findAll(s: string | ((c: import("@hatiolab/things-scene").Component) => boolean), ...others: any[]): any[] | undefined;
+    capture(x: number, y: number, except?: (c: import("@hatiolab/things-scene").Component) => boolean): any;
+    findAnchor(name: string): any;
+    isDescendible(container: import("@hatiolab/things-scene").Component): boolean;
+    getContext(component?: unknown): any;
+    get root(): import("@hatiolab/things-scene").Component;
+    get rootModel(): import("@hatiolab/things-scene").Component;
+    get parent(): import("@hatiolab/things-scene").Component;
+    set parent(v: import("@hatiolab/things-scene").Component): any;
+    get scalable(): boolean;
+    get stuck(): boolean;
+    get capturable(): boolean;
+    get position(): string;
+    get origin(): string;
+    get offset(): import("@hatiolab/things-scene").POINT;
+    get app(): import("@hatiolab/things-scene").ApplicationContext;
+    drawEffect(context: import("@hatiolab/things-scene").SceneRenderContext): void;
+    prepareFill(resolve: Function, reject: Function): void;
+    prepareFillIf(condition: boolean): void;
+    onchangeFill(after: Record<string, any>, before: Record<string, any>): void;
+    drawImage(context: import("@hatiolab/things-scene").SceneRenderContext, image: HTMLImageElement, left: number, top: number, width: number, height: number): void;
+    mutateBounds(logic: ((bounds: import("@hatiolab/things-scene").BOUNDS) => import("@hatiolab/things-scene").BOUNDS | void) | null, context?: any): void;
+    mutatePath(beforeLogic: ((path: import("@hatiolab/things-scene").POINT[]) => import("@hatiolab/things-scene").POINT[] | void) | null, afterLogic: ((path: import("@hatiolab/things-scene").POINT[]) => import("@hatiolab/things-scene").POINT[] | void) | null, context?: any): void;
+    access(accessor: string): any;
+    substitute(template: string, data: any): string | undefined;
+    onchangeMappings(after: Record<string, any>, before: Record<string, any>): void;
+    onchangeData(after: Record<string, any>, before: Record<string, any>): void;
+    buildMappings(): void;
+    executeMappings(force?: boolean): void;
+    disposeMappings(): void;
+    ondropfile(transfered: FileList, files: string[]): void;
+    transcoordS2P(x: number, y: number, rp?: import("@hatiolab/things-scene").POINT): import("@hatiolab/things-scene").POINT;
+    transcoordP2S(x: number, y: number, rp?: import("@hatiolab/things-scene").POINT): import("@hatiolab/things-scene").POINT;
+    transcoordS2T(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    transcoordT2P(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    transcoordT2S(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    transcoordS2TR(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    transcoordS2O(x: number, y: number, target: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    transcoordC2S(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    transcoordS2C(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    toParent(x: number, y: number, rp?: import("@hatiolab/things-scene").POINT): import("@hatiolab/things-scene").POINT;
+    fromParent(x: number, y: number, rp?: import("@hatiolab/things-scene").POINT): import("@hatiolab/things-scene").POINT;
+    toScene(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    fromScene(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    toLocal(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    toGlobal(x: number, y: number, top?: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    toOther(x: number, y: number, target: import("@hatiolab/things-scene").Component): import("@hatiolab/things-scene").POINT;
+    on(name: string | object, callback: Function, context?: any): any;
+    off(name?: string | object, callback?: Function, context?: any): any;
+    once(name: string | object, callback: Function, context?: any): any;
+    trigger(name: string, ...args: any[]): any;
+    delegate_on(delegator: any): any;
+    delegate_off(delegator: any): any;
+    onchange(after: Record<string, any>, before: Record<string, any>): void;
+    calculateBounds?(): void;
+    oncreate_element?(element: HTMLElement): void;
+    removeComponent(component: import("@hatiolab/things-scene").Component, ghost?: boolean): void;
+    addComponent(component: import("@hatiolab/things-scene").Component, ghost?: boolean): void;
+    insertComponentAt(component: import("@hatiolab/things-scene").Component, index: number, ghost?: boolean): void;
+    getOverlay(component: import("@hatiolab/things-scene").Component): HTMLElement | undefined;
+    findById(id: string): import("@hatiolab/things-scene").Component | undefined;
+    findByRefid(ref: string | number): import("@hatiolab/things-scene").Component | undefined;
+    findAllById(id: string): import("@hatiolab/things-scene").Component[];
+    resize(): void;
+    fit(type?: string): void;
+    get components(): import("@hatiolab/things-scene").Component[] | undefined;
+    get layout(): any;
+    get auxOverlay(): HTMLElement | undefined;
+    get isReady(): boolean;
+    get unitScale(): number;
+    get selected(): import("@hatiolab/things-scene").Component[];
+    set selected(_v: import("@hatiolab/things-scene").Component[]): any;
+    get focused(): import("@hatiolab/things-scene").Component | null;
+    set focused(_v: import("@hatiolab/things-scene").Component | null): any;
+    get hasSameParentForAllSelected(): boolean;
+    set hasSameParentForAllSelected(_v: boolean): any;
+    get fitMode(): string | undefined;
+    set fitMode(_v: string | undefined): any;
+    get element(): HTMLElement | null;
+    set element(_v: HTMLElement | null): any;
+}) & typeof Shape;
+export declare class URDFObject extends URDFObject_base {
+    get hasTextProperty(): boolean;
+    is3dish(): boolean;
+    get controls(): Array<Control> | undefined;
+    render(context: CanvasRenderingContext2D): void;
+    ready(): Promise<void>;
+    onchange(after: Record<string, any>, before: Record<string, any>): void;
+    private _ensureTopViewSnapshot;
+    buildRealObject(): IRealObject | undefined;
+    get nature(): ComponentNature;
+    get source(): any;
+    set source(source: any);
+    set dimension(dimension: {
+        width: number;
+        height: number;
+        depth: number;
+    });
+    /** 조인트 상태 맵. 값은 숫자(라디안/거리) 또는 { value } 형식 허용. */
+    get joints(): Record<string, URDFJointState | number> | undefined;
+    set joints(value: Record<string, URDFJointState | number> | undefined);
+    /** 로드된 URDF의 조인트 메타 정보. property editor가 슬라이더 UI 생성에 사용. */
+    get jointMeta(): URDFJointMeta[];
+    get jointNames(): string[];
+}
+export {};

package/dist/urdf-object.js

@@ -0,0 +1,190 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * URDF 로봇을 things-scene 3D 공간에 네이티브로 임베드한다.
+ * GLTFObject와 대칭적인 구조 — 2D 탑뷰는 스냅샷 렌더로 표현한다.
+ */
+import { __decorate } from "tslib";
+import { RectPath, Shape, sceneComponent } from '@hatiolab/things-scene';
+import { RealObjectURDF } from './real-object-urdf.js';
+const BASE_URL_ALIAS = '$base_url';
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: true,
+    properties: [
+        {
+            type: 'urdf-preset',
+            label: 'preset',
+            name: 'preset'
+        },
+        {
+            type: 'string',
+            label: 'url',
+            name: 'src',
+            property: {
+                displayField: 'id',
+                displayFullUrl: true,
+                baseUrlAlias: BASE_URL_ALIAS,
+                defaultStorage: '3d-model',
+                storageFilters: {
+                    type: Array,
+                    value: [
+                        {
+                            name: 'category',
+                            value: 'urdf'
+                        }
+                    ]
+                },
+                useUpload: true,
+                category: 'application'
+            }
+        },
+        {
+            type: 'select',
+            label: 'up-axis',
+            name: 'upAxis',
+            property: {
+                options: [
+                    { display: 'Z (URDF default)', value: 'z' },
+                    { display: 'Y (Three.js default)', value: 'y' }
+                ]
+            }
+        },
+        {
+            type: 'number',
+            label: 'unit-scale',
+            name: 'unitScale',
+            placeholder: '1000'
+        },
+        {
+            type: 'select',
+            label: 'auto-animate',
+            name: 'autoAnimate',
+            property: {
+                options: [
+                    { display: 'Off', value: 'none' },
+                    { display: 'Sine swing', value: 'sine' }
+                ]
+            }
+        },
+        {
+            type: 'select',
+            label: 'physics',
+            name: 'physics',
+            property: {
+                options: [
+                    { display: 'Direct (immediate)', value: 'none' },
+                    { display: 'Smooth (damped)', value: 'smooth' }
+                ]
+            }
+        },
+        {
+            type: 'urdf-joints',
+            label: '',
+            name: 'joints',
+            editor: {
+                fullwidth: true
+            }
+        }
+    ],
+    'value-property': 'source',
+    help: 'scene/component/urdf'
+};
+let URDFObject = class URDFObject extends RectPath(Shape) {
+    get hasTextProperty() {
+        return false;
+    }
+    is3dish() {
+        return true;
+    }
+    get controls() {
+        return [];
+    }
+    render(context) {
+        const { left, top, width, height } = this.bounds;
+        context.beginPath();
+        const snapshot = this._topViewSnapshot;
+        if (snapshot) {
+            context.drawImage(snapshot, left, top, width, height);
+        }
+        else {
+            // 폴백: 로봇 아이콘 박스 + 중앙 라벨
+            context.rect(left, top, width, height);
+            context.fillStyle = '#e3f2fd';
+            context.fill();
+            context.strokeStyle = '#1976d2';
+            context.lineWidth = 1;
+            context.stroke();
+            const src = this.getState('src');
+            const label = src ? src.split('/').pop()?.replace(/\.[^.]+$/, '') || 'URDF' : 'URDF';
+            const fontSize = Math.max(10, Math.min(width, height) * 0.12);
+            context.fillStyle = '#1976d2';
+            context.font = `${fontSize}px sans-serif`;
+            context.textAlign = 'center';
+            context.textBaseline = 'middle';
+            context.fillText(label, left + width / 2, top + height / 2, width * 0.9);
+        }
+    }
+    async ready() {
+        await super.ready();
+        this._ensureTopViewSnapshot();
+    }
+    onchange(after, before) {
+        super.onchange(after, before);
+        if ('src' in after) {
+            this._topViewSnapshot = undefined;
+            this._ensureTopViewSnapshot();
+        }
+    }
+    _ensureTopViewSnapshot() {
+        const src = this.getState('src');
+        if (!src)
+            return;
+        const cached = RealObjectURDF.getTopViewCache(src);
+        if (cached) {
+            this._topViewSnapshot = cached;
+            this.invalidate();
+        }
+        // 캐시 miss인 경우 3D 씬이 활성화되면 _onLoaded에서 자동 생성한다.
+    }
+    buildRealObject() {
+        return new RealObjectURDF(this);
+    }
+    get nature() {
+        return NATURE;
+    }
+    get source() {
+        return this.getState('src');
+    }
+    set source(source) {
+        this.setState('src', source);
+    }
+    set dimension(dimension) {
+        const { width = 1, height = 1, depth = 1 } = dimension;
+        this.setState({ width, height, depth });
+        this.realObject?.updateDimension();
+    }
+    // --- URDF 바인딩 API ---
+    /** 조인트 상태 맵. 값은 숫자(라디안/거리) 또는 { value } 형식 허용. */
+    get joints() {
+        return this.getState('joints');
+    }
+    set joints(value) {
+        this.setState('joints', value);
+    }
+    /** 로드된 URDF의 조인트 메타 정보. property editor가 슬라이더 UI 생성에 사용. */
+    get jointMeta() {
+        const ro = this.realObject;
+        return ro?.jointMeta ?? [];
+    }
+    get jointNames() {
+        const ro = this.realObject;
+        return ro?.jointNames ?? [];
+    }
+};
+URDFObject = __decorate([
+    sceneComponent('urdf')
+], URDFObject);
+export { URDFObject };
+//# sourceMappingURL=urdf-object.js.map

package/dist/urdf-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urdf-object.js","sourceRoot":"","sources":["../src/urdf-object.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * URDF 로봇을 things-scene 3D 공간에 네이티브로 임베드한다.\n * GLTFObject와 대칭적인 구조 — 2D 탑뷰는 스냅샷 렌더로 표현한다.\n */\n\nimport {\n  RectPath,\n  Shape,\n  sceneComponent,\n  type ComponentNature,\n  type Control,\n  type IRealObject\n} from '@hatiolab/things-scene'\nimport { RealObjectURDF } from './real-object-urdf.js'\nimport type { URDFJointState, URDFJointMeta } from './real-object-urdf.js'\n\nconst BASE_URL_ALIAS = '$base_url'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'urdf-preset',\n      label: 'preset',\n      name: 'preset'\n    },\n    {\n      type: 'string',\n      label: 'url',\n      name: 'src',\n      property: {\n        displayField: 'id',\n        displayFullUrl: true,\n        baseUrlAlias: BASE_URL_ALIAS,\n        defaultStorage: '3d-model',\n        storageFilters: {\n          type: Array,\n          value: [\n            {\n              name: 'category',\n              value: 'urdf'\n            }\n          ]\n        },\n        useUpload: true,\n        category: 'application'\n      }\n    },\n    {\n      type: 'select',\n      label: 'up-axis',\n      name: 'upAxis',\n      property: {\n        options: [\n          { display: 'Z (URDF default)', value: 'z' },\n          { display: 'Y (Three.js default)', value: 'y' }\n        ]\n      }\n    },\n    {\n      type: 'number',\n      label: 'unit-scale',\n      name: 'unitScale',\n      placeholder: '1000'\n    },\n    {\n      type: 'select',\n      label: 'auto-animate',\n      name: 'autoAnimate',\n      property: {\n        options: [\n          { display: 'Off', value: 'none' },\n          { display: 'Sine swing', value: 'sine' }\n        ]\n      }\n    },\n    {\n      type: 'select',\n      label: 'physics',\n      name: 'physics',\n      property: {\n        options: [\n          { display: 'Direct (immediate)', value: 'none' },\n          { display: 'Smooth (damped)', value: 'smooth' }\n        ]\n      }\n    },\n    {\n      type: 'urdf-joints',\n      label: '',\n      name: 'joints',\n      editor: {\n        fullwidth: true\n      }\n    }\n  ],\n  'value-property': 'source',\n  help: 'scene/component/urdf'\n}\n\n@sceneComponent('urdf')\nexport class URDFObject extends RectPath(Shape) {\n  get hasTextProperty() {\n    return false\n  }\n\n  is3dish() {\n    return true\n  }\n\n  get controls(): Array<Control> | undefined {\n    return []\n  }\n\n  render(context: CanvasRenderingContext2D) {\n    const { left, top, width, height } = this.bounds\n\n    context.beginPath()\n\n    const snapshot = (this as any)._topViewSnapshot as HTMLCanvasElement | undefined\n    if (snapshot) {\n      context.drawImage(snapshot, left, top, width, height)\n    } else {\n      // 폴백: 로봇 아이콘 박스 + 중앙 라벨\n      context.rect(left, top, width, height)\n      context.fillStyle = '#e3f2fd'\n      context.fill()\n      context.strokeStyle = '#1976d2'\n      context.lineWidth = 1\n      context.stroke()\n\n      const src = this.getState('src') as string | undefined\n      const label = src ? src.split('/').pop()?.replace(/\\.[^.]+$/, '') || 'URDF' : 'URDF'\n      const fontSize = Math.max(10, Math.min(width, height) * 0.12)\n      context.fillStyle = '#1976d2'\n      context.font = `${fontSize}px sans-serif`\n      context.textAlign = 'center'\n      context.textBaseline = 'middle'\n      context.fillText(label, left + width / 2, top + height / 2, width * 0.9)\n    }\n  }\n\n  async ready() {\n    await super.ready()\n    this._ensureTopViewSnapshot()\n  }\n\n  onchange(after: Record<string, any>, before: Record<string, any>) {\n    super.onchange(after, before)\n    if ('src' in after) {\n      (this as any)._topViewSnapshot = undefined\n      this._ensureTopViewSnapshot()\n    }\n  }\n\n  private _ensureTopViewSnapshot() {\n    const src = this.getState('src') as string | undefined\n    if (!src) return\n\n    const cached = RealObjectURDF.getTopViewCache(src)\n    if (cached) {\n      (this as any)._topViewSnapshot = cached\n      this.invalidate()\n    }\n    // 캐시 miss인 경우 3D 씬이 활성화되면 _onLoaded에서 자동 생성한다.\n  }\n\n  buildRealObject(): IRealObject | undefined {\n    return new RealObjectURDF(this as any)\n  }\n\n  get nature() {\n    return NATURE\n  }\n\n  get source() {\n    return this.getState('src')\n  }\n\n  set source(source) {\n    this.setState('src', source)\n  }\n\n  set dimension(dimension: { width: number; height: number; depth: number }) {\n    const { width = 1, height = 1, depth = 1 } = dimension\n    this.setState({ width, height, depth })\n    this.realObject?.updateDimension()\n  }\n\n  // --- URDF 바인딩 API ---\n\n  /** 조인트 상태 맵. 값은 숫자(라디안/거리) 또는 { value } 형식 허용. */\n  get joints(): Record<string, URDFJointState | number> | undefined {\n    return this.getState('joints')\n  }\n\n  set joints(value: Record<string, URDFJointState | number> | undefined) {\n    this.setState('joints', value)\n  }\n\n  /** 로드된 URDF의 조인트 메타 정보. property editor가 슬라이더 UI 생성에 사용. */\n  get jointMeta(): URDFJointMeta[] {\n    const ro = this.realObject as RealObjectURDF | undefined\n    return ro?.jointMeta ?? []\n  }\n\n  get jointNames(): string[] {\n    const ro = this.realObject as RealObjectURDF | undefined\n    return ro?.jointNames ?? []\n  }\n}\n"]}

package/dist/urdf-presets.d.ts

@@ -0,0 +1,22 @@
+export interface UrdfPreset {
+    /** 고유 식별자 (select value) */
+    id: string;
+    /** 표시 이름 */
+    display: string;
+    /** 로봇 분류 (arm / mobile / aerial / humanoid / quadruped) */
+    category: 'arm' | 'mobile' | 'aerial' | 'humanoid' | 'quadruped';
+    /** URDF 파일 URL */
+    src: string;
+    /** 컴포넌트 기본 dimension (mm). 로드 시 uniform best-fit scale 적용. */
+    width: number;
+    height: number;
+    depth: number;
+    /** 좌표계 up 축 (URDF는 보통 'z') */
+    upAxis: 'z' | 'y';
+    /** URDF meter → 에디터 mm 스케일 (보통 1000) */
+    unitScale: number;
+    /** ROS `package://<pkg>/...` prefix 해석 맵. 없으면 URDF 상대 경로만 지원. */
+    packages?: Record<string, string>;
+}
+export declare const URDF_PRESETS: UrdfPreset[];
+export declare function findPreset(id: string): UrdfPreset | undefined;