Skip to content

Commit b2d9535

Browse files
tmoostingclaude
andcommitted
0.83.0: schema-dist serial 84, reading_aid_of
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent d061a48 commit b2d9535

3 files changed

Lines changed: 4 additions & 2 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ The package version runs on its own semver; the schema it is generated from is `
44

55
## Unreleased
66

7+
## 0.83.0 (2026-10-28)
8+
79
- **`reading_aid_of(element)`**: which reading aid an element's type and supertype make it, `"charter"`, `"guide"` or `"domain"` (trimmed and compared without regard to case, the whole word), else `None`; a body or a `FolderElement`. It ignores the mark `x_charter_of`, so a tool can offer the right mark on an unmarked element; whether an element is a reading aid, the pair and the mark, is still `is_charter_element`. The npm SDK's `readingAidOf` is the same reader.
810
- **Schema repinned to schema-dist `v0.33.0-dist.84`** (from dist.83; the same canonical 00.33.00, so `SCHEMA_VERSION` stays and no element field moved; the folder lint and `FORMAT_VERSION` stay at 0.3.20). Serial 84 adds four lens cases, a lens reached by a hop served whole to the owner and, to a contributor, a guest and the public reader, without its hidden anchor and every note keyed to a hidden element, and one charter case, a Guide held only as a stub; the lens fixture holds 151 cases (75 resolve, 37 graph), the charter fixture 23, every one passing with no reader change. The room, checks and spine profiles gain the folder format's re-key line, and the spine profile the line that an editor shows `x_spine_` keys read-only; nothing in this package restates either.
911

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -302,7 +302,7 @@ from onlyworlds import is_room_element
302302
lore = [el for el in folder.all_elements().values() if not is_room_element(el)]
303303
```
304304

305-
A lore view (a list, a count, search, a graph, a story's context, a survey) leaves room elements out unless the person asks; the room's own views show them whole, and a writer writes them like any element. The world's charter (a Law with supertype `Charter`), its guide and its domains (Constructs with supertype `Guide` or `Domain`) are reading aids when they carry the mark `x_charter_of`, the id of the world they belong to: `onlyworlds.is_charter_element(element)` is true for one (pair and mark, matched as `is_room_element` matches). A tool's front door shows them first and a lore view leaves them out; the pair without the mark is lore (a kingdom's Charter in a novel's world). A reading aid is not a room element. The profile: [`profiles/room.md`](https://github.com/OnlyWorlds/schema-dist/blob/main/profiles/room.md) in the schema distribution. Both marks, `x_room_of` and `x_charter_of`, are read by presence: any value but `None` counts, a string only when something is left after trimming it.
305+
A lore view (a list, a count, search, a graph, a story's context, a survey) leaves room elements out unless the person asks; the room's own views show them whole, and a writer writes them like any element. The world's charter (a Law with supertype `Charter`), its guide and its domains (Constructs with supertype `Guide` or `Domain`) are reading aids when they carry the mark `x_charter_of`, the id of the world they belong to: `onlyworlds.is_charter_element(element)` is true for one (pair and mark, matched as `is_room_element` matches). A tool's front door shows them first and a lore view leaves them out; the pair without the mark is lore (a kingdom's Charter in a novel's world). A reading aid is not a room element. `onlyworlds.reading_aid_of(element)` reads the pair alone, mark or not, and answers `"charter"`, `"guide"`, `"domain"` or `None`: which aid a tool would offer to mark it as. The profile: [`profiles/room.md`](https://github.com/OnlyWorlds/schema-dist/blob/main/profiles/room.md) in the schema distribution. Both marks, `x_room_of` and `x_charter_of`, are read by presence: any value but `None` counts, a string only when something is left after trimming it.
306306

307307
`charter_of(world, reader)` reads the three aids as one reader sees them, the packet a front door shows first: `{charter, guide, domains}`. `charter` is the newest marked Charter (`{id, name, rules, skill}`: its `x_checks_rules` as stored, and the Objects its text names, by any `ow://` form, a site address or a bare id, that the reader sees, at most five), `guide` the newest marked Guide (`{id, name}`), and `domains` every marked Domain the reader sees (`{id, name, sentence, hubs}`), in the Guide's order first, then by name. `domains_of(world, reader)` is the list alone. The world and the reader are the lens reader's (below); a world open to anyone carries `open: True`, and a public reader of any other world reads nothing. The API serves the same packet as `reading_aids` on `GET /me`. The profile: [`profiles/charter.md`](https://github.com/OnlyWorlds/schema-dist/blob/main/profiles/charter.md).
308308

‎src/onlyworlds/_version.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
__version__ = "0.82.1"
1+
__version__ = "0.83.0"

0 commit comments

Comments
 (0)