npm - worldorbit - Versions diffs - 2.5.1-5.2 - Mend

worldorbit 2.5.1-5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (117) hide show

package/LICENSE.md +5 -0
package/README.md +468 -0
package/dist/browser/core/dist/index.js +4009 -0
package/dist/browser/markdown/dist/index.js +3951 -0
package/dist/browser/viewer/dist/index.js +5981 -0
package/dist/constants.d.ts +8 -0
package/dist/constants.js +84 -0
package/dist/errors.d.ts +7 -0
package/dist/errors.js +16 -0
package/dist/index.d.ts +18 -0
package/dist/index.js +25 -0
package/dist/normalize.d.ts +2 -0
package/dist/normalize.js +243 -0
package/dist/parse.d.ts +2 -0
package/dist/parse.js +126 -0
package/dist/render.d.ts +6 -0
package/dist/render.js +683 -0
package/dist/tokenize.d.ts +4 -0
package/dist/tokenize.js +68 -0
package/dist/types.d.ts +208 -0
package/dist/types.js +1 -0
package/dist/unpkg/core/dist/index.js +4081 -0
package/dist/unpkg/markdown/dist/index.js +3979 -0
package/dist/unpkg/viewer/dist/index.js +6038 -0
package/dist/unpkg/worldorbit-core.min.js +12 -0
package/dist/unpkg/worldorbit-markdown.min.js +95 -0
package/dist/unpkg/worldorbit-viewer.min.js +251 -0
package/dist/unpkg/worldorbit.d.ts +2 -0
package/dist/unpkg/worldorbit.esm.js +2 -0
package/dist/unpkg/worldorbit.js +8524 -0
package/dist/unpkg/worldorbit.min.js +255 -0
package/dist/validate.d.ts +2 -0
package/dist/validate.js +31 -0
package/dist/viewer-state.d.ts +16 -0
package/dist/viewer-state.js +130 -0
package/dist/viewer.d.ts +2 -0
package/dist/viewer.js +434 -0
package/package.json +68 -0
package/packages/core/README.md +17 -0
package/packages/core/dist/atlas-edit.d.ts +11 -0
package/packages/core/dist/atlas-edit.js +273 -0
package/packages/core/dist/atlas-utils.d.ts +22 -0
package/packages/core/dist/atlas-utils.js +189 -0
package/packages/core/dist/atlas-validate.d.ts +2 -0
package/packages/core/dist/atlas-validate.js +285 -0
package/packages/core/dist/diagnostics.d.ts +10 -0
package/packages/core/dist/diagnostics.js +109 -0
package/packages/core/dist/draft-parse.d.ts +3 -0
package/packages/core/dist/draft-parse.js +1275 -0
package/packages/core/dist/draft.d.ts +18 -0
package/packages/core/dist/draft.js +387 -0
package/packages/core/dist/errors.d.ts +7 -0
package/packages/core/dist/errors.js +16 -0
package/packages/core/dist/format.d.ts +4 -0
package/packages/core/dist/format.js +520 -0
package/packages/core/dist/index.d.ts +28 -0
package/packages/core/dist/index.js +44 -0
package/packages/core/dist/load.d.ts +4 -0
package/packages/core/dist/load.js +175 -0
package/packages/core/dist/markdown.d.ts +2 -0
package/packages/core/dist/markdown.js +37 -0
package/packages/core/dist/normalize.d.ts +2 -0
package/packages/core/dist/normalize.js +311 -0
package/packages/core/dist/parse.d.ts +2 -0
package/packages/core/dist/parse.js +133 -0
package/packages/core/dist/scene.d.ts +3 -0
package/packages/core/dist/scene.js +1565 -0
package/packages/core/dist/schema.d.ts +8 -0
package/packages/core/dist/schema.js +298 -0
package/packages/core/dist/tokenize.d.ts +4 -0
package/packages/core/dist/tokenize.js +68 -0
package/packages/core/dist/types.d.ts +476 -0
package/packages/core/dist/types.js +1 -0
package/packages/core/dist/validate.d.ts +2 -0
package/packages/core/dist/validate.js +56 -0
package/packages/editor/dist/editor.d.ts +2 -0
package/packages/editor/dist/editor.js +3042 -0
package/packages/editor/dist/index.d.ts +2 -0
package/packages/editor/dist/index.js +1 -0
package/packages/editor/dist/types.d.ts +53 -0
package/packages/editor/dist/types.js +1 -0
package/packages/markdown/README.md +9 -0
package/packages/markdown/dist/html.d.ts +3 -0
package/packages/markdown/dist/html.js +57 -0
package/packages/markdown/dist/index.d.ts +4 -0
package/packages/markdown/dist/index.js +3 -0
package/packages/markdown/dist/rehype.d.ts +10 -0
package/packages/markdown/dist/rehype.js +49 -0
package/packages/markdown/dist/remark.d.ts +9 -0
package/packages/markdown/dist/remark.js +28 -0
package/packages/markdown/dist/types.d.ts +11 -0
package/packages/markdown/dist/types.js +1 -0
package/packages/viewer/README.md +13 -0
package/packages/viewer/dist/atlas-state.d.ts +12 -0
package/packages/viewer/dist/atlas-state.js +257 -0
package/packages/viewer/dist/atlas-viewer.d.ts +2 -0
package/packages/viewer/dist/atlas-viewer.js +482 -0
package/packages/viewer/dist/custom-element.d.ts +1 -0
package/packages/viewer/dist/custom-element.js +64 -0
package/packages/viewer/dist/embed.d.ts +20 -0
package/packages/viewer/dist/embed.js +138 -0
package/packages/viewer/dist/index.d.ts +9 -0
package/packages/viewer/dist/index.js +8 -0
package/packages/viewer/dist/minimap.d.ts +3 -0
package/packages/viewer/dist/minimap.js +63 -0
package/packages/viewer/dist/render.d.ts +6 -0
package/packages/viewer/dist/render.js +641 -0
package/packages/viewer/dist/theme.d.ts +4 -0
package/packages/viewer/dist/theme.js +102 -0
package/packages/viewer/dist/tooltip.d.ts +3 -0
package/packages/viewer/dist/tooltip.js +189 -0
package/packages/viewer/dist/types.d.ts +263 -0
package/packages/viewer/dist/types.js +1 -0
package/packages/viewer/dist/viewer-state.d.ts +19 -0
package/packages/viewer/dist/viewer-state.js +162 -0
package/packages/viewer/dist/viewer.d.ts +2 -0
package/packages/viewer/dist/viewer.js +1175 -0

