@onlyworlds/sdk 4.53.3 → 4.54.0

package/AGENTS.md

@@ -1,6 +1,6 @@
 # For AI agents using @onlyworlds/sdk
 
-**Current as of**: SDK **4.x** · schema-dist **v0.32.2-dist.42** (canonical 00.32.02).
+**Current as of**: SDK **4.x** · schema-dist **v0.33.0-dist.43** (canonical 00.33.00).
 This line is asserted by `codegen:check` in CI — if the pin moves and this file is not
 re-read against it, the check fails rather than letting this document rot quietly.
 

package/CHANGELOG.md

@@ -5,6 +5,16 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.54.0] - 2026-10-22
+
+### Added
+
+- **`Zone.shape`** (canonical 00.33.00, a minor step of the standard): a string in Zone's Scope section beside `role`, saying how the zone's markers are joined. `"polygon"` is a closed area (the last marker joins the first), `"line"` an open path drawn in marker order; lowercase. Empty, absent or any other value means not stated, and a reader draws a polygon. Generated as `shape?: string` on `ZoneV2`, `FIELD_SCHEMA.zone.shape` (`{ type: 'text' }`), and in Zone's `Scope` entry of `ELEMENT_SECTIONS`. `ONLYWORLDS_VERSION` is `'00.33.00'`.
+
+### Changed
+
+- **Schema repinned to schema-dist v0.33.0-dist.43** (canonical 00.33.00). Only `schema/zone.yaml` and `schema.json` moved, by the one field; `VERSION`, `README.md`, `example/world-export.json` and `MANIFEST.json` carry the new version; nothing else.
+
 ## [4.53.3] - 2026-10-22
 
 ### Changed

package/SCHEMA.md

@@ -1,6 +1,6 @@
 # OnlyWorlds Schema Reference
 
-**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.2-dist.42** — canonical schema **00.32.02**, published 2026-10-22.
+**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.33.0-dist.43** — canonical schema **00.33.00**, published 2026-10-22.
 
 GENERATED from the canonical schema YAML — do not hand-edit (regenerate: `python codegen/generate_types.py`).
 Written for both humans and AI agents reading this package locally.
@@ -619,6 +619,7 @@ Families (colour semantics; icon carries the type): agents · world · abstract
 ### Scope
 
 - `role` (text) — The operational function or intent of the zone
+- `shape` (text) — How the zone's markers are joined: polygon (a closed area: the last marker joins the first) or line (an open path, drawn in marker order). Lowercase. Empty, absent, or any other value means the shape is not stated, and a reader draws a polygon
 - `start_date` (integer) — Date when the zone becomes extant or relevant, defined in world TIME units
 - `end_date` (integer) — Date when the zone ceases to be meaningful or enforced, defined in world TIME units
 - `phenomena` (multi link → phenomenon) — Phenomena that affect, define, or occur within the zone

package/dist/index.d.ts

@@ -42,7 +42,7 @@ type ElementType = 'ability' | 'character' | 'collective' | 'construct' | 'creat
 declare const ELEMENT_TYPES: ElementType[];
 /** Canonical OnlyWorlds schema version. Source: the `canonical:` value of the pinned
  *  distribution's VERSION file (see the provenance block at the top of this file). */
-declare const ONLYWORLDS_VERSION: "00.32.02";
+declare const ONLYWORLDS_VERSION: "00.33.00";
 /** The four semantic families (colour carries the family; ELEMENT_ICONS carries the type). */
 type ElementFamily = 'agents' | 'world' | 'abstract' | 'temporal';
 /** Per-type semantic family. Source: the distribution's `presentation.json` sidecar
@@ -1848,6 +1848,9 @@ declare const FIELD_SCHEMA: {
         readonly role: {
             readonly type: "text";
         };
+        readonly shape: {
+            readonly type: "text";
+        };
         readonly start_date: {
             readonly type: "integer";
         };

package/dist/index.js

@@ -1680,7 +1680,7 @@ function buildQuery(params) {
 
 // src/v2/types.generated.ts
 var ELEMENT_TYPES = ["ability", "character", "collective", "construct", "creature", "event", "family", "institution", "language", "law", "location", "map", "marker", "narrative", "object", "phenomenon", "pin", "relation", "species", "title", "trait", "zone"];
-var ONLYWORLDS_VERSION = "00.32.02";
+var ONLYWORLDS_VERSION = "00.33.00";
 var ELEMENT_FAMILIES = {
   ability: "abstract",
   character: "agents",
@@ -1852,7 +1852,7 @@ var ELEMENT_SECTIONS = {
     { name: "World", order: 3, fields: ["significance", "anti_trait", "empowered_abilities"] }
   ],
   zone: [
-    { name: "Scope", order: 1, fields: ["role", "start_date", "end_date", "phenomena", "linked_zones"] },
+    { name: "Scope", order: 1, fields: ["role", "shape", "start_date", "end_date", "phenomena", "linked_zones"] },
     { name: "World", order: 2, fields: ["context", "populations", "titles", "principles"] }
   ]
 };
@@ -2436,6 +2436,7 @@ var FIELD_SCHEMA = {
     image_url: { type: "text", required: false },
     // Scope
     role: { type: "text" },
+    shape: { type: "text" },
     start_date: { type: "integer" },
     end_date: { type: "integer" },
     phenomena: { type: "multi_link", target: "phenomenon" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "4.53.3",
+  "version": "4.54.0",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {