@felbrasil/dreamy 0.0.0-stage → 0.1.0

package/dist/types/module/src/ui/organisms/fleck-style-tab.d.ts

@@ -0,0 +1,7 @@
+import type { SculptLook, SculptTarget } from "../../../../api/src/index.js";
+export type LookTabProps = {
+    readonly look: SculptLook;
+    readonly targets: readonly SculptTarget[];
+};
+/** Fleck type and sliders, the rig's region blends, fleck and foundation colors. */
+export declare function FleckStyleTab({ look, targets }: LookTabProps): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/git-sync-panel.d.ts

@@ -0,0 +1,10 @@
+import type { LibrarySync, SyncStatus } from "../../../../api/src/index.js";
+/** The library's git status, kept current through the port. */
+export declare function useSyncStatus(sync: LibrarySync | undefined): SyncStatus;
+export type GitSyncPanelProps = {
+    readonly sync: LibrarySync;
+    readonly status: SyncStatus;
+    readonly toast: (message: string) => void;
+};
+/** Scenes dialog section: connect the library to one GitHub / GitLab repository, sync now, disconnect. */
+export declare function GitSyncPanel({ sync, status, toast }: GitSyncPanelProps): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/help-panel.d.ts

@@ -0,0 +1,2 @@
+/** The controls panel (? or the bottom-right button) and its button. */
+export declare function HelpPanel(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/material-tab.d.ts

@@ -0,0 +1,3 @@
+import type { LookTabProps } from "./fleck-style-tab.js";
+/** Roughness, metalness, glow, fleck normal intensity and opacity. */
+export declare function MaterialTab({ look, targets }: LookTabProps): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/object-list-panel.d.ts

@@ -0,0 +1,2 @@
+/** The object tree (assembly mode): select, rename, drag onto a row to group, onto the panel to ungroup. */
+export declare function ObjectListPanel(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/palette-panel.d.ts

@@ -0,0 +1,2 @@
+/** The palette editor: seven editable slots and the three fixed colors. */
+export declare function PalettePanel(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/parts-tab.d.ts

@@ -0,0 +1,26 @@
+import type { CreatureRecipe, CreatureTheme, PartSlot, RigObject } from "../../../../api/src/index.js";
+/** What a generated creature can lock: its base skeleton, a slot, its proportions or its face art. */
+type Lock = "base" | "sizes" | "eyes" | "mouth" | PartSlot;
+/** The generator's themes: a whole creature built from one made-up kind (natural: none). */
+export declare const THEME_OPTIONS: readonly {
+    readonly id: CreatureTheme | "none";
+    readonly name: string;
+}[];
+export declare const themeOf: (id: CreatureTheme | "none") => {
+    theme?: CreatureTheme;
+};
+/** A fresh seed for a roll. */
+export declare const newSeed: () => number;
+/** What a re-roll keeps from a recipe: everything in `locks`. */
+export declare function keptOf(recipe: CreatureRecipe, locks: ReadonlySet<Lock>): Partial<Pick<CreatureRecipe, "base" | "kits" | "sizes" | "eyes" | "mouth">>;
+/**
+ * A premade rig's part slots: each can take the parts of another premade (of the same family, or any with Chimera),
+ * fitted to this rig's bones, or a part variant (a tiger head, elephant ears). Picking the rig's own premade restores
+ * its own parts. Wings, horns or a tail the skeleton
+ * lacks can be grafted from a premade that has them. A generated rig also gets its generator: re-roll everything not
+ * locked, or one slot, its proportions or its face.
+ */
+export declare function PartsTab({ rig }: {
+    readonly rig: RigObject;
+}): import("react").JSX.Element | null;
+export {};

package/dist/types/module/src/ui/organisms/pattern-tab.d.ts

@@ -0,0 +1,3 @@
+import type { LookTabProps } from "./fleck-style-tab.js";
+/** Pattern type, scale, rotation, strength and its two palette colors. */
+export declare function PatternTab({ look, targets }: LookTabProps): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/pose-tab.d.ts

@@ -0,0 +1,8 @@
+import type { RigObject } from "../../../../api/src/index.js";
+/**
+ * A premade rig's pose presets: one pose, or two blended by a slider. Picking writes every bone's pose; posing
+ * bones by hand keeps that pose as Custom, offered here once it exists.
+ */
+export declare function PoseTab({ rig }: {
+    readonly rig: RigObject;
+}): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/premade-picker.d.ts

@@ -0,0 +1,2 @@
+/** Premade skeletons (from the core): a new standalone rig, or applied to the selected object. */
+export declare function PremadePicker(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/properties-panel.d.ts

@@ -0,0 +1,2 @@
+/** Properties of the selection: Transform, Fleck Style, Material, Pattern, (flat wings) Wing and (premade rigs) Parts and Pose. */
+export declare function PropertiesPanel(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/region-blends.d.ts

@@ -0,0 +1,5 @@
+import type { RigObject } from "../../../../api/src/index.js";
+/** The rig's per-region part blends (torso, limb, wing, tail, head). */
+export declare function RegionBlends({ rig }: {
+    readonly rig: RigObject;
+}): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/rendering-bar.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Rendering: normal / pixel art, render resolution, selected only, camera sun, fit to view (the selection, or
+ * everything, contained in a centred square from the current angle) and decal line boost (view preferences).
+ */
+export declare function RenderingBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/rig-bar.d.ts

@@ -0,0 +1,2 @@
+/** Rig Bones: premades, rig / pose mode, bone tools, reset pose, sculpt part, mirror. */
+export declare function RigBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/scenes-modal.d.ts

@@ -0,0 +1,2 @@
+/** Scenes: the library (open, rename, copy, export, delete), new scene, import and export. */
+export declare function ScenesModal(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/select-hint.d.ts

@@ -0,0 +1,2 @@
+/** The hint under the bars while the Select tool (or Rig Bones with a rig) is up. */
+export declare function SelectHint(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/shape-list-panel.d.ts

@@ -0,0 +1,2 @@
+/** The shapes of the scoped sculpt: loose stamps and smear groups (lock, properties, delete). */
+export declare function ShapeListPanel(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/side-dock.d.ts

@@ -0,0 +1,4 @@
+/** The right dock: Properties, Scope In / Exit Sculpt Mode (with the hold-Esc hint) and Export. */
+export declare function SideDock({ sheetOpen }: {
+    readonly sheetOpen: boolean;
+}): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/stamp-bar.d.ts

@@ -0,0 +1,2 @@
+/** Sculpt Stamps: the ten shapes; inside a sculpt also the smear brush, blend, CSG mode and part mirror. */
+export declare function StampBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/stamp-props-panel.d.ts

@@ -0,0 +1,2 @@
+/** Settings of the selected shape or smear group: mode, colors, blend, kaleidoscope, lock, material overrides. */
+export declare function StampPropsPanel(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/stamp-size-panel.d.ts

@@ -0,0 +1,4 @@
+/** The size of the stamp (or decal) brush: + / − buttons and a slider, while one of those tools is up. */
+export declare function StampSizePanel({ sheetOpen }: {
+    readonly sheetOpen: boolean;
+}): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/stats-badge.d.ts

@@ -0,0 +1,2 @@
+/** FPS, triangles, mesh time and LOD counts from the viewport (Utilities: Stats). */
+export declare function StatsBadge(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/style-bar.d.ts

@@ -0,0 +1,2 @@
+/** Fleck Style: the brush color (never the selection's) and quick fleck shapes for the selection. */
+export declare function StyleBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/symmetry-bar.d.ts

@@ -0,0 +1,2 @@
+/** Symmetry: the kaleidoscope defaults new shapes inherit, and the sculpt's pivot. */
+export declare function SymmetryBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/toast.d.ts

@@ -0,0 +1,2 @@
+/** The single toast at the bottom (top in the compact layout). */
+export declare function Toast(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/token-guide.d.ts

@@ -0,0 +1,5 @@
+import type { GitProvider } from "../../../../api/src/index.js";
+/** How to create an access token for the save repository (after vite-react's token guide). */
+export declare function TokenGuide({ provider }: {
+    readonly provider: GitProvider;
+}): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/touch-mods.d.ts

@@ -0,0 +1,2 @@
+/** Touch stand-ins for Shift (area select, one shot) and Ctrl (add to selection); drawn in the compact layout. */
+export declare function TouchMods(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/transform-bar.d.ts

@@ -0,0 +1,2 @@
+/** Transform: select / gizmo tools, world or local, the stamp stepper, mirror, duplicate, delete. */
+export declare function TransformBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/transform-tab.d.ts

@@ -0,0 +1,2 @@
+/** Position, rotation (degrees) and scale of the selection; other selected objects follow the first one's change. */
+export declare function TransformTab(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/utilities-bar.d.ts

@@ -0,0 +1,2 @@
+/** Utilities: stress test, play mode, palette, voxel resolution, hints, help, stats. */
+export declare function UtilitiesBar(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/viewport-host.d.ts

@@ -0,0 +1,2 @@
+/** The host element the injected viewport draws into; sends it the creation and the session on every change. */
+export declare function ViewportHost(): import("react").JSX.Element;

package/dist/types/module/src/ui/organisms/voxel-panel.d.ts

@@ -0,0 +1,2 @@
+/** The mesher's base voxel resolution (a view preference). */
+export declare function VoxelPanel(): import("react").JSX.Element | null;

package/dist/types/module/src/ui/organisms/wing-tab.d.ts

@@ -0,0 +1,10 @@
+import type { FlatWing, Id, Material } from "../../../../api/src/index.js";
+export type WingTabProps = {
+    readonly wing: FlatWing;
+    /** The (first) wing part's material. */
+    readonly material: Material;
+    readonly rigId: Id;
+    readonly boneIds: readonly Id[];
+};
+/** Flat wing outline, size, pattern and colors; every edit goes to all listed wings. */
+export declare function WingTab({ wing, material, rigId, boneIds }: WingTabProps): import("react").JSX.Element;

package/dist/types/module/src/ui/pages/editor-page.d.ts

@@ -0,0 +1,9 @@
+import "../studio.css";
+import { type EditorControllerProps } from "../hooks/use-editor-controller.js";
+/**
+ * One open creation in the studio. Logic comes from `api`; the 3D view is the injected `viewport`, mounted into
+ * a host element; `persistence` backs the Scenes dialog and autosave; `preferences` holds per-browser view
+ * settings. `onOpen` asks the host to switch to another library entry.
+ */
+export type EditorPageProps = EditorControllerProps;
+export declare function EditorPage(props: EditorPageProps): import("react").JSX.Element;

package/dist/types/module/src/ui/templates/editor-shell.d.ts

@@ -0,0 +1,2 @@
+/** The studio layout: the view, the dock, the left stack, the bars, floating panels, dialogs and the toast. */
+export declare function EditorShell(): import("react").JSX.Element;

package/dist/types/studio/src/browser-files.d.ts

@@ -0,0 +1,3 @@
+import type { FileAccess } from "./library-persistence.js";
+/** Download through a temporary link; pick through a hidden file input. */
+export declare function browserFiles(): FileAccess;

package/dist/types/studio/src/clock.d.ts

@@ -0,0 +1,2 @@
+import type { Clock } from "../../api/src/index.js";
+export declare const clock: Clock;

package/dist/types/studio/src/creation-file.d.ts

@@ -0,0 +1,21 @@
+import type { CreationLog } from "../../api/src/index.js";
+export declare const EMPTY_LOG: CreationLog;
+/** A log file is the format tag, the schema version and the events. */
+export declare function serializeCreationLog(log: CreationLog): string;
+/** Parses a file into a log, or undefined when it is not a log of this model (retired schemas included). */
+export declare function parseCreationLog(text: string): CreationLog | undefined;
+/** "My Bunny.dreamy.json" -> "My Bunny". */
+export declare function creationNameFromFile(fileName: string): string;
+export declare function fileNameFor(name: string): string;
+/** A creation as a file in the save repository: the log plus its library entry. Import reads it too. */
+export type CreationRecordFile = {
+    readonly id: string;
+    readonly name: string;
+    readonly updatedAt: number;
+    readonly thumbnail?: string;
+    readonly log: CreationLog;
+};
+/** Keys in a fixed order, one event per line, so equal records give equal bytes (and git diffs stay small). */
+export declare function serializeCreationRecord({ id, name, updatedAt, thumbnail, log }: CreationRecordFile): string;
+/** A record file, or a plain scene file (named `fallbackName`). */
+export declare function parseCreationRecord(text: string, id: string, fallbackName?: string): CreationRecordFile | undefined;

package/dist/types/studio/src/git-remote.d.ts

@@ -0,0 +1,36 @@
+import type { GitSettings } from "../../api/src/index.js";
+/** Every creation is one file under this folder of the save repository. */
+export declare const CREATIONS_DIR = "creations";
+export declare const creationPath: (id: string) => string;
+export declare function creationIdOf(path: string): string | undefined;
+/** The branch head and the blob SHA of every creation file at that commit. */
+export type RemoteSnapshot = {
+    readonly head: string;
+    readonly files: ReadonlyMap<string, string>;
+};
+/** A file to write, or to delete when `content` is absent. `exists` says whether the snapshot had it. */
+export type FileChange = {
+    readonly path: string;
+    readonly exists: boolean;
+    readonly content?: string;
+};
+/** The branch moved since the snapshot: take a new snapshot and sync again. */
+export declare class StaleRemoteError extends Error {
+    readonly name = "StaleRemoteError";
+}
+/** One branch of the save repository. */
+export type GitRemote = {
+    readonly user: string;
+    /** "owner/name" as the provider shows it. */
+    readonly repo: string;
+    readonly branch: string;
+    snapshot(): Promise<RemoteSnapshot>;
+    read(path: string, sha: string): Promise<string>;
+    /** One commit on top of `parent`; throws StaleRemoteError when the branch is no longer at `parent`. */
+    commit(message: string, changes: readonly FileChange[], parent: string): Promise<void>;
+};
+export type Fetch = (input: string, init?: RequestInit) => Promise<Response>;
+/** Git's blob id: SHA-1 of "blob <byte length>\0" + the bytes (as vite-react computes it for differential push). */
+export declare function gitBlobSha(text: string): Promise<string>;
+/** Verifies the token, finds or creates the repository and the branch, and returns the remote. */
+export declare function connectRemote(settings: GitSettings, fetcher: Fetch): Promise<GitRemote>;

package/dist/types/studio/src/git-sync.d.ts

@@ -0,0 +1,33 @@
+import type { GitSettings, Id, LibrarySync, Persistence } from "../../api/src/index.js";
+import { type GitRemote } from "./git-remote.js";
+import type { LibraryDatabase } from "./library-persistence.js";
+import type { KeyValueStorage } from "./preferences.js";
+/** A push follows the last library change after this long. */
+export declare const PUSH_DELAY_MS = 30000;
+export type GitSyncDeps = {
+    readonly database: LibraryDatabase;
+    readonly storage: KeyValueStorage | undefined;
+    /** Verifies the settings and returns the remote (`connectRemote` over the browser's fetch). */
+    readonly connect: (settings: GitSettings) => Promise<GitRemote>;
+    readonly newId: () => Id;
+    readonly now: () => number;
+    /** The creation open in the editor. */
+    readonly openId: () => Id | undefined;
+    readonly pushDelayMs?: number;
+};
+/** The LibrarySync port plus what the composition root needs: scheduled pushes. */
+export type GitSync = LibrarySync & {
+    readonly connected: boolean;
+    /** Debounced sync after a library change. */
+    schedule(): void;
+    /** Runs a scheduled sync now. */
+    flush(): void;
+    dispose(): void;
+};
+/**
+ * Git sync of the library, as vite-react's central vault: one repository, a personal access token kept in
+ * this browser's storage, browser requests to the GitHub / GitLab REST APIs. Syncs run one at a time.
+ */
+export declare function createGitSync({ database, storage, connect, newId, now, openId, pushDelayMs }: GitSyncDeps): GitSync;
+/** Persistence that schedules a push after every library write. */
+export declare function withSyncSchedule(persistence: Persistence, sync: Pick<GitSync, "schedule">): Persistence;

package/dist/types/studio/src/ids.d.ts

@@ -0,0 +1,3 @@
+import type { CreationLog, IdGenerator } from "../../api/src/index.js";
+/** Ids continue after the largest numeric id already in the log, so a reopened creation never reuses one. */
+export declare function createIds(log?: CreationLog): IdGenerator;

package/dist/types/studio/src/index.d.ts

@@ -0,0 +1,15 @@
+export { DreamyStudio } from "./studio.js";
+export type { DreamyStudioProps } from "./studio.js";
+export { createIndexedDbLibrary } from "./indexed-db-library.js";
+export { createLibraryPersistence } from "./library-persistence.js";
+export type { FileAccess, LibraryDatabase, LibraryDeps, LibraryRecord } from "./library-persistence.js";
+export { browserFiles } from "./browser-files.js";
+export { createPreferencesStore, DEFAULT_PREFERENCES } from "./preferences.js";
+export type { KeyValueStorage } from "./preferences.js";
+export { createGitSync, withSyncSchedule } from "./git-sync.js";
+export type { GitSync, GitSyncDeps } from "./git-sync.js";
+export { connectRemote } from "./git-remote.js";
+export type { GitRemote } from "./git-remote.js";
+export { EMPTY_LOG, parseCreationLog, serializeCreationLog } from "./creation-file.js";
+export { createIds } from "./ids.js";
+export { clock } from "./clock.js";

package/dist/types/studio/src/indexed-db-library.d.ts

@@ -0,0 +1,2 @@
+import type { LibraryDatabase } from "./library-persistence.js";
+export declare function createIndexedDbLibrary(): LibraryDatabase;

package/dist/types/studio/src/library-persistence.d.ts

@@ -0,0 +1,29 @@
+import type { CreationLog, Id, LibraryEntry, Persistence } from "../../api/src/index.js";
+export type LibraryRecord = LibraryEntry & {
+    readonly log: CreationLog;
+};
+/** Storage the library needs (IndexedDB in the browser, a map in tests). */
+export type LibraryDatabase = {
+    list(): Promise<readonly LibraryRecord[]>;
+    read(id: Id): Promise<LibraryRecord | undefined>;
+    write(record: LibraryRecord): Promise<void>;
+    delete(id: Id): Promise<void>;
+    current(): Promise<Id | undefined>;
+    setCurrent(id: Id): Promise<void>;
+};
+/** Browser file access: download a text file, pick one to read. */
+export type FileAccess = {
+    download(fileName: string, text: string): void;
+    pick(): Promise<{
+        readonly fileName: string;
+        readonly text: string;
+    } | undefined>;
+};
+export type LibraryDeps = {
+    readonly database: LibraryDatabase;
+    readonly files: FileAccess;
+    readonly newId: () => Id;
+    readonly now: () => number;
+};
+/** The Persistence port over a database and file access. Writes run one at a time, in order. */
+export declare function createLibraryPersistence({ database, files, newId, now }: LibraryDeps): Persistence;

package/dist/types/studio/src/library-sync.d.ts

@@ -0,0 +1,29 @@
+import type { Id, SyncSummary } from "../../api/src/index.js";
+import { type GitRemote } from "./git-remote.js";
+import type { LibraryDatabase } from "./library-persistence.js";
+/** What a creation looked like at its last sync: the repo's blob and the local record's blob. */
+export type SyncedState = {
+    readonly remoteSha: string;
+    readonly localSha: string;
+};
+export type SyncDeps = {
+    readonly database: LibraryDatabase;
+    readonly remote: GitRemote;
+    /** Last-sync state per creation. Updated in place as the sync goes. */
+    readonly state: Map<Id, SyncedState>;
+    readonly newId: () => Id;
+    /** The creation open in the editor: never overwritten or deleted under it. */
+    readonly protect: () => Id | undefined;
+};
+export type SyncResult = SyncSummary & {
+    /** Local records the sync wrote or deleted. */
+    readonly changed: readonly Id[];
+};
+/**
+ * One three-way sync of the library with the repository, against the state of the last sync:
+ * - changed on one side only: that side wins (push or pull);
+ * - changed on both: keep both, the newer keeps the creation and the other becomes "<name> (conflict copy)";
+ * - deleted on one side and unchanged on the other: deleted on both; edited on the other: it comes back.
+ * Every push goes in one commit. A StaleRemoteError from the commit means: sync again.
+ */
+export declare function syncLibrary({ database, remote, state, newId, protect }: SyncDeps): Promise<SyncResult>;

package/dist/types/studio/src/preferences.d.ts

@@ -0,0 +1,9 @@
+import type { PreferencesStore, ViewPreferences } from "../../api/src/index.js";
+export declare const DEFAULT_PREFERENCES: ViewPreferences;
+export type KeyValueStorage = {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem?(key: string): void;
+};
+/** View settings per browser. A missing, broken or blocked store falls back to the defaults. */
+export declare function createPreferencesStore(storage: KeyValueStorage | undefined): PreferencesStore;

package/dist/types/studio/src/seed.d.ts

@@ -0,0 +1,3 @@
+import type { CreationApi } from "../../api/src/index.js";
+/** A brand-new library starts like the POC: one cube sculpt above the ground. */
+export declare function seedFirstSculpt(api: CreationApi): void;

package/dist/types/studio/src/studio.d.ts

@@ -0,0 +1,17 @@
+import { type LibraryDatabase } from "./library-persistence.js";
+import { type KeyValueStorage } from "./preferences.js";
+export type DreamyStudioProps = {
+    /** Where the library of creations lives. Default: this browser's IndexedDB ("dreamy-studio" database). */
+    readonly database?: LibraryDatabase;
+    /** Key-value storage for view preferences and git settings. Default: localStorage. */
+    readonly storage?: KeyValueStorage;
+    /** Offer git sync of the library (Scenes → Git). Default: true. */
+    readonly gitSync?: boolean;
+    /** Called once: the evaluator core is loaded, the creation is open and the studio has painted. */
+    readonly onReady?: () => void;
+};
+/**
+ * The Dreamy studio: core, module, evaluator, viewport, persistence, git sync, preferences, ids and clock.
+ * It fills the page (fixed, full viewport); render one per page, client-side only.
+ */
+export declare function DreamyStudio({ database: injected, storage: injectedStorage, gitSync, onReady }: DreamyStudioProps): import("react").JSX.Element;

package/dist/types/viewport/src/create-viewport.d.ts

@@ -0,0 +1,10 @@
+import type { Evaluator, Viewport } from "../../api/src/index.js";
+export type ViewportOptions = {
+    /** The mesher (the app constructs it and hands it over; the viewport never imports `@dreamy/evaluator`). */
+    readonly evaluator: Evaluator;
+};
+/**
+ * The 3D view (`Viewport` port): reads a Creation + ViewSession, never mutates the creation, reports gestures as
+ * Commands through `callbacks.command` and selection through `callbacks.select`. Meshes come from the evaluator.
+ */
+export declare function createViewport({ evaluator }: ViewportOptions): Viewport;

package/dist/types/viewport/src/decals/builtin-art.d.ts

@@ -0,0 +1,19 @@
+import type { BuiltinDecalCategory, ColorRef, Rgb } from "../../../api/src/index.js";
+/** Resolves a palette ref to CSS and records that the art used it (palette edits re-raster those cells). */
+export type Paint = (ref: ColorRef) => string;
+export type BuiltinArt = {
+    readonly category: BuiltinDecalCategory;
+    readonly name: string;
+    readonly tintable: boolean;
+    /** Default tint for tintable art. */
+    readonly tint?: ColorRef;
+    /** Interior room id: ray-traced in the shader, no atlas cell. */
+    readonly room?: number;
+    /** Interior wall color when the decal has no tint (the POC's raw defaults). */
+    readonly wall?: Rgb;
+    readonly draw: (g: CanvasRenderingContext2D, S: number, paint: Paint) => void;
+};
+/** Category order of the picker (the POC's DECAL_ORDER, built-ins only). */
+export declare const DECAL_CATEGORIES: readonly BuiltinDecalCategory[];
+export declare const BUILTIN_ART: readonly BuiltinArt[];
+export declare const findBuiltin: (category: BuiltinDecalCategory, name: string) => BuiltinArt | undefined;

package/dist/types/viewport/src/decals/builtin-docs.d.ts

@@ -0,0 +1,7 @@
+import type { DesignShape } from "../../../api/src/index.js";
+/** Built-in decals drawn as designs (palette-driven), from the POC's BUILTIN_DOCS. */
+export declare const BUILTIN_DOCS: Record<string, {
+    readonly name: string;
+    readonly category: "eye" | "mouth" | "mark";
+    readonly shapes: readonly DesignShape[];
+}>;

package/dist/types/viewport/src/decals/decal-atlas.d.ts

@@ -0,0 +1,37 @@
+import type { DecalArt, Design, Palette } from "../../../api/src/index.js";
+import { CanvasTexture } from "three";
+import { type BuiltinArt } from "./builtin-art.js";
+import type { DecalArtInfo } from "./decal-uniforms.js";
+/**
+ * One canvas atlas per viewport (the POC's decal atlas): built-in art first, then one cell per design of the
+ * open creation. Palette edits and design saves re-raster only the cells they touch; the GPU upload happens at
+ * most once per frame (`flush`).
+ */
+export declare class DecalAtlas {
+    readonly canvas: HTMLCanvasElement;
+    readonly texture: CanvasTexture;
+    private readonly ctx;
+    private readonly builtins;
+    private readonly designs;
+    private readonly free;
+    private palette;
+    private dirty;
+    constructor(palette: Palette);
+    private newCell;
+    private raster;
+    /** Re-rasters the cells that use a slot whose color changed. */
+    setPalette(palette: Palette): void;
+    /** Cells for the creation's designs: new / changed ones rasterized, deleted ones freed. */
+    setDesigns(designs: readonly Design[]): void;
+    /** At most one GPU upload per frame. */
+    flush(): void;
+    private cellOf;
+    builtinOf(art: DecalArt): BuiltinArt | undefined;
+    info(art: DecalArt): DecalArtInfo;
+    /** The art's own canvas (ghost preview, thumbnails), and a version that changes on every re-raster. */
+    cellCanvas(art: DecalArt): {
+        canvas: HTMLCanvasElement;
+        version: number;
+    } | undefined;
+    dispose(): void;
+}

package/dist/types/viewport/src/decals/decal-catalog.d.ts

@@ -0,0 +1,17 @@
+import type { Creation, DecalCatalogEntry } from "../../../api/src/index.js";
+import type { DecalAtlas } from "./decal-atlas.js";
+export type CatalogEntry = DecalCatalogEntry & {
+    readonly category: string;
+};
+/**
+ * The picker's list: built-ins by category, then the creation's designs (category "custom"). Thumbnails are
+ * 64 px data URLs drawn with the current palette; tintable art is multiplied by its default tint.
+ */
+export declare class DecalCatalog {
+    private readonly atlas;
+    private interiors;
+    private readonly thumbs;
+    constructor(atlas: () => DecalAtlas);
+    entries(creation: Creation): CatalogEntry[];
+    private thumb;
+}

package/dist/types/viewport/src/decals/decal-glsl.d.ts

@@ -0,0 +1,2 @@
+export declare const INTERIOR_GLSL = "\n    // ---- Interior rooms: a box behind a flat window, ray-traced in decal space ----\n    // Window = x, y in [-0.5, 0.5] on the z = 0 plane; the room runs from z = 0 down to z = -D.\n    float rHash(vec2 p) {\n        vec3 p3 = fract(vec3(p.xyx) * 0.1031);\n        p3 += dot(p3, p3.yzx + 33.33);\n        return fract((p3.x + p3.y) * p3.z);\n    }\n    vec3 rPal(float h) { return 0.35 + 0.5 * cos(6.2831853 * (h + vec3(0.0, 0.33, 0.67))); }\n\n    // Nearest-hit box test (material id, normal and distance are only written when this box is closer)\n    void rBox(vec3 o, vec3 d, vec3 mn, vec3 mx, int mat, inout float tB, inout vec3 nB, inout int mB) {\n        vec3 inv = 1.0 / d;\n        vec3 t1 = (mn - o) * inv, t2 = (mx - o) * inv;\n        vec3 tmn = min(t1, t2), tmx = max(t1, t2);\n        float tN = max(max(tmn.x, tmn.y), tmn.z);\n        float tF = min(min(tmx.x, tmx.y), tmx.z);\n        if (tN < tF && tN > 0.0 && tN < tB) {\n            tB = tN; mB = mat;\n            nB = -sign(d) * step(vec3(tN - 1e-5), tmn);\n        }\n    }\n\n    bool rAabb(vec3 o, vec3 d, vec3 mn, vec3 mx) {\n        vec3 inv = 1.0 / d;\n        vec3 t1 = (mn - o) * inv, t2 = (mx - o) * inv;\n        vec3 a = min(t1, t2), b = max(t1, t2);\n        float tF = min(min(b.x, b.y), b.z);\n        return max(max(a.x, a.y), a.z) < tF && tF > 0.0;\n    }\n\n    // Bookcase face: shelf boards plus hashed book spines\n    vec3 rBooks(vec3 h, float D, float seed) {\n        float ry = (h.y + 0.5) / 0.23;\n        if (ry > 4.0) return vec3(0.34, 0.21, 0.11);\n        float ri = floor(ry), fy = fract(ry);\n        if (fy < 0.07) return vec3(0.34, 0.21, 0.11);\n        float s = (-h.z / D) * 26.0;\n        float bi = floor(s), fx = fract(s);\n        float r1 = rHash(vec2(bi, ri + seed * 3.1));\n        float r2 = rHash(vec2(bi + 41.0, ri + seed));\n        if (fy > 0.07 + (0.55 + 0.4 * r1) * 0.88) return vec3(0.16, 0.10, 0.06);\n        if (fx < 0.08) return vec3(0.10, 0.08, 0.06);\n        return rPal(r2) * (0.8 + 0.3 * fract(r1 * 7.0));\n    }\n\n    // pd: surface point in decal space (flip already applied), d: unit view direction in decal space (z < 0 = into the wall)\n    // room ids: 0 bed, 1 books, 2 table + chairs, 3 double doors with small windows, 4 grid\n    // returns linear colour\n    vec3 interiorRoom(vec3 pd, vec3 d, float variant, float D, vec3 wall, float seed) {\n        if (abs(d.x) < 1e-4) d.x = d.x < 0.0 ? -1e-4 : 1e-4;\n        if (abs(d.y) < 1e-4) d.y = d.y < 0.0 ? -1e-4 : 1e-4;\n        vec3 o = pd - d * (pd.z / d.z);               // slide along the ray to the window plane\n        o = vec3(clamp(o.xy, -0.499, 0.499), 0.0);\n        int V = int(variant + 0.5);\n\n        // Shell: floor (1), ceiling (2), side walls (3), back wall (4)\n        float tx = ((d.x > 0.0 ? 0.5 : -0.5) - o.x) / d.x;\n        float ty = ((d.y > 0.0 ? 0.5 : -0.5) - o.y) / d.y;\n        float tz = -D / d.z;\n        float tB; vec3 nB; int mB;\n        if (tz <= tx && tz <= ty) { tB = tz; nB = vec3(0.0, 0.0, 1.0); mB = 4; }\n        else if (tx <= ty) { tB = tx; nB = vec3(-sign(d.x), 0.0, 0.0); mB = 3; }\n        else { tB = ty; nB = vec3(0.0, -sign(d.y), 0.0); mB = d.y > 0.0 ? 2 : 1; }\n\n        // Contents (materials: 5 wood, 6 accent cloth, 7 linen, 8 bookcase)\n        if (V == 0 && rAabb(o, d, vec3(-0.49, -0.50, -D), vec3(-0.17, -0.10, -D * 0.40))) {   // bed against the left wall\n            float zA = -D * 0.97, zF = -D * 0.40;\n            rBox(o, d, vec3(-0.48, -0.50, zA), vec3(-0.18, -0.38, zF), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.47, -0.38, zA), vec3(-0.19, -0.30, zF), 7, tB, nB, mB);\n            rBox(o, d, vec3(-0.475, -0.38, -D * 0.72), vec3(-0.185, -0.285, zF), 6, tB, nB, mB);\n            rBox(o, d, vec3(-0.44, -0.30, zA), vec3(-0.22, -0.235, -D * 0.86), 7, tB, nB, mB);\n            rBox(o, d, vec3(-0.49, -0.50, -D * 0.995), vec3(-0.17, -0.10, zA), 5, tB, nB, mB);\n        } else if (V == 1) {                           // bookcase along the right wall\n            rBox(o, d, vec3(0.36, -0.50, -D * 0.92), vec3(0.50, 0.42, -D * 0.12), 8, tB, nB, mB);\n        } else if (V == 2 && rAabb(o, d, vec3(-0.42, -0.50, -D * 0.72), vec3(0.42, -0.08, -D * 0.30))) {   // table + two chairs\n            rBox(o, d, vec3(-0.24, -0.22, -D * 0.72), vec3(0.24, -0.17, -D * 0.30), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.235, -0.50, -D * 0.70), vec3(-0.195, -0.22, -D * 0.66), 5, tB, nB, mB);\n            rBox(o, d, vec3(0.195, -0.50, -D * 0.70), vec3(0.235, -0.22, -D * 0.66), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.235, -0.50, -D * 0.36), vec3(-0.195, -0.22, -D * 0.32), 5, tB, nB, mB);\n            rBox(o, d, vec3(0.195, -0.50, -D * 0.36), vec3(0.235, -0.22, -D * 0.32), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.40, -0.36, -D * 0.58), vec3(-0.28, -0.31, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(-0.41, -0.31, -D * 0.58), vec3(-0.39, -0.08, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(-0.36, -0.50, -D * 0.53), vec3(-0.32, -0.36, -D * 0.49), 5, tB, nB, mB);\n            rBox(o, d, vec3(0.28, -0.36, -D * 0.58), vec3(0.40, -0.31, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(0.39, -0.31, -D * 0.58), vec3(0.41, -0.08, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(0.32, -0.50, -D * 0.53), vec3(0.36, -0.36, -D * 0.49), 5, tB, nB, mB);\n        }\n\n        // Open curtains just inside the window (9), hung from a rod\n        float tc = -0.05 / d.z;\n        if (tc < tB) {\n            vec3 pc = o + d * tc;\n            float edge = 0.28 + 0.08 * clamp(abs(pc.y + 0.05) * 2.0, 0.0, 1.0);   // tied back at mid height\n            if (pc.y > 0.465) { tB = tc; nB = vec3(0.0, 0.0, 1.0); mB = 5; }\n            else if (abs(pc.x) > edge && pc.y > -0.46) { tB = tc; nB = vec3(0.0, 0.0, 1.0); mB = 9; }\n        }\n\n        // Surface colour at the hit\n        vec3 h = o + d * tB;\n        vec3 col = vec3(0.5);\n        float emit = 0.0;\n        if (V == 4 && mB <= 4) {                       // grid room: tiled walls with dark gaps\n            vec2 g = mB <= 2 ? vec2(h.x + 0.5, -h.z / D) : (mB == 3 ? vec2(-h.z / D, h.y + 0.5) : vec2(h.x + 0.5, h.y + 0.5));\n            vec2 f = fract(g * 4.0);\n            col = wall * mix(0.12, 1.0, step(0.1, f.x) * step(0.1, f.y));\n        } else if (mB == 1) {\n            float pu = h.x * 7.0;\n            col = vec3(0.56, 0.38, 0.22) * (0.82 + 0.3 * rHash(vec2(floor(pu), 1.0)));\n            if (fract(pu) < 0.06) col *= 0.55;\n        } else if (mB == 2) {\n            col = vec3(0.93, 0.92, 0.88);\n        } else if (mB == 3 || mB == 4) {\n            col = h.y < -0.46 ? vec3(0.88, 0.86, 0.82) : wall;\n        } else if (mB == 5) {\n            col = vec3(0.50, 0.32, 0.17);\n        } else if (mB == 6) {\n            col = rPal(rHash(vec2(seed, 5.0)));\n        } else if (mB == 7) {\n            col = vec3(0.93, 0.93, 0.90);\n        } else if (mB == 8) {\n            col = nB.x < -0.5 ? rBooks(h, D, seed) : vec3(0.50, 0.32, 0.17);\n        } else if (mB == 9) {\n            col = rPal(rHash(vec2(seed, 13.0))) * (0.72 + 0.28 * abs(fract(h.x * 11.0) - 0.5) * 2.0);\n        }\n\n        // Door in the middle of the back wall (every room has one)\n        if (mB == 4) {\n            if (V == 3) {                               // double doors with small windows\n                if (abs(h.x) < 0.26 && h.y < 0.2) {\n                    float dx = (h.x + 0.26) / 0.52, dy = (h.y + 0.5) / 0.70;\n                    float lx = fract(dx * 2.0);\n                    col = vec3(0.82, 0.80, 0.76);\n                    if (abs(dx - 0.5) < 0.012 || lx < 0.02 || lx > 0.98) col = vec3(0.25, 0.22, 0.2);\n                    else if (dy < 0.45 && lx > 0.14 && lx < 0.86 && dy > 0.06) col *= 0.88;\n                    if (lx > 0.14 && lx < 0.86 && dy > 0.52 && dy < 0.92) {\n                        vec2 q = vec2((lx - 0.14) / 0.72, (dy - 0.52) / 0.4) * 2.0;\n                        vec2 gq = fract(q);\n                        if (gq.x > 0.1 && gq.x < 0.9 && gq.y > 0.1 && gq.y < 0.9) { col = vec3(0.65, 0.82, 0.98); emit = 1.0; }\n                    }\n                    if (length(vec2(abs(dx - 0.5) - 0.04, dy - 0.42)) < 0.025) col = vec3(0.85, 0.70, 0.20);\n                }\n            } else if (abs(h.x) < 0.14 && h.y < 0.14) {\n                float lx = (h.x + 0.14) / 0.28, ly = (h.y + 0.5) / 0.64;\n                col = vec3(0.45, 0.28, 0.14);\n                bool pan = lx > 0.18 && lx < 0.82 && ((ly > 0.1 && ly < 0.45) || (ly > 0.55 && ly < 0.9));\n                if (pan) col *= 0.82;\n                if (lx < 0.05 || lx > 0.95 || ly > 0.96) col = vec3(0.9, 0.88, 0.84);\n                if (length(vec2(lx - 0.85, ly - 0.48)) < 0.045) col = vec3(0.85, 0.70, 0.20);\n            }\n        }\n\n        float lit = 0.55 + 0.45 * max(dot(normalize(nB), vec3(0.2494, 0.798, 0.5486)), 0.0);\n        lit *= 1.0 - 0.35 * smoothstep(0.0, 2.0, tB);\n        col = emit > 0.5 ? col * 1.1 : col * lit;\n        col = clamp(col, 0.0, 1.0);\n        return col * col;                              // ~gamma 2.0, cheaper than pow()\n    }\n\n    // Window frame around the room\n    vec3 interiorWindow(vec3 pd, vec3 d, float variant, float D, vec3 wall, float seed) {\n        if (max(abs(pd.x), abs(pd.y)) > 0.46) return wall * wall * 0.09;\n        return interiorRoom(pd, d, variant, D, wall, seed);\n    }\n";
+export declare const DECAL_GLSL = "\n    // Sampling happens inside a loop with break / continue, so ask for level 0 explicitly where the GLSL version allows it\n    #if __VERSION__ >= 300\n        #define DECAL_SAMPLE(s, uv) textureLod(s, uv, 0.0)\n    #else\n        #define DECAL_SAMPLE(s, uv) texture2D(s, uv)\n    #endif\n    uniform sampler2D uDecalData;\n    uniform sampler2D uDecalAtlas;\n    uniform float uDecalCount;\n    uniform float uDecalBoostDist;\n    uniform vec4 uDecalBounds[64];   // bounding sphere per decal: centre xyz, radius\n    uniform vec3 uLocalCam;      // camera in the object's local space (interior rays)\n    varying vec3 vLocalNormal;\n    float gDecalGlow = 0.0;      // interior windows read as lit from inside; the fleck material adds this as emission\n    \n    // ---- Interior rooms: a box behind a flat window, ray-traced in decal space ----\n    // Window = x, y in [-0.5, 0.5] on the z = 0 plane; the room runs from z = 0 down to z = -D.\n    float rHash(vec2 p) {\n        vec3 p3 = fract(vec3(p.xyx) * 0.1031);\n        p3 += dot(p3, p3.yzx + 33.33);\n        return fract((p3.x + p3.y) * p3.z);\n    }\n    vec3 rPal(float h) { return 0.35 + 0.5 * cos(6.2831853 * (h + vec3(0.0, 0.33, 0.67))); }\n\n    // Nearest-hit box test (material id, normal and distance are only written when this box is closer)\n    void rBox(vec3 o, vec3 d, vec3 mn, vec3 mx, int mat, inout float tB, inout vec3 nB, inout int mB) {\n        vec3 inv = 1.0 / d;\n        vec3 t1 = (mn - o) * inv, t2 = (mx - o) * inv;\n        vec3 tmn = min(t1, t2), tmx = max(t1, t2);\n        float tN = max(max(tmn.x, tmn.y), tmn.z);\n        float tF = min(min(tmx.x, tmx.y), tmx.z);\n        if (tN < tF && tN > 0.0 && tN < tB) {\n            tB = tN; mB = mat;\n            nB = -sign(d) * step(vec3(tN - 1e-5), tmn);\n        }\n    }\n\n    bool rAabb(vec3 o, vec3 d, vec3 mn, vec3 mx) {\n        vec3 inv = 1.0 / d;\n        vec3 t1 = (mn - o) * inv, t2 = (mx - o) * inv;\n        vec3 a = min(t1, t2), b = max(t1, t2);\n        float tF = min(min(b.x, b.y), b.z);\n        return max(max(a.x, a.y), a.z) < tF && tF > 0.0;\n    }\n\n    // Bookcase face: shelf boards plus hashed book spines\n    vec3 rBooks(vec3 h, float D, float seed) {\n        float ry = (h.y + 0.5) / 0.23;\n        if (ry > 4.0) return vec3(0.34, 0.21, 0.11);\n        float ri = floor(ry), fy = fract(ry);\n        if (fy < 0.07) return vec3(0.34, 0.21, 0.11);\n        float s = (-h.z / D) * 26.0;\n        float bi = floor(s), fx = fract(s);\n        float r1 = rHash(vec2(bi, ri + seed * 3.1));\n        float r2 = rHash(vec2(bi + 41.0, ri + seed));\n        if (fy > 0.07 + (0.55 + 0.4 * r1) * 0.88) return vec3(0.16, 0.10, 0.06);\n        if (fx < 0.08) return vec3(0.10, 0.08, 0.06);\n        return rPal(r2) * (0.8 + 0.3 * fract(r1 * 7.0));\n    }\n\n    // pd: surface point in decal space (flip already applied), d: unit view direction in decal space (z < 0 = into the wall)\n    // room ids: 0 bed, 1 books, 2 table + chairs, 3 double doors with small windows, 4 grid\n    // returns linear colour\n    vec3 interiorRoom(vec3 pd, vec3 d, float variant, float D, vec3 wall, float seed) {\n        if (abs(d.x) < 1e-4) d.x = d.x < 0.0 ? -1e-4 : 1e-4;\n        if (abs(d.y) < 1e-4) d.y = d.y < 0.0 ? -1e-4 : 1e-4;\n        vec3 o = pd - d * (pd.z / d.z);               // slide along the ray to the window plane\n        o = vec3(clamp(o.xy, -0.499, 0.499), 0.0);\n        int V = int(variant + 0.5);\n\n        // Shell: floor (1), ceiling (2), side walls (3), back wall (4)\n        float tx = ((d.x > 0.0 ? 0.5 : -0.5) - o.x) / d.x;\n        float ty = ((d.y > 0.0 ? 0.5 : -0.5) - o.y) / d.y;\n        float tz = -D / d.z;\n        float tB; vec3 nB; int mB;\n        if (tz <= tx && tz <= ty) { tB = tz; nB = vec3(0.0, 0.0, 1.0); mB = 4; }\n        else if (tx <= ty) { tB = tx; nB = vec3(-sign(d.x), 0.0, 0.0); mB = 3; }\n        else { tB = ty; nB = vec3(0.0, -sign(d.y), 0.0); mB = d.y > 0.0 ? 2 : 1; }\n\n        // Contents (materials: 5 wood, 6 accent cloth, 7 linen, 8 bookcase)\n        if (V == 0 && rAabb(o, d, vec3(-0.49, -0.50, -D), vec3(-0.17, -0.10, -D * 0.40))) {   // bed against the left wall\n            float zA = -D * 0.97, zF = -D * 0.40;\n            rBox(o, d, vec3(-0.48, -0.50, zA), vec3(-0.18, -0.38, zF), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.47, -0.38, zA), vec3(-0.19, -0.30, zF), 7, tB, nB, mB);\n            rBox(o, d, vec3(-0.475, -0.38, -D * 0.72), vec3(-0.185, -0.285, zF), 6, tB, nB, mB);\n            rBox(o, d, vec3(-0.44, -0.30, zA), vec3(-0.22, -0.235, -D * 0.86), 7, tB, nB, mB);\n            rBox(o, d, vec3(-0.49, -0.50, -D * 0.995), vec3(-0.17, -0.10, zA), 5, tB, nB, mB);\n        } else if (V == 1) {                           // bookcase along the right wall\n            rBox(o, d, vec3(0.36, -0.50, -D * 0.92), vec3(0.50, 0.42, -D * 0.12), 8, tB, nB, mB);\n        } else if (V == 2 && rAabb(o, d, vec3(-0.42, -0.50, -D * 0.72), vec3(0.42, -0.08, -D * 0.30))) {   // table + two chairs\n            rBox(o, d, vec3(-0.24, -0.22, -D * 0.72), vec3(0.24, -0.17, -D * 0.30), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.235, -0.50, -D * 0.70), vec3(-0.195, -0.22, -D * 0.66), 5, tB, nB, mB);\n            rBox(o, d, vec3(0.195, -0.50, -D * 0.70), vec3(0.235, -0.22, -D * 0.66), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.235, -0.50, -D * 0.36), vec3(-0.195, -0.22, -D * 0.32), 5, tB, nB, mB);\n            rBox(o, d, vec3(0.195, -0.50, -D * 0.36), vec3(0.235, -0.22, -D * 0.32), 5, tB, nB, mB);\n            rBox(o, d, vec3(-0.40, -0.36, -D * 0.58), vec3(-0.28, -0.31, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(-0.41, -0.31, -D * 0.58), vec3(-0.39, -0.08, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(-0.36, -0.50, -D * 0.53), vec3(-0.32, -0.36, -D * 0.49), 5, tB, nB, mB);\n            rBox(o, d, vec3(0.28, -0.36, -D * 0.58), vec3(0.40, -0.31, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(0.39, -0.31, -D * 0.58), vec3(0.41, -0.08, -D * 0.44), 6, tB, nB, mB);\n            rBox(o, d, vec3(0.32, -0.50, -D * 0.53), vec3(0.36, -0.36, -D * 0.49), 5, tB, nB, mB);\n        }\n\n        // Open curtains just inside the window (9), hung from a rod\n        float tc = -0.05 / d.z;\n        if (tc < tB) {\n            vec3 pc = o + d * tc;\n            float edge = 0.28 + 0.08 * clamp(abs(pc.y + 0.05) * 2.0, 0.0, 1.0);   // tied back at mid height\n            if (pc.y > 0.465) { tB = tc; nB = vec3(0.0, 0.0, 1.0); mB = 5; }\n            else if (abs(pc.x) > edge && pc.y > -0.46) { tB = tc; nB = vec3(0.0, 0.0, 1.0); mB = 9; }\n        }\n\n        // Surface colour at the hit\n        vec3 h = o + d * tB;\n        vec3 col = vec3(0.5);\n        float emit = 0.0;\n        if (V == 4 && mB <= 4) {                       // grid room: tiled walls with dark gaps\n            vec2 g = mB <= 2 ? vec2(h.x + 0.5, -h.z / D) : (mB == 3 ? vec2(-h.z / D, h.y + 0.5) : vec2(h.x + 0.5, h.y + 0.5));\n            vec2 f = fract(g * 4.0);\n            col = wall * mix(0.12, 1.0, step(0.1, f.x) * step(0.1, f.y));\n        } else if (mB == 1) {\n            float pu = h.x * 7.0;\n            col = vec3(0.56, 0.38, 0.22) * (0.82 + 0.3 * rHash(vec2(floor(pu), 1.0)));\n            if (fract(pu) < 0.06) col *= 0.55;\n        } else if (mB == 2) {\n            col = vec3(0.93, 0.92, 0.88);\n        } else if (mB == 3 || mB == 4) {\n            col = h.y < -0.46 ? vec3(0.88, 0.86, 0.82) : wall;\n        } else if (mB == 5) {\n            col = vec3(0.50, 0.32, 0.17);\n        } else if (mB == 6) {\n            col = rPal(rHash(vec2(seed, 5.0)));\n        } else if (mB == 7) {\n            col = vec3(0.93, 0.93, 0.90);\n        } else if (mB == 8) {\n            col = nB.x < -0.5 ? rBooks(h, D, seed) : vec3(0.50, 0.32, 0.17);\n        } else if (mB == 9) {\n            col = rPal(rHash(vec2(seed, 13.0))) * (0.72 + 0.28 * abs(fract(h.x * 11.0) - 0.5) * 2.0);\n        }\n\n        // Door in the middle of the back wall (every room has one)\n        if (mB == 4) {\n            if (V == 3) {                               // double doors with small windows\n                if (abs(h.x) < 0.26 && h.y < 0.2) {\n                    float dx = (h.x + 0.26) / 0.52, dy = (h.y + 0.5) / 0.70;\n                    float lx = fract(dx * 2.0);\n                    col = vec3(0.82, 0.80, 0.76);\n                    if (abs(dx - 0.5) < 0.012 || lx < 0.02 || lx > 0.98) col = vec3(0.25, 0.22, 0.2);\n                    else if (dy < 0.45 && lx > 0.14 && lx < 0.86 && dy > 0.06) col *= 0.88;\n                    if (lx > 0.14 && lx < 0.86 && dy > 0.52 && dy < 0.92) {\n                        vec2 q = vec2((lx - 0.14) / 0.72, (dy - 0.52) / 0.4) * 2.0;\n                        vec2 gq = fract(q);\n                        if (gq.x > 0.1 && gq.x < 0.9 && gq.y > 0.1 && gq.y < 0.9) { col = vec3(0.65, 0.82, 0.98); emit = 1.0; }\n                    }\n                    if (length(vec2(abs(dx - 0.5) - 0.04, dy - 0.42)) < 0.025) col = vec3(0.85, 0.70, 0.20);\n                }\n            } else if (abs(h.x) < 0.14 && h.y < 0.14) {\n                float lx = (h.x + 0.14) / 0.28, ly = (h.y + 0.5) / 0.64;\n                col = vec3(0.45, 0.28, 0.14);\n                bool pan = lx > 0.18 && lx < 0.82 && ((ly > 0.1 && ly < 0.45) || (ly > 0.55 && ly < 0.9));\n                if (pan) col *= 0.82;\n                if (lx < 0.05 || lx > 0.95 || ly > 0.96) col = vec3(0.9, 0.88, 0.84);\n                if (length(vec2(lx - 0.85, ly - 0.48)) < 0.045) col = vec3(0.85, 0.70, 0.20);\n            }\n        }\n\n        float lit = 0.55 + 0.45 * max(dot(normalize(nB), vec3(0.2494, 0.798, 0.5486)), 0.0);\n        lit *= 1.0 - 0.35 * smoothstep(0.0, 2.0, tB);\n        col = emit > 0.5 ? col * 1.1 : col * lit;\n        col = clamp(col, 0.0, 1.0);\n        return col * col;                              // ~gamma 2.0, cheaper than pow()\n    }\n\n    // Window frame around the room\n    vec3 interiorWindow(vec3 pd, vec3 d, float variant, float D, vec3 wall, float seed) {\n        if (max(abs(pd.x), abs(pd.y)) > 0.46) return wall * wall * 0.09;\n        return interiorRoom(pd, d, variant, D, wall, seed);\n    }\n\n\n    vec4 decalTexel(float i, float k) {\n        return DECAL_SAMPLE(uDecalData, vec2((k + 0.5) / 6.0, (i + 0.5) / 64.0));\n    }\n\n    // Returns straight-alpha colour (rgb) and coverage (a) of every decal at a bind-pose point\n    vec4 evalDecals(vec3 p, vec3 n) {\n        vec3 accRGB = vec3(0.0);\n        float accA = 0.0;\n        for (int i = 0; i < 64; i++) {\n            float fi = float(i);\n            if (fi >= uDecalCount) break;\n            vec4 bs = uDecalBounds[i];\n            if (dot(p - bs.xyz, p - bs.xyz) > bs.w * bs.w) continue;\n            vec4 r0 = decalTexel(fi, 0.0);\n            vec4 r1 = decalTexel(fi, 1.0);\n            vec4 r2 = decalTexel(fi, 2.0);\n            vec3 pd = vec3(dot(r0.xyz, p) + r0.w, dot(r1.xyz, p) + r1.w, dot(r2.xyz, p) + r2.w);\n            if (abs(pd.x) > 0.5 || abs(pd.y) > 0.5 || abs(pd.z) > 0.35) continue;\n\n            // Fade out where the surface turns away from the projection direction\n            vec3 nd = vec3(dot(r0.xyz, n), dot(r1.xyz, n), dot(r2.xyz, n));\n            float facing = smoothstep(0.25, 0.6, nd.z / max(length(nd), 1e-4));\n            if (facing <= 0.0) continue;\n\n            vec4 pm = decalTexel(fi, 3.0);   // atlas col, atlas row, flip, tintable\n            vec4 tn = decalTexel(fi, 4.0);   // tint rgb, opacity\n            vec4 ex = decalTexel(fi, 5.0);   // interior: 1, room id, depth, seed\n            float k = facing * tn.a;\n            vec3 pc;\n            float a;\n            if (ex.x > 0.5) {\n                // Interior: view ray from the camera, expressed in decal space\n                vec3 dl = normalize(p - uLocalCam);\n                vec3 dd = vec3(dot(r0.xyz, dl), dot(r1.xyz, dl), dot(r2.xyz, dl));\n                vec3 pdr = pd;\n                if (pm.z > 0.5) { pdr.x = -pdr.x; dd.x = -dd.x; }\n                dd = normalize(dd);\n                if (dd.z > -0.04) continue;      // grazing: the ray would run along the wall\n                pc = interiorWindow(pdr, dd, ex.y, ex.z, tn.rgb, ex.w) * k;\n                a = k;\n                gDecalGlow = gDecalGlow * (1.0 - a) + 0.9 * a;\n            } else {\n                vec2 uv = pd.xy + 0.5;\n                if (pm.z > 0.5) uv.x = 1.0 - uv.x;\n                uv = clamp(uv, 0.002, 0.998);\n                vec2 auv = vec2((pm.x + uv.x) / 8.0, 1.0 - (pm.y + 1.0 - uv.y) / 16.0);\n                vec4 s = DECAL_SAMPLE(uDecalAtlas, auv);   // premultiplied alpha\n\n                if (uPixelOut > 0.5) {\n                    // PIXEL ART MODE: ink survives at any size. A line or a dot thinner than a pixel misses a single\n                    // centre sample, so the whole footprint of the pixel is searched (a 4 x 4 grid): any dark ink in it\n                    // makes the pixel solid ink; a highlight stays only where the pixel's centre is on it; anything else\n                    // is the centre colour, solid or gone (no half-covered blur).\n                    // past the line boost distance (a view preference), the search spreads up to twice the pixel's\n                    // area: far-away lines are still caught, and drawn bolder\n                    float camDist = length(p - uLocalCam);\n                    float grow = 1.0 + clamp((camDist - uDecalBoostDist) * 0.25, 0.0, 1.0);\n                    vec2 fx = dFdx(auv) * grow, fy = dFdy(auv) * grow;\n                    // the samples stay inside this decal's cell of the atlas (its neighbours' art is right next to it)\n                    vec2 cellLo = vec2(pm.x / 8.0, 1.0 - (pm.y + 1.0) / 16.0);\n                    vec2 cellHi = vec2((pm.x + 1.0) / 8.0, 1.0 - pm.y / 16.0);\n                    vec2 pad = vec2(0.002 / 8.0, 0.002 / 16.0);\n                    float minL = 1.0, inkA = 0.0;\n                    vec3 inkRGB = vec3(0.0);\n                    for (int gy = 0; gy < 4; gy++) {\n                        for (int gx = 0; gx < 4; gx++) {\n                            vec2 o = (vec2(float(gx), float(gy)) - 1.5) * 0.25;\n                            vec4 t = DECAL_SAMPLE(uDecalAtlas, clamp(auv + fx * o.x + fy * o.y, cellLo + pad, cellHi - pad));\n                            if (t.a < 0.35) continue;\n                            // judged as drawn: a tintable art (a mouth) is white in the atlas and tinted when drawn\n                            vec3 c = t.rgb / t.a;\n                            float l = dot(pm.w > 0.5 ? c * tn.rgb : c, vec3(0.299, 0.587, 0.114));\n                            if (l < minL) { minL = l; inkRGB = c; inkA = t.a; }\n                        }\n                    }\n                    float lC = s.a > 0.01 ? dot(pm.w > 0.5 ? s.rgb / s.a * tn.rgb : s.rgb / s.a, vec3(0.299, 0.587, 0.114)) : 0.5;\n                    if (s.a > 0.35 && lC > 0.8) {\n                        s = vec4(1.0);                         // the centre is on a highlight: keep it\n                    } else if (minL < 0.22 && inkA > 0.0) {\n                        s = vec4(inkRGB, 1.0);                 // dark ink anywhere in the pixel: solid ink\n                    } else if (s.a > 0.35) {\n                        s = vec4(s.rgb / s.a, 1.0);            // the centre's colour, solid\n                    } else {\n                        s = vec4(0.0);                         // a colour fill only touching the pixel's edge\n                    }\n                } else {\n                    // NORMAL 3D MODE: Distance boost\n                    float camDist = length(p - uLocalCam);\n                    if (camDist > uDecalBoostDist && s.a > 0.01) {\n                        float intensity = max(s.r, max(s.g, s.b)) / s.a;\n                        float isDark = 1.0 - smoothstep(0.0, 0.25, intensity);\n                        float boost = 1.0 + isDark * clamp((camDist - uDecalBoostDist) * 0.5, 0.0, 8.0);\n                        s.rgb = clamp(s.rgb * boost, 0.0, 1.0);\n                        s.a = clamp(s.a * boost, 0.0, 1.0);\n                    }\n                }\n\n                pc = (pm.w > 0.5 ? s.rgb * tn.rgb : s.rgb) * k;\n                a = s.a * k;\n                gDecalGlow *= (1.0 - a);\n            }\n            accRGB = pc + accRGB * (1.0 - a);\n            accA = a + accA * (1.0 - a);\n        }\n        return vec4(accRGB / max(accA, 1e-4), accA);\n    }\n";