@runek/core 0.6.0 → 0.10.0

package/dist/index.js

@@ -1,6 +1,13 @@
 // src/context.ts
 import { createContext } from "react";
 
+// src/font.ts
+var DEFAULT_FONT = "data:font/woff2;base64,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";
+var DEFAULT_FONTS = {
+  display: DEFAULT_FONT,
+  body: DEFAULT_FONT
+};
+
 // src/palette.ts
 var DEFAULT_PALETTE = {
   wood: "#6b4f3a",
@@ -20,13 +27,101 @@ var DEFAULT_PALETTE = {
   waterShallow: "#3f86a8"
 };
 
+// src/time.ts
+var DEFAULT_WORLD_TIME = { hours: 12, live: false };
+function parseClockTime(value) {
+  const match = /^(\d{1,2}):(\d{2})$/.exec(value.trim());
+  if (!match) return null;
+  const h = Number(match[1]);
+  const m = Number(match[2]);
+  if (h < 0 || h > 23 || m < 0 || m > 59) return null;
+  return h + m / 60;
+}
+function clockHours(timezone) {
+  const now = /* @__PURE__ */ new Date();
+  if (timezone) {
+    try {
+      const parts = new Intl.DateTimeFormat("en-GB", {
+        timeZone: timezone,
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false
+      }).formatToParts(now);
+      const get = (type) => Number(parts.find((p) => p.type === type)?.value);
+      const h2 = get("hour") % 24;
+      const m2 = get("minute");
+      if (Number.isFinite(h2) && Number.isFinite(m2)) return h2 + m2 / 60;
+    } catch {
+    }
+    return now.getUTCHours() + now.getUTCMinutes() / 60;
+  }
+  const h = now.getHours();
+  const m = now.getMinutes();
+  if (Number.isFinite(h) && Number.isFinite(m)) return h + m / 60;
+  return now.getUTCHours() + now.getUTCMinutes() / 60;
+}
+function resolveWorldTime(opts) {
+  if (opts.time !== void 0) {
+    const hours = parseClockTime(opts.time);
+    if (hours !== null) return { hours, live: false, timezone: opts.timezone };
+  }
+  return { hours: clockHours(opts.timezone), live: true, timezone: opts.timezone };
+}
+function currentHours(time) {
+  return time.live ? clockHours(time.timezone) : time.hours;
+}
+function sunState(hours, radius = 100) {
+  const theta = (hours - 6) / 12 * Math.PI;
+  const sinEl = Math.sin(theta);
+  const elevation = Math.max(0, sinEl);
+  const x = Math.cos(theta);
+  const y = sinEl;
+  const z = 0.3;
+  const len = Math.hypot(x, y, z) || 1;
+  return {
+    position: [x / len * radius, y / len * radius, z / len * radius],
+    elevation,
+    day: sinEl > 0
+  };
+}
+
 // src/context.ts
 var WorldContext = createContext({
   unit: 1,
   gravity: [0, -9.81, 0],
-  palette: DEFAULT_PALETTE
+  ground: 0,
+  palette: DEFAULT_PALETTE,
+  fonts: DEFAULT_FONTS,
+  time: DEFAULT_WORLD_TIME
 });
 
+// src/contribute.ts
+function parseGitHubSource(source) {
+  if (!source?.url) return null;
+  let url;
+  try {
+    url = new URL(source.url);
+  } catch {
+    return null;
+  }
+  if (url.hostname !== "github.com" && url.hostname !== "www.github.com") return null;
+  const parts = url.pathname.split("/").filter(Boolean);
+  if (parts.length < 2) return null;
+  return {
+    owner: parts[0],
+    repo: parts[1].replace(/\.git$/, ""),
+    branch: source.branch?.trim() || "main",
+    path: source.path?.trim() || void 0
+  };
+}
+function forkUrl(gh) {
+  return `https://github.com/${gh.owner}/${gh.repo}/fork`;
+}
+function editFileUrl(gh) {
+  if (!gh.path) return null;
+  return `https://github.com/${gh.owner}/${gh.repo}/edit/${gh.branch}/${gh.path}`;
+}
+
 // src/keyboard.ts
 var keyboardMap = [
   { name: "forward", keys: ["ArrowUp", "KeyW"] },
@@ -64,50 +159,240 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function World({
   unit = 1,
   gravity = [0, -9.81, 0],
+  ground = 0,
   keyboardMap: keyboardMap2 = keyboardMap,
   lights = true,
   palette,
+  fonts,
   fog,
+  time,
+  timezone,
+  avatar,
   onPointerMissed,
+  preserveDrawingBuffer = false,
   debug = false,
   children
 }) {
   const context = useMemo(
-    () => ({ unit, gravity, palette: { ...DEFAULT_PALETTE, ...palette } }),
-    [unit, gravity, palette]
+    () => ({
+      unit,
+      gravity,
+      ground,
+      palette: { ...DEFAULT_PALETTE, ...palette },
+      fonts: { ...DEFAULT_FONTS, ...fonts },
+      time: resolveWorldTime({ time, timezone }),
+      avatar
+    }),
+    [unit, gravity, ground, palette, fonts, time, timezone, avatar]
   );
-  return /* @__PURE__ */ jsx(KeyboardControls, { map: keyboardMap2, children: /* @__PURE__ */ jsx(Canvas, { shadows: true, camera: { position: [6, 4, 6], fov: 60 }, onPointerMissed, children: /* @__PURE__ */ jsxs(WorldContext.Provider, { value: context, children: [
-    fog && /* @__PURE__ */ jsx("fog", { attach: "fog", args: [fog.color, fog.near * unit, fog.far * unit] }),
-    lights && /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx("ambientLight", { intensity: 0.6 }),
-      /* @__PURE__ */ jsx(
-        "directionalLight",
-        {
-          position: [12, 18, 8],
-          intensity: 1.6,
-          castShadow: true,
-          "shadow-mapSize": [2048, 2048],
-          "shadow-camera-near": 1,
-          "shadow-camera-far": 60,
-          "shadow-camera-left": -25,
-          "shadow-camera-right": 25,
-          "shadow-camera-top": 25,
-          "shadow-camera-bottom": -25
-        }
-      )
-    ] }),
-    /* @__PURE__ */ jsx(Physics, { gravity, debug, children })
-  ] }) }) });
+  return /* @__PURE__ */ jsx(KeyboardControls, { map: keyboardMap2, children: /* @__PURE__ */ jsx(
+    Canvas,
+    {
+      shadows: true,
+      camera: { position: [6, 4, 6], fov: 60 },
+      gl: { preserveDrawingBuffer },
+      onPointerMissed,
+      children: /* @__PURE__ */ jsxs(WorldContext.Provider, { value: context, children: [
+        fog && /* @__PURE__ */ jsx("fog", { attach: "fog", args: [fog.color, fog.near * unit, fog.far * unit] }),
+        lights && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx("ambientLight", { intensity: 0.6 }),
+          /* @__PURE__ */ jsx(
+            "directionalLight",
+            {
+              position: [12, 18, 8],
+              intensity: 1.6,
+              castShadow: true,
+              "shadow-mapSize": [2048, 2048],
+              "shadow-camera-near": 1,
+              "shadow-camera-far": 60,
+              "shadow-camera-left": -25,
+              "shadow-camera-right": 25,
+              "shadow-camera-top": 25,
+              "shadow-camera-bottom": -25
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx(Physics, { gravity, debug, children })
+      ] })
+    }
+  ) });
 }
 
-// src/WorldEditor.tsx
-import { OrbitControls, TransformControls } from "@react-three/drei";
-import { Leva, useControls } from "leva";
-import { useEffect, useRef, useState } from "react";
+// src/WorldAbout.tsx
+import { useEffect, useState } from "react";
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function WorldAbout({ meta }) {
+  const [open, setOpen] = useState(false);
+  useEffect(() => {
+    if (!open) return;
+    const onKey = (event) => {
+      if (event.key === "Escape") setOpen(false);
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [open]);
+  const title = meta?.title?.trim() || "Untitled world";
+  const authors = meta?.authors ?? [];
+  const source = meta?.source;
+  return /* @__PURE__ */ jsxs2(Fragment2, { children: [
+    /* @__PURE__ */ jsx2(
+      "button",
+      {
+        type: "button",
+        style: INFO_BTN,
+        onClick: () => setOpen(true),
+        title: "About this world",
+        "aria-label": "About this world",
+        children: "\u24D8"
+      }
+    ),
+    open && /* @__PURE__ */ jsxs2("div", { style: OVERLAY, role: "dialog", "aria-modal": "true", "aria-label": "About this world", children: [
+      /* @__PURE__ */ jsx2("button", { type: "button", style: SCRIM, "aria-label": "Close", onClick: () => setOpen(false) }),
+      /* @__PURE__ */ jsxs2("div", { style: CARD, children: [
+        /* @__PURE__ */ jsx2("button", { type: "button", style: CLOSE, onClick: () => setOpen(false), "aria-label": "Close", children: "\xD7" }),
+        /* @__PURE__ */ jsx2("h2", { style: TITLE, children: title }),
+        meta?.description && /* @__PURE__ */ jsx2("p", { style: DESC, children: meta.description }),
+        authors.length > 0 && /* @__PURE__ */ jsxs2("p", { style: ROW, children: [
+          /* @__PURE__ */ jsx2("span", { style: LABEL, children: "by " }),
+          authors.map((author, index) => /* @__PURE__ */ jsxs2("span", { children: [
+            index > 0 && ", ",
+            author.url ? /* @__PURE__ */ jsx2("a", { style: LINK, href: author.url, target: "_blank", rel: "noreferrer", children: author.name }) : author.name
+          ] }, `${author.name}-${index}`))
+        ] }),
+        meta?.license && /* @__PURE__ */ jsxs2("p", { style: ROW, children: [
+          /* @__PURE__ */ jsx2("span", { style: LABEL, children: "license " }),
+          meta.license
+        ] }),
+        source?.url && /* @__PURE__ */ jsx2("p", { style: ROW, children: /* @__PURE__ */ jsx2("a", { style: LINK, href: source.url, target: "_blank", rel: "noreferrer", children: "View source repository \u2197" }) }),
+        /* @__PURE__ */ jsx2("p", { style: BUILT, children: /* @__PURE__ */ jsx2(
+          "a",
+          {
+            style: BUILT_LINK,
+            href: "https://runek.nullorder.org",
+            target: "_blank",
+            rel: "noreferrer",
+            children: "Built with Runek"
+          }
+        ) })
+      ] })
+    ] })
+  ] });
+}
+var MONO = "ui-monospace, SF Mono, Menlo, monospace";
+var PANEL_BG = "rgba(7, 11, 17, 0.95)";
+var BORDER = "#15202a";
+var INFO_BTN = {
+  position: "fixed",
+  top: "1rem",
+  right: "1rem",
+  zIndex: 10,
+  width: 32,
+  height: 32,
+  borderRadius: "50%",
+  border: `1px solid ${BORDER}`,
+  background: "rgba(7, 11, 17, 0.82)",
+  color: "#cfe6db",
+  backdropFilter: "blur(8px)",
+  cursor: "pointer",
+  fontSize: "0.95rem",
+  lineHeight: 1,
+  fontFamily: MONO
+};
+var OVERLAY = {
+  position: "fixed",
+  inset: 0,
+  zIndex: 20,
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+  padding: "1rem"
+};
+var SCRIM = {
+  position: "absolute",
+  inset: 0,
+  border: "none",
+  padding: 0,
+  margin: 0,
+  background: "rgba(3, 5, 10, 0.6)",
+  backdropFilter: "blur(2px)",
+  cursor: "default"
+};
+var CARD = {
+  position: "relative",
+  zIndex: 1,
+  width: "100%",
+  maxWidth: 420,
+  padding: "1.5rem 1.6rem",
+  borderRadius: 12,
+  background: PANEL_BG,
+  border: `1px solid ${BORDER}`,
+  color: "#cfe6db",
+  fontFamily: MONO,
+  boxShadow: "0 20px 60px rgba(0, 0, 0, 0.5)"
+};
+var CLOSE = {
+  position: "absolute",
+  top: "0.7rem",
+  right: "0.8rem",
+  border: "none",
+  background: "transparent",
+  color: "#5f7d75",
+  cursor: "pointer",
+  fontSize: "1.1rem",
+  lineHeight: 1,
+  fontFamily: MONO
+};
+var TITLE = {
+  margin: "0 0 0.5rem",
+  fontSize: "1.15rem",
+  fontWeight: 600,
+  color: "#3df58a"
+};
+var DESC = {
+  margin: "0 0 0.9rem",
+  fontSize: "0.85rem",
+  lineHeight: 1.5
+};
+var ROW = {
+  margin: "0 0 0.4rem",
+  fontSize: "0.8rem"
+};
+var LABEL = { color: "#5f7d75" };
+var LINK = { color: "#2aa7ff", textDecoration: "none" };
+var BUILT = {
+  margin: "1.1rem 0 0",
+  paddingTop: "0.8rem",
+  borderTop: `1px solid ${BORDER}`,
+  fontSize: "0.72rem",
+  color: "#5f7d75"
+};
+var BUILT_LINK = { color: "#5f7d75", textDecoration: "none" };
+
+// src/WorldContribute.tsx
+import { useEffect as useEffect2 } from "react";
 
 // src/world-data.ts
+function normalizeNode(node) {
+  const out = { type: node.type };
+  if (node.id !== void 0) out.id = node.id;
+  if (node.props !== void 0) out.props = node.props;
+  if (node.children !== void 0) out.children = node.children.map(normalizeNode);
+  return out;
+}
 function serializeWorld(data) {
-  return `${JSON.stringify(data, null, 2)}
+  const out = { version: data.version };
+  if (data.meta !== void 0) out.meta = data.meta;
+  if (data.unit !== void 0) out.unit = data.unit;
+  if (data.gravity !== void 0) out.gravity = data.gravity;
+  if (data.ground !== void 0) out.ground = data.ground;
+  if (data.time !== void 0) out.time = data.time;
+  if (data.timezone !== void 0) out.timezone = data.timezone;
+  if (data.avatar !== void 0) out.avatar = data.avatar;
+  if (data.palette !== void 0) out.palette = data.palette;
+  if (data.fonts !== void 0) out.fonts = data.fonts;
+  if (data.fog !== void 0) out.fog = data.fog;
+  out.nodes = data.nodes.map(normalizeNode);
+  return `${JSON.stringify(out, null, 2)}
 `;
 }
 function parseWorld(json) {
@@ -120,23 +405,316 @@ function parseWorld(json) {
   if (!Array.isArray(data.nodes)) {
     throw new Error('World data must have a "nodes" array');
   }
+  if (data.meta !== void 0) {
+    const meta = data.meta;
+    if (typeof meta !== "object" || meta === null || Array.isArray(meta)) {
+      throw new Error('World "meta" must be an object');
+    }
+    if (meta.authors !== void 0 && !Array.isArray(meta.authors)) {
+      throw new Error('World "meta.authors" must be an array');
+    }
+  }
+  if (data.time !== void 0 && typeof data.time !== "string") {
+    throw new Error('World "time" must be an "HH:MM" string');
+  }
+  if (data.timezone !== void 0 && typeof data.timezone !== "string") {
+    throw new Error('World "timezone" must be a string');
+  }
+  if (data.avatar !== void 0 && data.avatar !== "first" && data.avatar !== "third") {
+    throw new Error('World "avatar" must be "first" or "third"');
+  }
+  if (data.ground !== void 0 && typeof data.ground !== "number") {
+    throw new Error('World "ground" must be a number');
+  }
+  if (data.fonts !== void 0) {
+    const fonts = data.fonts;
+    if (typeof fonts !== "object" || fonts === null || Array.isArray(fonts)) {
+      throw new Error('World "fonts" must be an object of role to font URL');
+    }
+    for (const value of Object.values(fonts)) {
+      if (typeof value !== "string") {
+        throw new Error('World "fonts" values must be font URL strings');
+      }
+    }
+  }
   return data;
 }
+function collectIds(nodes, into) {
+  for (const node of nodes) {
+    if (node.id) into.add(node.id);
+    if (node.children) collectIds(node.children, into);
+  }
+}
+function makeNodeId(taken) {
+  let id;
+  do {
+    id = `n${Math.random().toString(36).slice(2, 8)}`;
+  } while (taken.has(id));
+  taken.add(id);
+  return id;
+}
+function withIds(nodes, taken) {
+  return nodes.map((node) => ({
+    ...node,
+    id: node.id ?? makeNodeId(taken),
+    ...node.children ? { children: withIds(node.children, taken) } : {}
+  }));
+}
+function assignNodeIds(data) {
+  const taken = /* @__PURE__ */ new Set();
+  collectIds(data.nodes, taken);
+  return { ...data, nodes: withIds(data.nodes, taken) };
+}
+
+// src/WorldContribute.tsx
+import { Fragment as Fragment3, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function downloadHref(href, filename) {
+  const a = document.createElement("a");
+  a.href = href;
+  a.download = filename;
+  a.click();
+}
+function downloadText(text, filename) {
+  const url = URL.createObjectURL(new Blob([text], { type: "application/json" }));
+  downloadHref(url, filename);
+  URL.revokeObjectURL(url);
+}
+function captureSnapshot() {
+  const canvas = document.querySelector("canvas");
+  if (!canvas) return null;
+  try {
+    return canvas.toDataURL("image/png");
+  } catch {
+    return null;
+  }
+}
+function WorldContribute({ data, onClose }) {
+  const source = data.meta?.source;
+  const gh = parseGitHubSource(source);
+  const editUrl = gh ? editFileUrl(gh) : null;
+  useEffect2(() => {
+    const onKey = (event) => {
+      if (event.key === "Escape") onClose();
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [onClose]);
+  const downloadJson = () => downloadText(serializeWorld(data), "world.json");
+  const downloadSnapshot = () => {
+    const png = captureSnapshot();
+    if (png) downloadHref(png, "world-snapshot.png");
+  };
+  const open = (url) => window.open(url, "_blank", "noopener,noreferrer");
+  return /* @__PURE__ */ jsxs3("div", { style: OVERLAY2, role: "dialog", "aria-modal": "true", "aria-label": "Contribute this world", children: [
+    /* @__PURE__ */ jsx3("button", { type: "button", style: SCRIM2, "aria-label": "Close", onClick: onClose }),
+    /* @__PURE__ */ jsxs3("div", { style: CARD2, children: [
+      /* @__PURE__ */ jsx3("button", { type: "button", style: CLOSE2, onClick: onClose, "aria-label": "Close", children: "\xD7" }),
+      /* @__PURE__ */ jsx3("h2", { style: TITLE2, children: "Contribute this world" }),
+      /* @__PURE__ */ jsx3("p", { style: INTRO, children: "Runek hands your edit to GitHub directly, no account or token needed. Your change becomes a normal pull request the world's owner reviews." }),
+      gh ? /* @__PURE__ */ jsxs3(Fragment3, { children: [
+        /* @__PURE__ */ jsx3("button", { type: "button", style: SECONDARY, onClick: () => open(forkUrl(gh)), children: "Fork this world \u2197" }),
+        /* @__PURE__ */ jsx3("p", { style: HINT, children: "Get your own deployable copy to build on." }),
+        /* @__PURE__ */ jsx3("div", { style: DIVIDER }),
+        /* @__PURE__ */ jsxs3("ol", { style: STEPS, children: [
+          /* @__PURE__ */ jsxs3(Step, { n: 1, children: [
+            "Download your edits and a snapshot of this view.",
+            /* @__PURE__ */ jsxs3("div", { style: ACTIONS, children: [
+              /* @__PURE__ */ jsx3("button", { type: "button", style: PRIMARY, onClick: downloadJson, children: "Download world.json" }),
+              /* @__PURE__ */ jsx3("button", { type: "button", style: PRIMARY, onClick: downloadSnapshot, children: "Download snapshot.png" })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxs3(Step, { n: 2, children: [
+            "Open the world file on GitHub (it forks the repo for you automatically).",
+            /* @__PURE__ */ jsx3("div", { style: ACTIONS, children: editUrl ? /* @__PURE__ */ jsx3("button", { type: "button", style: PRIMARY, onClick: () => open(editUrl), children: "Open GitHub editor \u2192" }) : /* @__PURE__ */ jsx3(
+              "button",
+              {
+                type: "button",
+                style: PRIMARY,
+                onClick: () => source && open(source.url),
+                children: "Open repository \u2197"
+              }
+            ) }),
+            !editUrl && /* @__PURE__ */ jsxs3("span", { style: NOTE, children: [
+              "The world's file path isn't set in ",
+              /* @__PURE__ */ jsx3("code", { children: "meta.source.path" }),
+              ", so open the repo and edit the world file directly."
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx3(Step, { n: 3, children: "In GitHub's editor: select all, paste the downloaded JSON, and commit to a new branch." }),
+          /* @__PURE__ */ jsx3(Step, { n: 4, children: "GitHub offers \u201CPropose changes\u201D \u2192 open the pull request. Attach the snapshot so the owner can see the change a JSON diff can't show." })
+        ] })
+      ] }) : /* @__PURE__ */ jsxs3(Fragment3, { children: [
+        /* @__PURE__ */ jsx3("p", { style: INTRO, children: "This world's repository isn't on GitHub. Download your changes and open the repo to contribute however it accepts them." }),
+        /* @__PURE__ */ jsxs3("div", { style: ACTIONS, children: [
+          /* @__PURE__ */ jsx3("button", { type: "button", style: PRIMARY, onClick: downloadJson, children: "Download world.json" }),
+          source?.url && /* @__PURE__ */ jsx3("button", { type: "button", style: PRIMARY, onClick: () => open(source.url), children: "Open repository \u2197" })
+        ] })
+      ] })
+    ] })
+  ] });
+}
+function Step({ n, children }) {
+  return /* @__PURE__ */ jsxs3("li", { style: STEP, children: [
+    /* @__PURE__ */ jsx3("span", { style: STEP_NUM, children: n }),
+    /* @__PURE__ */ jsx3("div", { children })
+  ] });
+}
+var MONO2 = "ui-monospace, SF Mono, Menlo, monospace";
+var BORDER2 = "#15202a";
+var GREEN = "#3df58a";
+var OVERLAY2 = {
+  position: "fixed",
+  inset: 0,
+  zIndex: 20,
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+  padding: "1rem"
+};
+var SCRIM2 = {
+  position: "absolute",
+  inset: 0,
+  border: "none",
+  padding: 0,
+  margin: 0,
+  background: "rgba(3, 5, 10, 0.6)",
+  backdropFilter: "blur(2px)",
+  cursor: "default"
+};
+var CARD2 = {
+  position: "relative",
+  zIndex: 1,
+  width: "100%",
+  maxWidth: 480,
+  maxHeight: "90vh",
+  overflowY: "auto",
+  padding: "1.5rem 1.6rem",
+  borderRadius: 12,
+  background: "rgba(7, 11, 17, 0.97)",
+  border: `1px solid ${BORDER2}`,
+  color: "#cfe6db",
+  fontFamily: MONO2,
+  boxShadow: "0 20px 60px rgba(0, 0, 0, 0.5)"
+};
+var CLOSE2 = {
+  position: "absolute",
+  top: "0.7rem",
+  right: "0.8rem",
+  border: "none",
+  background: "transparent",
+  color: "#5f7d75",
+  cursor: "pointer",
+  fontSize: "1.1rem",
+  lineHeight: 1,
+  fontFamily: MONO2
+};
+var TITLE2 = {
+  margin: "0 0 0.5rem",
+  fontSize: "1.15rem",
+  fontWeight: 600,
+  color: GREEN
+};
+var INTRO = {
+  margin: "0 0 1rem",
+  fontSize: "0.82rem",
+  lineHeight: 1.5,
+  color: "#cfe6db"
+};
+var HINT = {
+  margin: "0.35rem 0 0",
+  fontSize: "0.72rem",
+  color: "#5f7d75"
+};
+var NOTE = {
+  display: "block",
+  marginTop: "0.4rem",
+  fontSize: "0.72rem",
+  color: "#5f7d75"
+};
+var DIVIDER = {
+  height: 1,
+  margin: "1.1rem 0",
+  background: BORDER2
+};
+var STEPS = {
+  margin: 0,
+  padding: 0,
+  listStyle: "none",
+  display: "flex",
+  flexDirection: "column",
+  gap: "0.9rem"
+};
+var STEP = {
+  display: "flex",
+  gap: "0.6rem",
+  fontSize: "0.82rem",
+  lineHeight: 1.5
+};
+var STEP_NUM = {
+  flex: "0 0 auto",
+  width: 20,
+  height: 20,
+  borderRadius: "50%",
+  border: `1px solid ${GREEN}`,
+  color: GREEN,
+  fontSize: "0.72rem",
+  display: "inline-flex",
+  alignItems: "center",
+  justifyContent: "center",
+  marginTop: "0.05rem"
+};
+var ACTIONS = {
+  display: "flex",
+  flexWrap: "wrap",
+  gap: "0.4rem",
+  marginTop: "0.5rem"
+};
+var PRIMARY = {
+  padding: "0.35rem 0.65rem",
+  borderRadius: 6,
+  border: `1px solid rgba(61, 245, 138, 0.5)`,
+  background: "rgba(61, 245, 138, 0.14)",
+  color: GREEN,
+  cursor: "pointer",
+  fontSize: "0.76rem",
+  fontFamily: MONO2
+};
+var SECONDARY = {
+  padding: "0.4rem 0.7rem",
+  borderRadius: 6,
+  border: `1px solid ${BORDER2}`,
+  background: "rgba(255, 255, 255, 0.04)",
+  color: "#cfe6db",
+  cursor: "pointer",
+  fontSize: "0.8rem",
+  fontFamily: MONO2
+};
 
 // src/WorldEditor.tsx
-import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { OrbitControls, TransformControls } from "@react-three/drei";
+import { Leva, useControls } from "leva";
+import { useEffect as useEffect3, useRef, useState as useState2 } from "react";
+import { Fragment as Fragment4, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var NON_SELECTABLE = /* @__PURE__ */ new Set(["Sky", "LightRig"]);
 var SKIPPED = /* @__PURE__ */ new Set(["Player"]);
 var HISTORY_LIMIT = 100;
 var asVec3 = (value) => Array.isArray(value) && value.length === 3 ? value : void 0;
+var needsIds = (nodes) => nodes.some((node) => !node.id || (node.children ? needsIds(node.children) : false));
+var stripIds = (node) => ({
+  ...node,
+  id: void 0,
+  ...node.children ? { children: node.children.map(stripIds) } : {}
+});
 var isTyping = (target) => {
   const el = target;
   return !!el && (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.isContentEditable);
 };
 function WorldEditor({ data, registry, onChange, ...worldProps }) {
-  const [selected, setSelected] = useState(null);
-  const [mode, setMode] = useState("translate");
+  const [selected, setSelected] = useState2(null);
+  const [mode, setMode] = useState2("translate");
+  const [contributeOpen, setContributeOpen] = useState2(false);
   const history = useRef([]);
+  const canContribute = !!data.meta?.source?.url;
   const apply = (next) => {
     history.current.push(data);
     if (history.current.length > HISTORY_LIMIT) history.current.shift();
@@ -155,16 +733,18 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
     apply({ ...data, nodes });
   };
   const addNode = (type) => {
-    apply({ ...data, nodes: [...data.nodes, { type, props: { position: [0, 0, 0] } }] });
+    apply(
+      assignNodeIds({ ...data, nodes: [...data.nodes, { type, props: { position: [0, 0, 0] } }] })
+    );
     setSelected(null);
   };
   const duplicateSelected = () => {
     if (!selected) return;
     const source = data.nodes[selected.index];
-    const copy = JSON.parse(JSON.stringify(source));
+    const copy = stripIds(JSON.parse(JSON.stringify(source)));
     const at = asVec3(copy.props?.position) ?? [0, 0, 0];
     copy.props = { ...copy.props, position: [at[0] + 0.5, at[1], at[2] + 0.5] };
-    apply({ ...data, nodes: [...data.nodes, copy] });
+    apply(assignNodeIds({ ...data, nodes: [...data.nodes, copy] }));
     setSelected(null);
   };
   const deleteSelected = () => {
@@ -181,7 +761,10 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
       rotation: [r(rotation.x), r(rotation.y), r(rotation.z)]
     });
   };
-  useEffect(() => {
+  useEffect3(() => {
+    if (needsIds(data.nodes)) onChange(assignNodeIds(data));
+  }, [data, onChange]);
+  useEffect3(() => {
     const onKey = (event) => {
       if (isTyping(event.target)) return;
       if ((event.metaKey || event.ctrlKey) && event.key === "z") {
@@ -198,8 +781,8 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
     window.addEventListener("keydown", onKey);
     return () => window.removeEventListener("keydown", onKey);
   }, [data, selected, onChange]);
-  return /* @__PURE__ */ jsxs2(Fragment2, { children: [
-    /* @__PURE__ */ jsxs2(
+  return /* @__PURE__ */ jsxs4(Fragment4, { children: [
+    /* @__PURE__ */ jsxs4(
       World,
       {
         ...worldProps,
@@ -207,10 +790,14 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
         gravity: data.gravity,
         palette: data.palette,
         fog: data.fog,
+        time: data.time,
+        timezone: data.timezone,
+        avatar: data.avatar,
+        preserveDrawingBuffer: canContribute,
         onPointerMissed: () => setSelected(null),
         children: [
-          /* @__PURE__ */ jsx2(OrbitControls, { makeDefault: true }),
-          /* @__PURE__ */ jsx2(
+          /* @__PURE__ */ jsx4(OrbitControls, { makeDefault: true }),
+          /* @__PURE__ */ jsx4(
             EditableNodes,
             {
               nodes: data.nodes,
@@ -218,12 +805,14 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
               onSelect: (index, object) => setSelected({ index, object })
             }
           ),
-          selected && /* @__PURE__ */ jsx2(TransformControls, { object: selected.object, mode, onMouseUp: commitTransform })
+          selected && /* @__PURE__ */ jsx4(TransformControls, { object: selected.object, mode, onMouseUp: commitTransform })
         ]
       }
     ),
-    /* @__PURE__ */ jsx2(Leva, { hidden: selected === null }),
-    /* @__PURE__ */ jsx2(
+    /* @__PURE__ */ jsx4(Leva, { hidden: selected === null }),
+    /* @__PURE__ */ jsx4(WorldAbout, { meta: data.meta }),
+    contributeOpen && /* @__PURE__ */ jsx4(WorldContribute, { data, onClose: () => setContributeOpen(false) }),
+    /* @__PURE__ */ jsx4(
       EditorToolbar,
       {
         mode,
@@ -232,13 +821,15 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
         registry,
         selected: selected?.index ?? null,
         canUndo: history.current.length > 0,
+        canContribute,
         onAdd: addNode,
         onDuplicate: duplicateSelected,
         onDelete: deleteSelected,
-        onUndo: undo
+        onUndo: undo,
+        onContribute: () => setContributeOpen(true)
       }
     ),
-    selected !== null && /* @__PURE__ */ jsx2(
+    selected !== null && /* @__PURE__ */ jsx4(
       NodeControls,
       {
         index: selected.index,
@@ -249,17 +840,17 @@ function WorldEditor({ data, registry, onChange, ...worldProps }) {
   ] });
 }
 function EditableNodes({ nodes, registry, onSelect }) {
-  return /* @__PURE__ */ jsx2(Fragment2, { children: nodes.map((node, index) => {
+  return /* @__PURE__ */ jsx4(Fragment4, { children: nodes.map((node, index) => {
     if (SKIPPED.has(node.type)) return null;
     const Component = registry[node.type];
     if (!Component) return null;
     if (NON_SELECTABLE.has(node.type)) {
-      return /* @__PURE__ */ jsx2(Component, { ...node.props }, index);
+      return /* @__PURE__ */ jsx4(Component, { ...node.props }, node.id ?? index);
     }
     const { position, rotation, ...rest } = node.props ?? {};
     return (
       // biome-ignore lint/a11y/noStaticElementInteractions: <group> is a three.js object, not a DOM element
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx4(
         "group",
         {
           position: asVec3(position) ?? [0, 0, 0],
@@ -268,9 +859,9 @@ function EditableNodes({ nodes, registry, onSelect }) {
             event.stopPropagation();
             onSelect(index, event.eventObject);
           },
-          children: /* @__PURE__ */ jsx2(Component, { ...rest })
+          children: /* @__PURE__ */ jsx4(Component, { ...rest })
         },
-        index
+        node.id ?? index
       )
     );
   }) });
@@ -342,12 +933,12 @@ var SELECT = {
   appearance: "none",
   paddingRight: "0.9rem"
 };
-var DIVIDER = {
+var DIVIDER2 = {
   width: 1,
   alignSelf: "stretch",
   background: "#15202a"
 };
-var HINT = {
+var HINT2 = {
   color: "#5f7d75",
   fontSize: "0.72rem",
   paddingLeft: "0.2rem"
@@ -359,10 +950,12 @@ function EditorToolbar({
   registry,
   selected,
   canUndo,
+  canContribute,
   onAdd,
   onDuplicate,
   onDelete,
-  onUndo
+  onUndo,
+  onContribute
 }) {
   const hasSelection = selected !== null;
   const exportWorld = () => {
@@ -374,8 +967,8 @@ function EditorToolbar({
     a.click();
     URL.revokeObjectURL(url);
   };
-  return /* @__PURE__ */ jsxs2("div", { style: TOOLBAR, children: [
-    /* @__PURE__ */ jsx2(
+  return /* @__PURE__ */ jsxs4("div", { style: TOOLBAR, children: [
+    /* @__PURE__ */ jsx4(
       "button",
       {
         type: "button",
@@ -385,7 +978,7 @@ function EditorToolbar({
         children: "Move"
       }
     ),
-    /* @__PURE__ */ jsx2(
+    /* @__PURE__ */ jsx4(
       "button",
       {
         type: "button",
@@ -395,8 +988,8 @@ function EditorToolbar({
         children: "Rotate"
       }
     ),
-    /* @__PURE__ */ jsx2("span", { style: DIVIDER }),
-    /* @__PURE__ */ jsxs2(
+    /* @__PURE__ */ jsx4("span", { style: DIVIDER2 }),
+    /* @__PURE__ */ jsxs4(
       "select",
       {
         style: SELECT,
@@ -407,12 +1000,12 @@ function EditorToolbar({
         },
         title: "Insert a component at the origin",
         children: [
-          /* @__PURE__ */ jsx2("option", { value: "", children: "+ Add\u2026" }),
-          Object.keys(registry).sort().map((name) => /* @__PURE__ */ jsx2("option", { value: name, children: name }, name))
+          /* @__PURE__ */ jsx4("option", { value: "", children: "+ Add\u2026" }),
+          Object.keys(registry).sort().map((name) => /* @__PURE__ */ jsx4("option", { value: name, children: name }, name))
         ]
       }
     ),
-    /* @__PURE__ */ jsx2(
+    /* @__PURE__ */ jsx4(
       "button",
       {
         type: "button",
@@ -423,7 +1016,7 @@ function EditorToolbar({
         children: "Duplicate"
       }
     ),
-    /* @__PURE__ */ jsx2(
+    /* @__PURE__ */ jsx4(
       "button",
       {
         type: "button",
@@ -434,7 +1027,7 @@ function EditorToolbar({
         children: "Delete"
       }
     ),
-    /* @__PURE__ */ jsx2(
+    /* @__PURE__ */ jsx4(
       "button",
       {
         type: "button",
@@ -445,55 +1038,85 @@ function EditorToolbar({
         children: "Undo"
       }
     ),
-    /* @__PURE__ */ jsx2("span", { style: DIVIDER }),
-    /* @__PURE__ */ jsx2("button", { type: "button", style: button(false), onClick: exportWorld, children: "Download JSON" }),
-    /* @__PURE__ */ jsx2("span", { style: HINT, children: selected === null ? "click a component \xB7 Esc deselects" : `selected #${selected}` })
+    /* @__PURE__ */ jsx4("span", { style: DIVIDER2 }),
+    /* @__PURE__ */ jsx4("button", { type: "button", style: button(false), onClick: exportWorld, children: "Download JSON" }),
+    canContribute && /* @__PURE__ */ jsx4(
+      "button",
+      {
+        type: "button",
+        style: button(false),
+        onClick: onContribute,
+        title: "Fork or suggest changes upstream",
+        children: "Contribute \u2197"
+      }
+    ),
+    /* @__PURE__ */ jsx4("span", { style: HINT2, children: selected === null ? "click a component \xB7 Esc deselects" : `selected #${selected}` })
   ] });
 }
 
 // src/WorldNodes.tsx
-import { Fragment as Fragment3, jsx as jsx3 } from "react/jsx-runtime";
+import { Fragment as Fragment5, jsx as jsx5 } from "react/jsx-runtime";
 function WorldNodes({ nodes, registry }) {
-  return /* @__PURE__ */ jsx3(Fragment3, { children: nodes.map((node, index) => {
+  return /* @__PURE__ */ jsx5(Fragment5, { children: nodes.map((node, index) => {
     const Component = registry[node.type];
     if (!Component) {
       console.warn(`[runek] Unknown component "${node.type}" \u2014 skipped.`);
       return null;
     }
-    const children = node.children?.length ? /* @__PURE__ */ jsx3(WorldNodes, { nodes: node.children, registry }) : null;
-    return /* @__PURE__ */ jsx3(Component, { ...node.props, children }, index);
+    const children = node.children?.length ? /* @__PURE__ */ jsx5(WorldNodes, { nodes: node.children, registry }) : null;
+    return /* @__PURE__ */ jsx5(Component, { ...node.props, children }, node.id ?? index);
   }) });
 }
 
 // src/WorldRenderer.tsx
-import { jsx as jsx4 } from "react/jsx-runtime";
+import { Fragment as Fragment6, jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 function WorldRenderer({ data, registry, ...worldProps }) {
-  return /* @__PURE__ */ jsx4(
-    World,
-    {
-      unit: data.unit,
-      gravity: data.gravity,
-      palette: data.palette,
-      fog: data.fog,
-      ...worldProps,
-      children: /* @__PURE__ */ jsx4(WorldNodes, { nodes: data.nodes, registry })
-    }
-  );
+  return /* @__PURE__ */ jsxs5(Fragment6, { children: [
+    /* @__PURE__ */ jsx6(
+      World,
+      {
+        unit: data.unit,
+        gravity: data.gravity,
+        palette: data.palette,
+        fog: data.fog,
+        time: data.time,
+        timezone: data.timezone,
+        avatar: data.avatar,
+        ...worldProps,
+        children: /* @__PURE__ */ jsx6(WorldNodes, { nodes: data.nodes, registry })
+      }
+    ),
+    /* @__PURE__ */ jsx6(WorldAbout, { meta: data.meta })
+  ] });
 }
 export {
+  DEFAULT_FONT,
+  DEFAULT_FONTS,
   DEFAULT_PALETTE,
+  DEFAULT_WORLD_TIME,
   World,
+  WorldAbout,
   WorldContext,
+  WorldContribute,
   WorldEditor,
   WorldNodes,
   WorldRenderer,
+  assignNodeIds,
+  clockHours,
+  currentHours,
+  editFileUrl,
+  forkUrl,
   int,
   keyboardMap,
+  parseClockTime,
+  parseGitHubSource,
   parseWorld,
   pick,
   range,
+  resolveWorldTime,
   rng,
   serializeWorld,
   sub,
+  sunState,
   useWorld
 };