@gamedevland/cyber-ui-sdk 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gamedev Land
+
+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,126 @@
-# Temporary Holding Version
+# @gamedevland/cyber-ui-sdk
 
-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.
+GameDevLand SDK lifecycle adapter for Cyber UI Toolkit. Uses the host SDK's public APIs,
+Graphics, input routing, tweens and render loop.
+
+```sh
+npm install @gamedevland/cyber-ui @gamedevland/cyber-ui-sdk @gamedevland/engine@0.0.11 pixi.js
+```
+
+## A panel component
+
+```ts
+import { CyberPreset, TerminalGlass } from '@gamedevland/cyber-ui';
+import { ToolkitComponent } from '@gamedevland/cyber-ui-sdk';
+import { SchemaDecoder as S } from '@gamedevland/engine/validation';
+import type { Graphics } from '@gamedevland/engine/layouts';
+import type { InferDecoded } from '@gamedevland/engine/validation';
+
+const configDecoder = S.object({
+  width: S.number({ min: 48 }),
+  height: S.number({ min: 28 }),
+  cut: S.number({ min: 0 }),
+});
+
+export class CyberPanel extends ToolkitComponent<InferDecoded<typeof configDecoder>, Graphics> {
+  protected readonly configDecoder = configDecoder;
+
+  protected override onReady(): void {
+    const { width, height, cut } = this.config;
+    const palette = CyberPreset.palette;
+    TerminalGlass.draw(
+      this.node.view.clear(),
+      0,
+      0,
+      width,
+      height,
+      cut,
+      palette.panel,
+      palette.panelEdge,
+      palette.accent,
+      palette.text,
+    );
+  }
+}
+```
+
+Register the component in your `GlobalDiDefinition.registerComponents()`:
+
+```ts
+group.add('CyberPanel', CyberPanel);
+```
+
+The `Graphics` element factory must also be registered. Add the component to a Graphics
+node in your SDK layout:
+
+```json
+{
+  "type": "Graphics",
+  "components": {
+    "surface": {
+      "type": "CyberPanel",
+      "data": { "width": 320, "height": 180, "cut": 12 }
+    }
+  }
+}
+```
+
+The parent layout owns positioning. Add Text nodes for content and use `node.input` for
+interaction. Changing a component's appearance does not execute application commands.
+
+## Animated components
+
+In `onReady()`, register effects with `this.ownEffect(new TriangleLoader(options))`.
+Base `onUpdate(deltaSeconds)` advances owned effects. Render them into child Graphics after
+calling `super.onUpdate(deltaSeconds)` exactly once. Enable/disable pauses them; detach
+disposes them before SDK views are removed. Call `setUiReducedMotion(reduced)` when the host
+preference changes; later-owned effects inherit the preference too.
+
+Overrides of lifecycle hooks preserve the base hooks. In an overridden `onDetach()`, return
+`super.onDetach()` after releasing your own resources. Do not dispose effects registered
+with `ownEffect()` separately. `uiViewport` returns logical width/height, CSS width/height,
+and scale; local bounds remain the application's responsibility.
+
+## PanelReveal action
+
+Register in `GlobalDiDefinition.registerServices()`:
+
+```ts
+import { DiTokens } from '@gamedevland/engine/di';
+import { PanelReveal } from '@gamedevland/cyber-ui-sdk';
+
+registrar.transientClass(DiTokens.action('PanelReveal'), PanelReveal);
+```
+
+Attach to a dedicated Container wrapper in the layout:
+
+```json
+{
+  "type": "Container",
+  "actions": { "reveal": { "type": "PanelReveal" } }
+}
+```
+
+Invoke through the SDK node action facade:
+
+```ts
+void node.runAction('reveal', {
+  duration: 240,
+  delay: 0,
+  offset: 8,
+  axis: 'down',
+});
+```
+
+`duration`: 1–2000 ms; `delay`: 0–1000 ms; `offset`: 0–16 local units.
+`axis` is optional (`down`, `right`, `zoom`); `pivotX`, `pivotY`, and `closing` are optional.
+The action captures the wrapper transform at attachment. Opening returns to that transform;
+closing moves/scales/fades away; cancellation restores it. Keep layout and other animations
+on a parent or child so they do not compete for the wrapper's transform. Use a static state
+instead when reduced motion is enabled. The action schedules SDK-owned tweens; invocation
+does not wait for their completion.
+
+[Full guide](https://github.com/gamedevland/cyber-ui-toolkit#readme)
+· [Typechecked component](https://github.com/gamedevland/cyber-ui-toolkit/blob/main/examples/sdk/src/CyberPanel.ts)
+
+MIT License. Core `^0.1.0`, SDK `0.0.11`, PixiJS `>=8.16.0 <9`.

package/dist/PanelReveal.d.ts

@@ -0,0 +1,31 @@
+import { BaseTypedAction } from '@gamedevland/engine/layouts';
+import type { InferDecoded } from '@gamedevland/engine/validation';
+declare const configDecoder: import("@gamedevland/engine/layouts").Decoder<import("@gamedevland/engine/layouts").InferObject<{}>>;
+declare const inputDecoder: import("@gamedevland/engine/layouts").Decoder<import("@gamedevland/engine/layouts").InferObject<{
+    duration: import("@gamedevland/engine/layouts").Decoder<number>;
+    delay: import("@gamedevland/engine/layouts").Decoder<number>;
+    offset: import("@gamedevland/engine/layouts").Decoder<number>;
+    axis: import("@gamedevland/engine/layouts").Decoder<"down" | "right" | "zoom" | undefined>;
+    pivotX: import("@gamedevland/engine/layouts").Decoder<number | undefined>;
+    pivotY: import("@gamedevland/engine/layouts").Decoder<number | undefined>;
+    closing: import("@gamedevland/engine/layouts").Decoder<boolean | undefined>;
+}>>;
+/** Reveals a dedicated animation wrapper relative to its attached layout transform. */
+export declare class PanelReveal extends BaseTypedAction<InferDecoded<typeof configDecoder>, InferDecoded<typeof inputDecoder>> {
+    protected readonly configDecoder: import("@gamedevland/engine/layouts").Decoder<import("@gamedevland/engine/layouts").InferObject<{}>>;
+    protected readonly inputDecoder: import("@gamedevland/engine/layouts").Decoder<import("@gamedevland/engine/layouts").InferObject<{
+        duration: import("@gamedevland/engine/layouts").Decoder<number>;
+        delay: import("@gamedevland/engine/layouts").Decoder<number>;
+        offset: import("@gamedevland/engine/layouts").Decoder<number>;
+        axis: import("@gamedevland/engine/layouts").Decoder<"down" | "right" | "zoom" | undefined>;
+        pivotX: import("@gamedevland/engine/layouts").Decoder<number | undefined>;
+        pivotY: import("@gamedevland/engine/layouts").Decoder<number | undefined>;
+        closing: import("@gamedevland/engine/layouts").Decoder<boolean | undefined>;
+    }>>;
+    private origin?;
+    protected onInit(): void;
+    protected execute(input: InferDecoded<typeof inputDecoder>): void;
+    protected onCancel(): void;
+    private getOrigin;
+}
+export {};

package/dist/PanelReveal.js

@@ -0,0 +1,61 @@
+import { PanelTransition } from '@gamedevland/cyber-ui';
+import { BaseTypedAction } from '@gamedevland/engine/layouts';
+import { SchemaDecoder as S } from '@gamedevland/engine/validation';
+const configDecoder = S.object({});
+const inputDecoder = S.object({
+    duration: S.number({ min: 1, max: 2000 }),
+    delay: S.number({ min: 0, max: 1000 }),
+    offset: S.number({ min: 0, max: 16 }),
+    axis: S.optional(S.enumOf(['down', 'right', 'zoom'])),
+    pivotX: S.optional(S.number()),
+    pivotY: S.optional(S.number()),
+    closing: S.optional(S.boolean()),
+});
+/** Reveals a dedicated animation wrapper relative to its attached layout transform. */
+export class PanelReveal extends BaseTypedAction {
+    configDecoder = configDecoder;
+    inputDecoder = inputDecoder;
+    origin;
+    onInit() {
+        const { x, y, alpha, scale } = this.node.view;
+        this.origin = { x, y, alpha, scaleX: scale.x, scaleY: scale.y };
+    }
+    execute(input) {
+        this.killOwnedTweens();
+        const origin = this.getOrigin();
+        const shifted = PanelTransition.origin(input);
+        const x = origin.x + shifted.x * origin.scaleX;
+        const y = origin.y + shifted.y * origin.scaleY;
+        const scaleX = origin.scaleX * shifted.scaleX;
+        const scaleY = origin.scaleY * shifted.scaleY;
+        const alpha = origin.alpha * shifted.alpha;
+        const options = {
+            duration: input.duration / 1000,
+            delay: input.delay / 1000,
+            ease: input.closing ? 'power2.in' : 'power3.out',
+        };
+        if (input.closing) {
+            this.ownTween(this.node.tweens.to({ x, y, alpha }, options));
+            this.ownTween(this.node.tweens.scaleXY(scaleX, scaleY, options));
+            return;
+        }
+        this.node.setAlpha(alpha).setScale(scaleX, scaleY).setPosition(x, y);
+        this.ownTween(this.node.tweens.to({ alpha: origin.alpha, x: origin.x, y: origin.y }, options));
+        if (input.axis) {
+            this.ownTween(this.node.tweens.scaleXY(origin.scaleX, origin.scaleY, options));
+        }
+    }
+    onCancel() {
+        const origin = this.getOrigin();
+        this.node
+            .setAlpha(origin.alpha)
+            .setPosition(origin.x, origin.y)
+            .setScale(origin.scaleX, origin.scaleY);
+    }
+    getOrigin() {
+        if (!this.origin)
+            throw new Error('PanelReveal must be initialized before use');
+        return this.origin;
+    }
+}
+//# sourceMappingURL=PanelReveal.js.map

package/dist/PanelReveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelReveal.js","sourceRoot":"","sources":["../src/PanelReveal.ts"],"names":[],"mappings":"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","sourcesContent":["import { PanelTransition } from '@gamedevland/cyber-ui';\nimport { BaseTypedAction } from '@gamedevland/engine/layouts';\nimport { SchemaDecoder as S } from '@gamedevland/engine/validation';\n\nimport type { InferDecoded } from '@gamedevland/engine/validation';\n\ntype Transform = {\n  readonly x: number;\n  readonly y: number;\n  readonly scaleX: number;\n  readonly scaleY: number;\n  readonly alpha: number;\n};\n\nconst configDecoder = S.object({});\nconst inputDecoder = S.object({\n  duration: S.number({ min: 1, max: 2000 }),\n  delay: S.number({ min: 0, max: 1000 }),\n  offset: S.number({ min: 0, max: 16 }),\n  axis: S.optional(S.enumOf(['down', 'right', 'zoom'] as const)),\n  pivotX: S.optional(S.number()),\n  pivotY: S.optional(S.number()),\n  closing: S.optional(S.boolean()),\n});\n\n/** Reveals a dedicated animation wrapper relative to its attached layout transform. */\nexport class PanelReveal extends BaseTypedAction<\n  InferDecoded<typeof configDecoder>,\n  InferDecoded<typeof inputDecoder>\n> {\n  protected readonly configDecoder = configDecoder;\n  protected readonly inputDecoder = inputDecoder;\n  private origin?: Transform;\n\n  protected override onInit(): void {\n    const { x, y, alpha, scale } = this.node.view;\n    this.origin = { x, y, alpha, scaleX: scale.x, scaleY: scale.y };\n  }\n\n  protected execute(input: InferDecoded<typeof inputDecoder>): void {\n    this.killOwnedTweens();\n    const origin = this.getOrigin();\n    const shifted = PanelTransition.origin(input);\n    const x = origin.x + shifted.x * origin.scaleX;\n    const y = origin.y + shifted.y * origin.scaleY;\n    const scaleX = origin.scaleX * shifted.scaleX;\n    const scaleY = origin.scaleY * shifted.scaleY;\n    const alpha = origin.alpha * shifted.alpha;\n    const options = {\n      duration: input.duration / 1000,\n      delay: input.delay / 1000,\n      ease: input.closing ? 'power2.in' : 'power3.out',\n    };\n    if (input.closing) {\n      this.ownTween(this.node.tweens.to({ x, y, alpha }, options));\n      this.ownTween(this.node.tweens.scaleXY(scaleX, scaleY, options));\n      return;\n    }\n    this.node.setAlpha(alpha).setScale(scaleX, scaleY).setPosition(x, y);\n    this.ownTween(this.node.tweens.to({ alpha: origin.alpha, x: origin.x, y: origin.y }, options));\n    if (input.axis) {\n      this.ownTween(this.node.tweens.scaleXY(origin.scaleX, origin.scaleY, options));\n    }\n  }\n\n  protected override onCancel(): void {\n    const origin = this.getOrigin();\n    this.node\n      .setAlpha(origin.alpha)\n      .setPosition(origin.x, origin.y)\n      .setScale(origin.scaleX, origin.scaleY);\n  }\n\n  private getOrigin(): Transform {\n    if (!this.origin) throw new Error('PanelReveal must be initialized before use');\n    return this.origin;\n  }\n}\n"]}

package/dist/ToolkitComponent.d.ts

@@ -0,0 +1,22 @@
+import { BaseTypedComponent } from '@gamedevland/engine/layouts';
+import type { UiEffect } from '@gamedevland/cyber-ui';
+import type { NodeBase } from '@gamedevland/engine/layouts';
+export type UiViewport = {
+    readonly width: number;
+    readonly height: number;
+    readonly cssWidth: number;
+    readonly cssHeight: number;
+    readonly scale: number;
+};
+/** SDK owns scheduling and input; toolkit effects receive only their public host contracts. */
+export declare abstract class ToolkitComponent<TConfig, TNode extends NodeBase = NodeBase> extends BaseTypedComponent<TConfig, TNode> {
+    private readonly effects;
+    private reducedMotion;
+    protected get uiViewport(): UiViewport;
+    protected ownEffect<TEffect extends UiEffect>(effect: TEffect): TEffect;
+    protected setUiReducedMotion(reduced: boolean): void;
+    protected onUpdate(deltaSeconds: number): void;
+    protected onEnable(): void;
+    protected onDisable(): void;
+    onDetach(): void | Promise<void>;
+}

package/dist/ToolkitComponent.js

@@ -0,0 +1,46 @@
+import { BaseTypedComponent } from '@gamedevland/engine/layouts';
+/** SDK owns scheduling and input; toolkit effects receive only their public host contracts. */
+export class ToolkitComponent extends BaseTypedComponent {
+    effects = new Set();
+    reducedMotion = false;
+    get uiViewport() {
+        const virtual = this.node.screen.getVirtualSize();
+        const css = this.node.screen.getViewportSize();
+        return {
+            ...virtual,
+            cssWidth: css.width,
+            cssHeight: css.height,
+            scale: this.node.screen.getScale(),
+        };
+    }
+    ownEffect(effect) {
+        effect.setActive(this.enabled);
+        effect.setReducedMotion(this.reducedMotion);
+        this.effects.add(effect);
+        return effect;
+    }
+    setUiReducedMotion(reduced) {
+        this.reducedMotion = reduced;
+        for (const effect of this.effects)
+            effect.setReducedMotion(reduced);
+    }
+    onUpdate(deltaSeconds) {
+        for (const effect of this.effects)
+            effect.update(deltaSeconds);
+    }
+    onEnable() {
+        for (const effect of this.effects)
+            effect.setActive(true);
+    }
+    onDisable() {
+        for (const effect of this.effects)
+            effect.setActive(false);
+    }
+    onDetach() {
+        for (const effect of this.effects)
+            effect.dispose();
+        this.effects.clear();
+        return super.onDetach();
+    }
+}
+//# sourceMappingURL=ToolkitComponent.js.map

package/dist/ToolkitComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolkitComponent.js","sourceRoot":"","sources":["../src/ToolkitComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAajE,+FAA+F;AAC/F,MAAM,OAAgB,gBAGpB,SAAQ,kBAAkC;IACzB,OAAO,GAAG,IAAI,GAAG,EAAY,CAAC;IACvC,aAAa,GAAG,KAAK,CAAC;IAE9B,IAAc,UAAU;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC/C,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE,GAAG,CAAC,KAAK;YACnB,SAAS,EAAE,GAAG,CAAC,MAAM;YACrB,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;SACnC,CAAC;IACJ,CAAC;IAES,SAAS,CAA2B,MAAe;QAC3D,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,kBAAkB,CAAC,OAAgB;QAC3C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IAEkB,QAAQ,CAAC,YAAoB;QAC9C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACjE,CAAC;IAEkB,QAAQ;QACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAEkB,SAAS;QAC1B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEQ,QAAQ;QACf,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;CACF","sourcesContent":["import { BaseTypedComponent } from '@gamedevland/engine/layouts';\n\nimport type { UiEffect } from '@gamedevland/cyber-ui';\nimport type { NodeBase } from '@gamedevland/engine/layouts';\n\nexport type UiViewport = {\n  readonly width: number;\n  readonly height: number;\n  readonly cssWidth: number;\n  readonly cssHeight: number;\n  readonly scale: number;\n};\n\n/** SDK owns scheduling and input; toolkit effects receive only their public host contracts. */\nexport abstract class ToolkitComponent<\n  TConfig,\n  TNode extends NodeBase = NodeBase,\n> extends BaseTypedComponent<TConfig, TNode> {\n  private readonly effects = new Set<UiEffect>();\n  private reducedMotion = false;\n\n  protected get uiViewport(): UiViewport {\n    const virtual = this.node.screen.getVirtualSize();\n    const css = this.node.screen.getViewportSize();\n    return {\n      ...virtual,\n      cssWidth: css.width,\n      cssHeight: css.height,\n      scale: this.node.screen.getScale(),\n    };\n  }\n\n  protected ownEffect<TEffect extends UiEffect>(effect: TEffect): TEffect {\n    effect.setActive(this.enabled);\n    effect.setReducedMotion(this.reducedMotion);\n    this.effects.add(effect);\n    return effect;\n  }\n\n  protected setUiReducedMotion(reduced: boolean): void {\n    this.reducedMotion = reduced;\n    for (const effect of this.effects) effect.setReducedMotion(reduced);\n  }\n\n  protected override onUpdate(deltaSeconds: number): void {\n    for (const effect of this.effects) effect.update(deltaSeconds);\n  }\n\n  protected override onEnable(): void {\n    for (const effect of this.effects) effect.setActive(true);\n  }\n\n  protected override onDisable(): void {\n    for (const effect of this.effects) effect.setActive(false);\n  }\n\n  override onDetach(): void | Promise<void> {\n    for (const effect of this.effects) effect.dispose();\n    this.effects.clear();\n    return super.onDetach();\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ToolkitComponent } from './ToolkitComponent.js';
+export type { UiViewport } from './ToolkitComponent.js';
+export { PanelReveal } from './PanelReveal.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ToolkitComponent } from './ToolkitComponent.js';
+export { PanelReveal } from './PanelReveal.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,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export { ToolkitComponent } from './ToolkitComponent.js';\nexport type { UiViewport } from './ToolkitComponent.js';\nexport { PanelReveal } from './PanelReveal.js';\n"]}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@gamedevland/cyber-ui-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "GameDevLand SDK lifecycle and layout adapter for Cyber UI",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@gamedevland/cyber-ui": "^0.1.0",
+    "@gamedevland/engine": "0.0.11",
+    "pixi.js": ">=8.16.0 <9"
+  },
+  "author": "Gamedev Land",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gamedevland/cyber-ui-toolkit.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/gamedevland/cyber-ui-toolkit#readme",
+  "bugs": {
+    "url": "https://github.com/gamedevland/cyber-ui-toolkit/issues"
+  },
+  "keywords": [
+    "pixijs",
+    "cyberpunk",
+    "ui",
+    "gamedev",
+    "typescript"
+  ],
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}