@onlyworlds/sdk 4.131.0 → 4.132.0

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.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,17 @@ earlier history lives in git log only.
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [4.132.0] - 2026-11-03
9
+
10
+ ### Added
11
+
12
+ - **A tool that opens one kind of element is offered only on that kind.** The tools list's `open` gains `element_types`, the element types its element door opens (type words such as `character`), or `null` for every type. On an element's menu, `openersFor` leaves out a row whose `element_types` does not hold the address's type word, whether or not the row has a world door: the tool opens other kinds, so its world is not offered from this element either. The type is read from the address, so no element body is needed; a world's menu reads no element types. `OwToolOpen.element_types` is typed. Refused by name, as a row that is not one: a word outside the 22, an empty list, a repeat, and `element_types` on a row with no element door. A list without the key reads as before.
13
+ - `TOOLS` repinned at the tools list's `d0e52c4`, where every row carries `element_types: null`: no menu changes. The shared openers fixture has 100 cases (from 92), the same bytes as the Python package's.
14
+
15
+ ### Tests
16
+
17
+ - The shared openers fixture's 24 type refusals each name their kind beside the name: `unknown_key` (a key the object does not take, refused by name) or `bad_value` (a key it takes whose value it refuses). Each package's test tells the two apart by its own message, so a reader that refuses a known key as unknown, or the other way round, fails the case where before the name alone passed it. The same bytes in both packages; nothing shipped changes.
18
+
8
19
  ## [4.131.0] - 2026-11-03
9
20
 
10
21
  ### Added
@@ -1358,11 +1358,17 @@ function openersFor(tools, kind, address, surface, options = {}) {
1358
1358
  fail(`tool ${r.id}: open.element_skips is a list of ${ELEMENT_MARKS.join(", ")}; got ${JSON.stringify(o.element_skips)}`);
1359
1359
  }
1360
1360
  if (elementDoor === null && skips.length > 0) fail(`tool ${r.id}: open.element_skips names what an element door leaves out, and the row has none`);
1361
+ const types = o.element_types === void 0 ? null : o.element_types;
1362
+ if (types !== null && (!Array.isArray(types) || types.length === 0 || new Set(types).size !== types.length || types.some((t) => !ELEMENT_TYPES.includes(t)))) {
1363
+ fail(`tool ${r.id}: open.element_types is null or a non-empty list of distinct type words (${ELEMENT_TYPES.join(", ")}); got ${JSON.stringify(o.element_types)}`);
1364
+ }
1365
+ if (elementDoor === null && types !== null) fail(`tool ${r.id}: open.element_types names what an element door opens, and the row has none`);
1361
1366
  if (r.rung !== "listed") continue;
1362
1367
  if (audience === "public" && needs === "device") continue;
1363
1368
  const template = kind === "element" ? elementDoor ?? worldDoor : worldDoor;
1364
1369
  if (template === null) continue;
1365
1370
  if (kind === "element" && marks.some((m) => skips.includes(m))) continue;
1371
+ if (kind === "element" && types !== null && !types.includes(type)) continue;
1366
1372
  const href = fill(template);
1367
1373
  let state = null;
1368
1374
  if (tool !== null && r.client === tool) state = "You are here";
@@ -1389,7 +1395,8 @@ var TOOLS = [
1389
1395
  "world": "https://atlas.onlyworlds.com/#/open/{world}",
1390
1396
  "element": "https://atlas.onlyworlds.com/#/open/{world}/element/{id}",
1391
1397
  "needs": "account",
1392
- "element_skips": []
1398
+ "element_skips": [],
1399
+ "element_types": null
1393
1400
  }
1394
1401
  },
1395
1402
  {
@@ -1402,7 +1409,8 @@ var TOOLS = [
1402
1409
  "world": "https://lantern.onlyworlds.com/#/open/{world}",
1403
1410
  "element": "https://lantern.onlyworlds.com/#/open/{world}/element/{id}",
1404
1411
  "needs": "account",
1405
- "element_skips": []
1412
+ "element_skips": [],
1413
+ "element_types": null
1406
1414
  }
1407
1415
  },
1408
1416
  {
@@ -1420,7 +1428,8 @@ var TOOLS = [
1420
1428
  "hidden",
1421
1429
  "proposed",
1422
1430
  "map_space"
1423
- ]
1431
+ ],
1432
+ "element_types": null
1424
1433
  }
1425
1434
  },
