@godot-scene-web/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tomás Fox
+
+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/dist/index.d.ts

@@ -0,0 +1,155 @@
+//#region src/index.d.ts
+type GodotDocumentKind = "scene" | "resource";
+/** Renderer-neutral 3×3 linear RGB transform. */
+type ColorMatrix = {
+  rows: readonly [readonly [number, number, number], readonly [number, number, number], readonly [number, number, number]];
+};
+interface GodotParseDiagnostic {
+  severity: "warning" | "error";
+  code: string;
+  message: string;
+  line?: number;
+  column?: number;
+}
+interface GodotResource {
+  type?: string;
+  header: GodotSectionHeader | null;
+  extResources: GodotExtResource[];
+  subResources: GodotSubResource[];
+  properties: Record<string, GodotVariant>;
+  diagnostics: GodotParseDiagnostic[];
+}
+interface GodotSceneState {
+  kind: "scene";
+  nodes: GodotSceneStateNode[];
+  connections: GodotSceneStateConnection[];
+  extResources: GodotExtResource[];
+  subResources: GodotSubResource[];
+  editableInstances: string[];
+  basePath?: string;
+  diagnostics: GodotParseDiagnostic[];
+}
+interface GodotSceneStateNode {
+  index: number;
+  siblingIndex?: number;
+  name: string;
+  type?: string;
+  parent?: string;
+  owner?: string;
+  instance?: GodotResourceRefValue;
+  instancePlaceholder?: string;
+  groups: string[];
+  properties: GodotOrderedProperty[];
+}
+interface GodotOrderedProperty {
+  name: string;
+  value: GodotVariant;
+}
+interface GodotSceneStateConnection {
+  signal?: string;
+  from?: string;
+  to?: string;
+  method?: string;
+  flags?: number;
+  binds?: GodotVariant[];
+  unbinds?: number;
+}
+interface GodotSectionHeader {
+  section: string;
+  attributes: Record<string, GodotVariant>;
+}
+interface GodotExtResource {
+  id: string;
+  type?: string;
+  path?: string;
+  uid?: string;
+  attributes: Record<string, GodotVariant>;
+  properties: Record<string, GodotVariant>;
+}
+interface GodotSubResource {
+  id: string;
+  type?: string;
+  attributes: Record<string, GodotVariant>;
+  properties: Record<string, GodotVariant>;
+}
+interface GodotNode {
+  name: string;
+  type?: string;
+  parent?: string;
+  instance?: GodotResourceRefValue;
+  attributes: Record<string, GodotVariant>;
+  properties: Record<string, GodotVariant>;
+  propertyEntries?: GodotOrderedProperty[];
+}
+interface GodotConnection {
+  signal?: string;
+  from?: string;
+  to?: string;
+  method?: string;
+  attributes: Record<string, GodotVariant>;
+}
+interface GodotEditable {
+  path?: string;
+  attributes: Record<string, GodotVariant>;
+}
+type GodotVariant = null | boolean | number | string | GodotStringNameVariant | GodotVectorVariant | GodotColorVariant | GodotRectVariant | GodotNodePathVariant | GodotResourceRefValue | GodotCallVariant | GodotVariant[] | {
+  [key: string]: GodotVariant;
+};
+interface GodotVectorVariant {
+  type: "Vector2" | "Vector2i" | "Vector3" | "Vector3i" | "Vector4" | "Vector4i";
+  args: number[];
+}
+interface GodotColorVariant {
+  type: "Color";
+  args: number[];
+}
+interface GodotStringNameVariant {
+  type: "StringName";
+  args: string[];
+}
+interface GodotRectVariant {
+  type: "Rect2" | "Rect2i";
+  args: number[];
+}
+interface GodotNodePathVariant {
+  type: "NodePath";
+  args: string[];
+}
+interface GodotResourceRefValue {
+  type: "ExtResource" | "SubResource";
+  id?: string;
+  path?: string;
+}
+interface GodotCallVariant {
+  type: string;
+  args: GodotVariant[];
+}
+interface GodotRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+declare function isColorValue(value: GodotVariant | undefined): value is GodotColorVariant;
+declare function isRectValue(value: GodotVariant | undefined): value is GodotRectVariant;
+declare function asNumber(value: GodotVariant | undefined): number | undefined;
+declare function asBoolean(value: GodotVariant | undefined): boolean | undefined;
+declare function asString(value: GodotVariant | undefined): string | undefined;
+declare function asVector2(value: GodotVariant | undefined): {
+  x: number;
+  y: number;
+} | undefined;
+declare function asRect2(value: GodotVariant | undefined): {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+} | undefined;
+declare function asResourceRef(value: GodotVariant | undefined): GodotResourceRefValue | undefined;
+declare function decodeFromNativeValue(value: GodotVariant): GodotVariant;
+declare function isGodotSceneState(value: unknown): value is GodotSceneState;
+declare function godotNodePath(node: GodotNode): string;
+declare function godotParentPath(node: GodotNode): string | null;
+//#endregion
+export { ColorMatrix, GodotCallVariant, GodotColorVariant, GodotConnection, GodotDocumentKind, GodotEditable, GodotExtResource, GodotNode, GodotNodePathVariant, GodotOrderedProperty, GodotParseDiagnostic, GodotRect, GodotRectVariant, GodotResource, GodotResourceRefValue, GodotSceneState, GodotSceneStateConnection, GodotSceneStateNode, GodotSectionHeader, GodotStringNameVariant, GodotSubResource, GodotVariant, GodotVectorVariant, asBoolean, asNumber, asRect2, asResourceRef, asString, asVector2, decodeFromNativeValue, godotNodePath, godotParentPath, isColorValue, isGodotSceneState, isRectValue };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,110 @@
+//#region src/index.ts
+function isColorValue(value) {
+	return isObject(value) && value.type === "Color" && Array.isArray(value.args);
+}
+function isRectValue(value) {
+	return isObject(value) && (value.type === "Rect2" || value.type === "Rect2i") && Array.isArray(value.args);
+}
+function asNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function asBoolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+function asString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function asVector2(value) {
+	if (!isObject(value) || value.type !== "Vector2" && value.type !== "Vector2i" || !Array.isArray(value.args)) return;
+	const [x, y] = value.args;
+	return typeof x === "number" && typeof y === "number" && Number.isFinite(x) && Number.isFinite(y) ? {
+		x,
+		y
+	} : void 0;
+}
+function asRect2(value) {
+	if (!isRectValue(value)) return;
+	const [x, y, width, height] = value.args;
+	return typeof x === "number" && typeof y === "number" && typeof width === "number" && typeof height === "number" && Number.isFinite(x) && Number.isFinite(y) && Number.isFinite(width) && Number.isFinite(height) ? {
+		x,
+		y,
+		width,
+		height
+	} : void 0;
+}
+function asResourceRef(value) {
+	if (!isObject(value) || value.type !== "ExtResource" && value.type !== "SubResource") return;
+	const id = typeof value.id === "string" ? value.id : void 0;
+	const path = typeof value.path === "string" ? value.path : void 0;
+	if (id === void 0 && path === void 0) return;
+	return {
+		type: value.type,
+		...id !== void 0 ? { id } : {},
+		...path !== void 0 ? { path } : {}
+	};
+}
+function decodeFromNativeValue(value) {
+	if (typeof value === "string") return decodeFromNativeScalar(value);
+	if (Array.isArray(value)) return value.map(decodeFromNativeValue);
+	if (isObject(value)) {
+		const type = typeof value.type === "string" ? value.type : void 0;
+		if (type === "Array" || type === "Dictionary") return Array.isArray(value.args) ? {
+			...value,
+			args: value.args.map(decodeFromNativeValue)
+		} : value;
+		if (type !== void 0) return value;
+		const decoded = {};
+		for (const [key, entry] of Object.entries(value)) decoded[key] = decodeFromNativeValue(entry);
+		return decoded;
+	}
+	return value;
+}
+function decodeFromNativeScalar(value) {
+	if (value.startsWith("i:")) {
+		const parsed = Number.parseInt(value.slice(2), 10);
+		return Number.isNaN(parsed) ? value : parsed;
+	}
+	if (value.startsWith("f:")) {
+		const parsed = decodeFromNativeFloat(value.slice(2));
+		return parsed === void 0 ? value : parsed;
+	}
+	if (value.startsWith("s:")) return value.slice(2);
+	if (value.startsWith("sn:")) return value.slice(3);
+	if (value.startsWith("np:")) return {
+		type: "NodePath",
+		args: [value.slice(3)]
+	};
+	return value;
+}
+function decodeFromNativeFloat(text) {
+	switch (text) {
+		case "inf": return Infinity;
+		case "-inf": return -Infinity;
+		case "nan": return NaN;
+		default: {
+			const parsed = Number.parseFloat(text);
+			return Number.isNaN(parsed) ? void 0 : parsed;
+		}
+	}
+}
+function isGodotSceneState(value) {
+	if (!isObject(value) || value.kind !== "scene") return false;
+	return Array.isArray(value.nodes) && value.nodes.every(isGodotSceneStateNode) && Array.isArray(value.connections) && Array.isArray(value.extResources) && Array.isArray(value.subResources) && Array.isArray(value.diagnostics);
+}
+function godotNodePath(node) {
+	if (!node.parent || node.parent === ".") return node.name;
+	return `${node.parent}/${node.name}`;
+}
+function godotParentPath(node) {
+	return node.parent ?? null;
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null;
+}
+function isGodotSceneStateNode(value) {
+	return isObject(value) && typeof value.index === "number" && (value.siblingIndex === void 0 || typeof value.siblingIndex === "number") && typeof value.name === "string" && Array.isArray(value.groups) && Array.isArray(value.properties);
+}
+//#endregion
+export { asBoolean, asNumber, asRect2, asResourceRef, asString, asVector2, decodeFromNativeValue, godotNodePath, godotParentPath, isColorValue, isGodotSceneState, isRectValue };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type GodotDocumentKind = \"scene\" | \"resource\";\n\n/** Renderer-neutral 3×3 linear RGB transform. */\nexport type ColorMatrix = {\n  rows: readonly [\n    readonly [number, number, number],\n    readonly [number, number, number],\n    readonly [number, number, number],\n  ];\n};\n\nexport interface GodotParseDiagnostic {\n  severity: \"warning\" | \"error\";\n  code: string;\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface GodotResource {\n  type?: string;\n  header: GodotSectionHeader | null;\n  extResources: GodotExtResource[];\n  subResources: GodotSubResource[];\n  properties: Record<string, GodotVariant>;\n  diagnostics: GodotParseDiagnostic[];\n}\n\nexport interface GodotSceneState {\n  kind: \"scene\";\n  nodes: GodotSceneStateNode[];\n  connections: GodotSceneStateConnection[];\n  extResources: GodotExtResource[];\n  subResources: GodotSubResource[];\n  editableInstances: string[];\n  basePath?: string;\n  diagnostics: GodotParseDiagnostic[];\n}\n\nexport interface GodotSceneStateNode {\n  index: number;\n  siblingIndex?: number;\n  name: string;\n  type?: string;\n  parent?: string;\n  owner?: string;\n  instance?: GodotResourceRefValue;\n  instancePlaceholder?: string;\n  groups: string[];\n  properties: GodotOrderedProperty[];\n}\n\nexport interface GodotOrderedProperty {\n  name: string;\n  value: GodotVariant;\n}\n\nexport interface GodotSceneStateConnection {\n  signal?: string;\n  from?: string;\n  to?: string;\n  method?: string;\n  flags?: number;\n  binds?: GodotVariant[];\n  unbinds?: number;\n}\n\nexport interface GodotSectionHeader {\n  section: string;\n  attributes: Record<string, GodotVariant>;\n}\n\nexport interface GodotExtResource {\n  id: string;\n  type?: string;\n  path?: string;\n  uid?: string;\n  attributes: Record<string, GodotVariant>;\n  properties: Record<string, GodotVariant>;\n}\n\nexport interface GodotSubResource {\n  id: string;\n  type?: string;\n  attributes: Record<string, GodotVariant>;\n  properties: Record<string, GodotVariant>;\n}\n\nexport interface GodotNode {\n  name: string;\n  type?: string;\n  parent?: string;\n  instance?: GodotResourceRefValue;\n  attributes: Record<string, GodotVariant>;\n  properties: Record<string, GodotVariant>;\n  propertyEntries?: GodotOrderedProperty[];\n}\n\nexport interface GodotConnection {\n  signal?: string;\n  from?: string;\n  to?: string;\n  method?: string;\n  attributes: Record<string, GodotVariant>;\n}\n\nexport interface GodotEditable {\n  path?: string;\n  attributes: Record<string, GodotVariant>;\n}\n\n// Canonical Variant value contract — what every consumer (the `layout`/`html`\n// interpreters and the `as*` accessors below) reads, and what the text parser's\n// `callValue` emits:\n//   - scalars are raw JS primitives: `null`, `boolean`, `number`, `string`;\n//   - engine math types use `{ type, args }`, where `type` is the Godot\n//     constructor name (`Vector2`, `Color`, `Rect2`, `Transform2D`, …) and\n//     `args` are its positional components;\n//   - resource refs use `{ type:\"ExtResource\"|\"SubResource\", id|path }`.\n// A live producer may instead emit Godot's `JSON.from_native` output, which\n// tags basic scalars as strings (`i:`/`f:`/`s:`/`sn:`/`np:`). That tagged shape\n// is decoded back to this canonical contract at the JSON-ingest boundary when\n// the document opts in with `valueEncoding:\"from_native\"` — see\n// `decodeFromNativeValue`. The accessors themselves stay raw-only: they are\n// shared with the text path, where a literal string like `\"f:stop\"` is real.\nexport type GodotVariant =\n  | null\n  | boolean\n  | number\n  | string\n  | GodotStringNameVariant\n  | GodotVectorVariant\n  | GodotColorVariant\n  | GodotRectVariant\n  | GodotNodePathVariant\n  | GodotResourceRefValue\n  | GodotCallVariant\n  | GodotVariant[]\n  | { [key: string]: GodotVariant };\n\nexport interface GodotVectorVariant {\n  type:\n    | \"Vector2\"\n    | \"Vector2i\"\n    | \"Vector3\"\n    | \"Vector3i\"\n    | \"Vector4\"\n    | \"Vector4i\";\n  args: number[];\n}\n\nexport interface GodotColorVariant {\n  type: \"Color\";\n  args: number[];\n}\n\nexport interface GodotStringNameVariant {\n  type: \"StringName\";\n  args: string[];\n}\n\nexport interface GodotRectVariant {\n  type: \"Rect2\" | \"Rect2i\";\n  args: number[];\n}\n\nexport interface GodotNodePathVariant {\n  type: \"NodePath\";\n  args: string[];\n}\n\n// A reference into a scene's ext/sub resource table. This is gsw's own\n// scene-file concept (not a Godot Variant), so it stays path/id-keyed rather\n// than `args`-based. Text producers emit a scene-local `id`; runtime producers\n// (which hold loaded `Resource` objects) emit a `res://` `path`. Resolution is\n// path-first, id-fallback — both are first-class.\nexport interface GodotResourceRefValue {\n  type: \"ExtResource\" | \"SubResource\";\n  id?: string;\n  path?: string;\n}\n\n// Any other constructor-style Variant (`Type(args...)`), e.g. PackedVector2Array\n// or Transform2D. The former `Call` kind folded into this uniform shape: the\n// constructor name lives in `type`.\nexport interface GodotCallVariant {\n  type: string;\n  args: GodotVariant[];\n}\n\nexport interface GodotRect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport function isColorValue(\n  value: GodotVariant | undefined,\n): value is GodotColorVariant {\n  return isObject(value) && value.type === \"Color\" && Array.isArray(value.args);\n}\n\nexport function isRectValue(\n  value: GodotVariant | undefined,\n): value is GodotRectVariant {\n  return (\n    isObject(value) &&\n    (value.type === \"Rect2\" || value.type === \"Rect2i\") &&\n    Array.isArray(value.args)\n  );\n}\n\nexport function asNumber(value: GodotVariant | undefined): number | undefined {\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? value\n    : undefined;\n}\n\nexport function asBoolean(\n  value: GodotVariant | undefined,\n): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nexport function asString(value: GodotVariant | undefined): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\nexport function asVector2(\n  value: GodotVariant | undefined,\n): { x: number; y: number } | undefined {\n  if (\n    !isObject(value) ||\n    (value.type !== \"Vector2\" && value.type !== \"Vector2i\") ||\n    !Array.isArray(value.args)\n  ) {\n    return undefined;\n  }\n  const [x, y] = value.args as unknown[];\n  return typeof x === \"number\" &&\n    typeof y === \"number\" &&\n    Number.isFinite(x) &&\n    Number.isFinite(y)\n    ? { x, y }\n    : undefined;\n}\n\nexport function asRect2(\n  value: GodotVariant | undefined,\n): { x: number; y: number; width: number; height: number } | undefined {\n  if (!isRectValue(value)) {\n    return undefined;\n  }\n  const [x, y, width, height] = value.args as unknown[];\n  return typeof x === \"number\" &&\n    typeof y === \"number\" &&\n    typeof width === \"number\" &&\n    typeof height === \"number\" &&\n    Number.isFinite(x) &&\n    Number.isFinite(y) &&\n    Number.isFinite(width) &&\n    Number.isFinite(height)\n    ? { x, y, width, height }\n    : undefined;\n}\n\nexport function asResourceRef(\n  value: GodotVariant | undefined,\n): GodotResourceRefValue | undefined {\n  if (\n    !isObject(value) ||\n    (value.type !== \"ExtResource\" && value.type !== \"SubResource\")\n  ) {\n    return undefined;\n  }\n  const id = typeof value.id === \"string\" ? value.id : undefined;\n  const path = typeof value.path === \"string\" ? value.path : undefined;\n  if (id === undefined && path === undefined) {\n    return undefined;\n  }\n  return {\n    type: value.type,\n    ...(id !== undefined ? { id } : {}),\n    ...(path !== undefined ? { path } : {}),\n  };\n}\n\n// Decode a value produced by Godot's `JSON.from_native` into gsw's canonical\n// Variant contract (see the `GodotVariant` note above). `from_native` tags basic\n// scalars as strings — `i:`/`f:` (int/float), `s:`/`sn:` (String/StringName),\n// `np:` (NodePath) — and passes `null`/`bool` through; math types already arrive\n// as `{ type, args }`. This inverts the scalar tags, recursing through untyped\n// arrays and `Array`/`Dictionary` wrappers (whose elements `from_native` also\n// tags) while leaving every other `{ type, args }` wrapper — math types, packed\n// arrays (raw `args`), resource refs — and untagged strings untouched. Intended\n// only for the JSON-ingest boundary on `valueEncoding:\"from_native\"` documents;\n// never run it on text-parsed values, where a literal `\"i:3\"` is a real string.\nexport function decodeFromNativeValue(value: GodotVariant): GodotVariant {\n  if (typeof value === \"string\") {\n    return decodeFromNativeScalar(value);\n  }\n  if (Array.isArray(value)) {\n    // Untyped `from_native` arrays arrive as bare JSON arrays of tagged elements.\n    return value.map(decodeFromNativeValue);\n  }\n  if (isObject(value)) {\n    const type = typeof value.type === \"string\" ? value.type : undefined;\n    // Only `Array`/`Dictionary` wrappers tag their `args`; every other wrapper\n    // (`Vector*`, `Color`, packed arrays, resource refs, …) carries canonical or\n    // deliberately-raw `args` that must not be re-decoded.\n    if (type === \"Array\" || type === \"Dictionary\") {\n      return Array.isArray(value.args)\n        ? { ...value, args: value.args.map(decodeFromNativeValue) }\n        : (value as GodotVariant);\n    }\n    if (type !== undefined) {\n      return value as GodotVariant;\n    }\n    // A bare object/dictionary map (no recognized variant `type`): decode each\n    // value position.\n    const decoded: Record<string, GodotVariant> = {};\n    for (const [key, entry] of Object.entries(value)) {\n      decoded[key] = decodeFromNativeValue(entry as GodotVariant);\n    }\n    return decoded;\n  }\n  return value;\n}\n\nfunction decodeFromNativeScalar(value: string): GodotVariant {\n  if (value.startsWith(\"i:\")) {\n    const parsed = Number.parseInt(value.slice(2), 10);\n    return Number.isNaN(parsed) ? value : parsed;\n  }\n  if (value.startsWith(\"f:\")) {\n    const parsed = decodeFromNativeFloat(value.slice(2));\n    return parsed === undefined ? value : parsed;\n  }\n  if (value.startsWith(\"s:\")) {\n    return value.slice(2);\n  }\n  if (value.startsWith(\"sn:\")) {\n    return value.slice(3);\n  }\n  if (value.startsWith(\"np:\")) {\n    return { type: \"NodePath\", args: [value.slice(3)] };\n  }\n  return value;\n}\n\nfunction decodeFromNativeFloat(text: string): number | undefined {\n  // `from_native` prints floats via Godot's `String(float)`: finite values, plus\n  // `inf` / `-inf` / `nan` for the non-finite ones. `undefined` signals an\n  // unparseable tag so the caller can keep the original string verbatim.\n  switch (text) {\n    case \"inf\":\n      return Infinity;\n    case \"-inf\":\n      return -Infinity;\n    case \"nan\":\n      return Number.NaN;\n    default: {\n      const parsed = Number.parseFloat(text);\n      return Number.isNaN(parsed) ? undefined : parsed;\n    }\n  }\n}\n\nexport function isGodotSceneState(value: unknown): value is GodotSceneState {\n  if (!isObject(value) || value.kind !== \"scene\") {\n    return false;\n  }\n  return (\n    Array.isArray(value.nodes) &&\n    value.nodes.every(isGodotSceneStateNode) &&\n    Array.isArray(value.connections) &&\n    Array.isArray(value.extResources) &&\n    Array.isArray(value.subResources) &&\n    Array.isArray(value.diagnostics)\n  );\n}\n\nexport function godotNodePath(node: GodotNode): string {\n  if (!node.parent || node.parent === \".\") {\n    return node.name;\n  }\n  return `${node.parent}/${node.name}`;\n}\n\nexport function godotParentPath(node: GodotNode): string | null {\n  return node.parent ?? null;\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isGodotSceneStateNode(value: unknown): value is GodotSceneStateNode {\n  return (\n    isObject(value) &&\n    typeof value.index === \"number\" &&\n    (value.siblingIndex === undefined ||\n      typeof value.siblingIndex === \"number\") &&\n    typeof value.name === \"string\" &&\n    Array.isArray(value.groups) &&\n    Array.isArray(value.properties)\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@godot-scene-web/core",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Shared Godot-like AST types and value helpers for godot-scene-web.",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tfoxy/godot-scene-web.git"
+  },
+  "homepage": "https://github.com/tfoxy/godot-scene-web#readme",
+  "bugs": {
+    "url": "https://github.com/tfoxy/godot-scene-web/issues"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --root ../.. --config ../../vitest.config.ts packages/core/test"
+  }
+}