package/LICENSE.md ADDED Viewed

@@ -0,0 +1,5 @@
+Copyright 2026 Hanjo Winter
+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.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,468 @@
+# WorldOrbit
+WorldOrbit is a text-first DSL, viewer, and optional editor platform for fictional orbital systems.
+It is designed as a specialized Mermaid-like alternative for worldbuilding: you can describe stellar systems in plain text, embed them in Markdown, render them as static diagrams, or explore them interactively with pan, rotate, zoom, and object tooltips.
+WorldOrbit is built for:
+- worldbuilding projects
+- Markdown-based lore repositories and CMS setups
+- fictional atlases and codices
+- interactive setting documentation
+- browser-based orbital diagram tooling
+## Why WorldOrbit?
+Generic diagram tools can show relationships, but they are not built for fictional orbital systems.
+WorldOrbit is designed specifically for:
+- stars, planets, moons, belts, structures, and phenomena
+- orbit-aware layouts instead of generic node graphs
+- Markdown-native embedding
+- optional interactivity
+- optional visual authoring through Studio
+WorldOrbit is not intended to be a real-world astronomy simulator or a high-precision astrophysics engine. Its goal is clear, expressive orbital worldbuilding that works well in content workflows.
+## Quick Example
+```worldorbit
+schema 2.1
+system Iyath
+  title "Iyath System"
+  epoch "JY-0001.0"
+  referencePlane ecliptic
+defaults
+  view isometric
+  scale presentation
+  preset atlas-card
+  theme atlas
+group inner-system
+  label "Inner System"
+  color #d9b37a
+object star Iyath
+object planet Naar
+  orbit Iyath
+  semiMajor 1.18au
+  eccentricity 0.08
+  angle 28deg
+  inclination 24deg
+  phase 42deg
+  atmosphere nitrogen-oxygen
+  groups inner-system
+````
+## Installation
+### npm
+```bash
+npm install worldorbit
+```
+### What the `worldorbit` package contains
+The published `worldorbit` package is the public entry point.
+It includes:
+* the browser bundles
+* subpath exports for core modules
+* the packages used by the viewer, Markdown integration, and editor tooling
+So for most users, this is enough:
+```bash
+npm install worldorbit
+```
+And then:
+```ts
+import { parse, loadWorldOrbitSource } from "worldorbit";
+import * as Viewer from "worldorbit/viewer";
+```
+## Browser / CDN Quick Setup
+For direct browser usage, use the browser bundle:
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <script src="https://unpkg.com/worldorbit/dist/unpkg/worldorbit.min.js"></script>
+    <style>
+      html, body {
+        margin: 0;
+        width: 100%;
+        height: 100%;
+      }
+      #view {
+        width: 100vw;
+        height: 100vh;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="view"></div>
+    <script>
+      const source = `
+schema 2.1
+system Iyath
+  epoch "JY-0001.0"
+object star Iyath
+object planet Naar
+  orbit Iyath
+  semiMajor 1.18au
+`.trim();
+      const loaded = WorldOrbit.loadWorldOrbitSource(source);
+      WorldOrbit.createInteractiveViewer(document.getElementById("view"), {
+        document: loaded.document
+      });
+    </script>
+  </body>
+</html>
+```
+For browser usage, `worldorbit.min.js` is the recommended public entry point.
+## Static and Interactive Rendering
+WorldOrbit can be used in different ways from the same source:
+* as a static diagram
+* as an interactive SVG viewer
+* inside Markdown pipelines
+* inside the optional Studio editor
+This means the same WorldOrbit document can be:
+* written in plain text
+* embedded in Markdown
+* rendered in a documentation page
+* explored interactively
+* edited visually if needed
+## Studio Editor
+WorldOrbit includes an optional Studio editor for easier authoring and exploration.
+Studio is useful when you want:
+* visual placement editing
+* source and preview side by side
+* inspector-based editing
+* faster onboarding for non-technical users
+The editor is optional. The core format remains text-first.
+## Canonical Schema
+New atlas authoring should start with:
+```worldorbit
+schema 2.1
+```
+Example:
+```worldorbit
+schema 2.1
+system Iyath
+  title "Iyath System"
+  epoch "JY-0001.0"
+  referencePlane ecliptic
+defaults
+  view isometric
+  scale presentation
+  preset atlas-card
+  theme atlas
+group inner-system
+  label "Inner System"
+  summary "Naar and its inhabited infrastructure"
+  color #d9b37a
+viewpoint overview
+  label "Atlas Overview"
+  summary "Fit the whole system."
+  projection isometric
+  filter
+    groups inner-system
+annotation naar-notes
+  label "Naar Notes"
+  target Naar
+  body "Heimatwelt der Enari."
+object star Iyath
+  mass 1.02sol
+object planet Naar
+  orbit Iyath
+  semiMajor 1.18au
+  eccentricity 0.08
+  angle 28deg
+  inclination 24deg
+  phase 42deg
+  groups inner-system
+  image /demo/assets/naar-map.png
+  atmosphere nitrogen-oxygen
+```
+Schema `2.1` adds comments, semantic `group` and `relation` sections, object-level `epoch` and `referencePlane`, declarative resonance and validation hints, and optional structured lore blocks such as `climate`, `habitability`, and `settlement`.
+Stable `1.0` source is still accepted. Canonical `schema 2.0` source remains fully supported, and legacy `schema 2.0-draft` files stay readable as a compatibility path with a deprecation diagnostic.
+## Basic Usage
+### Parse and load source
+```ts
+import {
+  loadWorldOrbitSource,
+  parse,
+} from "worldorbit";
+const parsed = parse(`
+system Iyath
+star Iyath
+planet Naar orbit Iyath distance 1.18au
+`.trim());
+const loaded = loadWorldOrbitSource(`
+schema 2.1
+system Iyath
+object star Iyath
+object planet Naar
+  orbit Iyath
+  semiMajor 1.18au
+`.trim());
+```
+### Render a scene
+```ts
+import {
+  loadWorldOrbitSource,
+  renderDocumentToScene,
+} from "worldorbit";
+const loaded = loadWorldOrbitSource(source);
+const scene = renderDocumentToScene(loaded.document, {
+  projection: "isometric",
+  scaleModel: {
+    orbitDistanceMultiplier: 1.1,
+    bodyRadiusMultiplier: 1.15,
+  },
+});
+```
+### Create an interactive viewer
+```ts
+import { loadWorldOrbitSource } from "worldorbit";
+import { createInteractiveViewer } from "worldorbit/viewer";
+const loaded = loadWorldOrbitSource(source);
+createInteractiveViewer(document.getElementById("preview"), {
+  document: loaded.document,
+  projection: "isometric",
+  theme: "atlas",
+});
+```
+## Package Overview
+WorldOrbit is organized internally as a small ecosystem.
+### `worldorbit`
+Public package entry point with browser bundles and main exports.
+### `worldorbit/core`
+Use this when you need:
+* parsing
+* normalization
+* validation
+* diagnostics
+* schema loading
+* canonical formatting
+* scene generation
+### `worldorbit/viewer`
+Use this when you need:
+* static SVG rendering
+* interactive viewing
+* atlas-style exploration
+* themes and embeds
+### `worldorbit/markdown`
+Use this when you want to transform fenced `worldorbit` blocks inside Markdown pipelines.
+### `worldorbit/editor`
+Use this when you want browser-based visual authoring on top of the text format.
+## Core Example
+```ts
+import {
+  formatDocument,
+  loadWorldOrbitSource,
+  parse,
+  parseWorldOrbitAtlas,
+  renderDocumentToScene,
+  upgradeDocumentToV2,
+} from "worldorbit/core";
+const stable = parse(`
+system Iyath
+star Iyath
+planet Naar orbit Iyath distance 1.18au
+`.trim());
+const atlasDocument = upgradeDocumentToV2(stable.document, {
+  preset: "atlas-card",
+});
+const atlasSource = formatDocument(atlasDocument, { schema: "2.1" });
+const loaded = loadWorldOrbitSource(atlasSource);
+const parsedAtlas = parseWorldOrbitAtlas(atlasSource);
+const scene = renderDocumentToScene(loaded.document, {
+  projection: "isometric",
+  scaleModel: {
+    orbitDistanceMultiplier: 1.1,
+    bodyRadiusMultiplier: 1.15,
+  },
+});
+```
+## Viewer Capabilities
+Viewer features in `v2.5` include:
+* scene-based SVG rendering
+* projections: `topdown` and `isometric`
+* theme presets: `atlas`, `nightglass`, `ember`
+* layer controls for background, guides, orbits, objects, labels, metadata, and relations
+* selection, hover, focus, fit, pan, zoom, and rotate
+* tooltip cards and object detail payloads
+* viewpoints, filters, search, and bookmark capture
+* deep-linkable atlas state
+* embeddable viewer custom elements
+* semantic group filters, relation overlays, and schema 2.1 detail metadata
+## Markdown Integration
+Use `worldorbit/markdown` to transform fenced `worldorbit` blocks into static or interactive output.
+```ts
+import rehypeStringify from "rehype-stringify";
+import remarkParse from "remark-parse";
+import remarkRehype from "remark-rehype";
+import { unified } from "unified";
+import { remarkWorldOrbit } from "worldorbit/markdown";
+const html = String(
+  await unified()
+    .use(remarkParse)
+    .use(remarkWorldOrbit, { mode: "interactive" })
+    .use(remarkRehype, { allowDangerousHtml: true })
+    .use(rehypeStringify, { allowDangerousHtml: true })
+    .process(markdownSource),
+);
+```
+In the browser:
+```ts
+import { mountWorldOrbitEmbeds } from "worldorbit/viewer";
+mountWorldOrbitEmbeds(document, {
+  mode: "interactive",
+});
+```
+## Examples
+Examples live in:
+* [examples/minimal.worldorbit](./examples/minimal.worldorbit)
+* [examples/iyath.worldorbit](./examples/iyath.worldorbit)
+* [examples/iyath.schema2.worldorbit](./examples/iyath.schema2.worldorbit)
+* [examples/iyath.schema21.worldorbit](./examples/iyath.schema21.worldorbit)
+* [examples/iyath.schema2-draft.worldorbit](./examples/iyath.schema2-draft.worldorbit)
+* [examples/markdown/static.md](./examples/markdown/static.md)
+* [examples/markdown/interactive.md](./examples/markdown/interactive.md)
+* [examples/markdown/build.mjs](./examples/markdown/build.mjs)
+Browser-facing examples and demos live in the repository under `demo/`, `studio/`, and `examples/`.
+## Documentation
+* [migration guide: v0.8 to v1.0](./docs/migration-v0.8-to-v1.0.md)
+* [migration guide: v1 to v2](./docs/migration-v1-to-v2.md)
+* [migration guide: v2.0 to v2.1](./docs/migration-v2-to-v2.1.md)
+* [language reference](./docs/language-reference.md)
+* [language reference (DE)](./docs/language-reference.de.md)
+* [API inventory](./docs/api-inventory.md)
+* [changelog](./docs/changelog.md)
+## Development
+```bash
+npm install
+npm run build
+npm test
+```
+The workspace builds outputs into package-specific distribution folders and browser bundles.
+Useful notes:
+* `npm run build` compiles all packages and refreshes local package shims
+* `npm test` rebuilds first, then runs the regression suite
+* the repository remains parser-first: rendering and atlas interaction stay downstream of parse, normalize, and validate
+## Project Direction
+WorldOrbit is intended as a specialized Mermaid-like solution for fictional orbital systems.
+The long-term focus is:
+* strong text-first authoring
+* clean Markdown embedding
+* rich static and interactive rendering
+* optional visual editing
+* stable schema evolution over time
+## License
+MIT