1426
1435
  {
package/dist/index.d.ts CHANGED
@@ -5914,6 +5914,8 @@ interface OwToolOpen {
5914
5914
  needs: OwToolNeeds | null;
5915
5915
  /** What the element door does not open, in the graph section's words; [] or absent: it opens every element (a list older than the key has none). */
5916
5916
  element_skips?: readonly OwElementMark[];
5917
+ /** The element types the element door opens, as type words (`character`); null or absent: every type (a list older than the key has none). */
5918
+ element_types?: readonly string[] | null;
5917
5919
  }
5918
5920
  /** The keys of one tools list row that `openersFor` reads; a row straight from `tools.json` carries more, and they are ignored. */
5919
5921
  interface OwTool {
@@ -5970,7 +5972,10 @@ interface OwOpener {
5970
5972
  * a world door is a row to its world door that says "Opens the world". On an element given as
5971
5973
  * `options.element`, a row whose `open.element_skips` names a mark the element carries (room, hidden,
5972
5974
  * proposed, map space, a reading aid, each read as `worldGraph` reads it) is not there: its door cannot
5973
- * open it. A world door alone opens the world, so it stays. For the `public` audience (the signed-out
5975
+ * open it. A world door alone opens the world, so it stays. On an element's menu, a row whose
5976
+ * `open.element_types` is a list that does not hold the address's type word is not there either, world
5977
+ * door or not: the tool opens other kinds of element (read from the address, so no element body is needed;
5978
+ * a world's menu reads no element types). For the `public` audience (the signed-out
5974
5979
  * reader) a row whose `open.needs` is `device` is not there, since a visitor's device holds no world of
5975
5980
  * this one's, and a row whose `needs` is `account` is there and says it needs one.
5976
5981
  *
@@ -5992,7 +5997,8 @@ interface OwOpener {
5992
5997
  * rest: a `kind` that is neither, an element's openers asked of an address with no element, an unknown
5993
5998
  * key on the address, the surface or the options, a missing or unknown `audience`, a surface value of the
5994
5999
  * wrong type, an element given for a world's menu or naming another element than the address, a tools row
5995
- * that is not one (a `needs` or an `element_skips` word outside the list's format included).
6000
+ * that is not one (a `needs`, an `element_skips` or an `element_types` word outside the list's format, an
6001
+ * empty `element_types`, or `element_types` on a row with no element door, included).
5996
6002
  */
5997
6003
  declare function openersFor(tools: readonly OwTool[], kind: OwOpenerKind, address: OwAddress | OwAddressReading, surface: OwOpenerSurface, options?: OwOpenersOptions): OwOpener[];
5998
6004
 
package/dist/index.js CHANGED
@@ -42,7 +42,7 @@ import {
42
42
  trimWhiteSpace,
43
43
  typeWord,
44
44
  unknownKey
45
- } from "./chunk-EDU36RUO.js";
45
+ } from "./chunk-2OHW3J42.js";
46
46
 
47
47
  // src/v2/keyed-id.ts
48
48
  var KEYED_IDS = "0199b6a0-6f0e-7c2a-9d1e-3b5c7a8e4f21";
package/dist/waymark.d.ts CHANGED
@@ -13,6 +13,8 @@ interface OwToolOpen {
13
13
  needs: OwToolNeeds | null;
14
14
  /** What the element door does not open, in the graph section's words; [] or absent: it opens every element (a list older than the key has none). */
15
15
  element_skips?: readonly OwElementMark[];
16
+ /** The element types the element door opens, as type words (`character`); null or absent: every type (a list older than the key has none). */
17
+ element_types?: readonly string[] | null;
16
18
  }
17
19
  /** The keys of one tools list row that `openersFor` reads; a row straight from `tools.json` carries more, and they are ignored. */
18
20
  interface OwTool {
package/dist/waymark.js CHANGED
@@ -6,7 +6,7 @@ import {
6
6
  openersFor,
7
7
  refuseUnknownOptions,
8
8
  typeWord
9
- } from "./chunk-EDU36RUO.js";
9
+ } from "./chunk-2OHW3J42.js";
10
10
 
11
11
  // src/waymark/glyphs.ts
12
12
  var MARK_PATH = "M48.8 0.0 43.8 0.4 39.0 1.2 36.0 2.0 33.2 2.9 29.3 4.5 24.8 6.8 20.6 9.5 17.0 12.4 13.6 15.7 10.4 19.4 7.8 23.1 5.8 26.6 4.5 29.3 3.3 32.1 1.8 36.8 0.8 41.2 0.1 46.3 0.0 51.1 0.4 56.2 1.2 61.0 2.0 63.9 2.9 66.8 4.5 70.7 6.8 75.2 9.5 79.4 12.4 82.9 15.7 86.3 19.4 89.5 23.1 92.1 26.6 94.2 29.3 95.5 32.1 96.7 36.8 98.2 41.2 99.2 46.3 99.8 51.1 100.0 56.2 99.6 61.0 98.8 63.9 98.0 66.8 97.1 70.7 95.5 75.2 93.2 79.4 90.4 82.9 87.6 86.3 84.3 89.5 80.5 92.1 76.9 94.2 73.4 95.5 70.7 96.7 67.9 98.2 63.2 99.2 58.7 99.8 53.7 100.0 48.8 99.6 43.8 98.6 38.4 97.1 33.2 95.5 29.3 93.2 24.8 90.4 20.6 87.6 17.0 84.3 13.6 80.5 10.4 76.9 7.8 73.4 5.8 70.7 4.5 67.9 3.3 63.2 1.8 58.7 0.8 53.7 0.1ZM77.5 80.7 74.1 83.4 70.7 85.7 67.0 87.5 64.5 88.6 64.1 88.7 65.7 86.3 67.1 83.9 68.7 80.7 69.9 77.6 72.7 78.5 73.0 78.4ZM22.5 80.7 25.6 79.0 27.3 78.3 30.0 77.6 31.3 80.7 32.8 83.9 34.2 86.3 35.9 88.7 32.9 87.5 29.3 85.7 25.8 83.4ZM51.2 74.5 55.1 74.7 59.9 75.2 64.2 76.0 67.5 76.9 66.0 80.5 64.2 84.0 62.0 87.4 59.6 90.1 55.1 90.9 52.2 91.2 51.2 91.1ZM48.7 74.5 48.8 91.1 47.7 91.2 44.9 90.9 40.3 90.1 38.2 87.8 36.3 85.0 34.2 81.2 32.5 77.0 35.8 76.0 40.5 75.2 44.5 74.7ZM91.1 51.2 91.1 52.9 90.8 56.3 90.1 59.7 89.3 62.5 88.5 64.8 87.2 67.7 85.7 70.7 83.9 73.4 82.0 75.9 79.4 78.9 76.3 77.2 73.8 76.1 76.2 68.8 77.8 62.7 78.7 56.8 79.0 51.2ZM55.8 51.2 67.7 51.2 67.6 55.1 67.2 59.0 66.7 61.5 65.7 65.0 61.0 64.2 55.7 63.6ZM32.5 51.2 44.5 51.2 44.4 63.6 39.7 64.1 34.5 65.0 33.5 61.3 32.9 58.1 32.5 54.2ZM8.8 51.2 21.0 51.2 21.0 53.3 21.4 56.6 22.7 64.0 23.8 68.4 25.0 72.1 26.6 75.9 23.7 77.2 20.6 78.9 18.5 76.7 16.5 74.1 14.8 71.5 13.4 69.1 12.1 66.3 11.0 63.6 10.1 60.5 9.4 57.3 8.9 53.5 8.8 51.3ZM36.2 27.0 39.5 27.5 44.5 28.2 44.4 48.8 32.4 48.7 32.8 44.5 33.6 39.1 35.0 32.0ZM63.9 26.9 65.2 32.1 66.6 39.2 67.4 44.8 67.7 48.7 55.8 48.8 55.7 28.1 60.5 27.5ZM74.8 23.4 76.9 22.5 79.4 21.1 82.0 24.0 84.8 27.8 86.2 30.3 87.5 32.9 88.6 35.4 89.5 38.1 90.3 41.2 90.8 44.0 91.1 47.0 91.1 48.8 79.0 48.7 78.7 44.6 78.0 39.3 76.5 31.2 74.7 23.5ZM25.5 23.5 25.5 23.7 24.5 26.8 23.7 30.2 22.4 36.6 21.5 42.5 21.1 48.7 8.8 48.8 8.8 47.0 9.2 43.7 9.8 40.8 10.5 38.1 11.5 35.2 12.4 32.9 13.8 30.2 15.2 27.8 17.9 24.0 20.6 21.1 23.1 22.5ZM64.1 11.3 67.0 12.4 70.7 14.3 74.1 16.5 77.5 19.3 75.6 20.3 73.2 21.5 70.0 22.6 68.7 19.2 67.1 16.1 65.7 13.6ZM35.9 11.3 34.2 13.6 32.8 16.1 31.3 19.2 30.0 22.5 27.9 21.9 26.4 21.3 22.5 19.3 25.8 16.5 29.3 14.3 32.9 12.4 35.4 11.4ZM51.2 8.8 52.2 8.8 55.1 9.0 59.6 9.9 61.7 12.2 64.2 16.0 66.0 19.5 67.6 23.3 64.3 24.3 59.4 25.2 56.2 25.6 51.2 25.5ZM48.8 8.8 48.7 25.5 44.2 25.6 40.6 25.2 36.4 24.5 32.4 23.2 33.9 19.5 35.7 16.0 38.2 12.2 40.3 9.9 44.9 9.0 47.7 8.8Z";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@onlyworlds/sdk",
3
- "version": "4.131.0",
3
+ "version": "4.132.0",
4
4
  "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
5
5
  "type": "module",
6
6
  "exports": {