List of Schemas

ApplicationNote

biblioteka/entity/application_note.json

A freeform note attached to any entity for context, commentary, or additional information.

Author

biblioteka/entity/author.json

An authorial identity linked to one or more personas, used to attribute literary works.

Book

biblioteka/entity/book.json

A specific published edition of a literary work, identified by publisher, year, and format. Typically linked to its literary works via contains_work, to its author via authored_by, and to a publisher via published_by. Physical copies are tracked as book_exemplar entities linked via exemplar_of.

Book Exemplar

biblioteka/entity/book_exemplar.json

A physical copy of a book edition, representing an item in the personal library. Linked to its book edition via exemplar_of. Images (covers, pages) attach via has_image. Storage location tracked via located_in. Multiple exemplar_of associations indicate a convolute (multiple books bound together).

Book Series

biblioteka/entity/book_series.json

An open-ended thematic book series published under a common brand or imprint (e.g. Penguin Classics, ЖЗЛ). Books linked via part_of_series with optional seriesNumber. A book can belong to multiple series. Publisher linked via published_by.

Book Set

biblioteka/entity/book_set.json

A fixed-volume publication set grouping multiple books into a numbered collection (e.g. collected works, multi-volume edition). Individual volumes are book entities linked via volume_of with volumeNumber. Publisher linked via published_by.

Ephemera Exemplar

biblioteka/entity/ephemera_exemplar.json

A physical ephemera item in the personal collection, such as a postcard, greeting card, bookmark, newspaper clipping, letter, or photograph. Represents exemplar-level collectible objects. Images attach via has_image. Storage location tracked via located_in.

Literary Work

biblioteka/entity/literary_work.json

An abstract creative work independent of any specific edition or translation. Published editions are tracked as book entities linked via contains_work. Authorship recorded via authored_by linking to a persona.

Printer

biblioteka/entity/printer.json

A printing house responsible for the physical production of books.

Publisher

biblioteka/entity/publisher.json

A publishing house or imprint responsible for producing book editions. Books, book sets, and book series link to publishers via published_by.

Quote

biblioteka/entity/quote.json

A notable quotation attributed to a persona or extracted from a literary work. Attribution recorded via attributed_to. Source tracked via taken_from or contains_quote.

Translated Literary Work

biblioteka/entity/translated_literary_work.json

A translation of a literary work into another language. Links to its original work via the originalWorkId field. Translator linked via translated_by. Can be contained in a book via contains_work.

Addressed To

biblioteka/association/addressed_to.json

Links a literary work (left side: letter or open address) to the person or organization it is addressed to (right side: persona, author, organization, or publisher).

Attributed To

biblioteka/association/attributed_to.json

Links a quote (left side) to its presumed author or speaker (right side: persona or author).

Authored By

biblioteka/association/authored_by.json

Links a creative work (left side: book or literary work) to the persona who wrote it (right side: author).

Book Has Illustrator

biblioteka/association/book_has_illustrator.json

Links a book edition (left side) to the persona who illustrated it (right side: illustrator).

Contains Comments By

biblioteka/association/contains_comments_by.json

Links a work (left side: book, literary work, or translated literary work) to the persona who provided commentary, preface, or notes (right side: commentator).

Contains Epigraph

biblioteka/association/contains_epigraph.json

Links a work (left side: book, literary work, or translated literary work) to a quote used as its epigraph (right side: quote).

Contains Quote

biblioteka/association/contains_quote.json

Links a work (left side: book, literary work, or translated literary work) to a quote cited within its text (right side: quote).

Contains Work

biblioteka/association/contains_work.json

Links a book edition or book set (left side) to a literary work it contains (right side: literary work or translated literary work).

Copyright Held By

biblioteka/association/copyright_held_by.json

Links a literary work (left side: literary work or translated literary work) to the entity that holds its copyright (right side: publisher, persona, or author).

Dedicated By

biblioteka/association/dedicated_by.json

Links a creative work (left side: book or literary work) to the person who dedicated it (right side: persona or author).

Dedicated To

biblioteka/association/dedicated_to.json

Links a creative work (left side: book or literary work) to the entity it is dedicated to (right side: persona, author, or literary work).

Dedication multi

biblioteka/multi_association/dedication.json

A dedication event: person A dedicated a literary work to person B. The first sub-association (dedicated_by) links the work to the dedicator; the second (dedicated_to) links the same work to the dedicatee.

• dedicated_by: literary_work → persona, author
• dedicated_to: literary_work → persona, author

Designed By

biblioteka/association/designed_by.json

Links a work (left side: book, literary work, or translated literary work) to the designer or artist responsible for its visual style (right side: persona or author).

Edited By

biblioteka/association/edited_by.json

Links a work (left side: book, literary work, or translated literary work) to the editor responsible for its edition (right side: persona or author).

Exemplar Of

biblioteka/association/exemplar_of.json

Links a physical book copy (left side: book exemplar) to its book edition (right side: book).

First Published In

biblioteka/association/first_published_in.json

Links a literary work (left side: literary work or translated literary work) to the book where it first appeared (right side: book).

Found With

biblioteka/association/found_with.json

Links an ephemera item (left side: ephemera exemplar) to the physical book copy it was found inserted in at acquisition (right side: book exemplar). More specific than a general storage or transaction relationship.

Founder Of

biblioteka/association/founder_of.json

Links a persona (left side: persona or author) to the organization they founded (right side: publisher, printer, or company).

Gift multi

biblioteka/multi_association/gift.json

A gift event: person A gifted an item to person B. The first sub-association (gifted_by) links the item to the giver; the second (gifted_to) links the same item to the recipient.

• gifted_by: book_exemplar → persona, author
• gifted_to: book_exemplar → persona, author

Gifted By

biblioteka/association/gifted_by.json

Links a physical book copy (left side: book_exemplar) to the person who gifted it (right side: persona or author).

Gifted To

biblioteka/association/gifted_to.json

Links a physical book copy (left side: book_exemplar) to the person who received it as a gift (right side: persona or author).

Has Application Note Attached

biblioteka/association/has_application_note_attached.json

Links any entity (left side) to an application note containing extra metadata or annotations (right side: application note).

Imprint Of

biblioteka/association/imprint_of.json

Links a publisher imprint (left side: publisher) to its parent publisher (right side: publisher). Represents hierarchical publisher relationships.

Inscribed By

biblioteka/association/inscribed_by.json

Links a physical book copy (left side: book_exemplar) to the person who inscribed, signed, or marked it (right side: persona or author). Covers autographs, gift dedications, ex libris marks, and stamps.

Inscription Image

biblioteka/association/inscription_image.json

Links a person who made an inscription (left side: persona or author) to the photograph showing that inscription (right side: image). Allows the same image to participate in other associations (e.g. has_image with role title_page) without conflict.

Interviewed By

biblioteka/association/interviewed_by.json

Links a literary work (left side: interview as literary work) to the persona who conducted the interview (right side: interviewer persona or author).

Mentions

biblioteka/association/mentions.json

Links a work (left side: literary work, cinematic work, or software) to any entity mentioned or cited within it (right side: any entity type, including persons, other works, organizations, places, settlements, etc.).

Part Of Series

biblioteka/association/part_of_series.json

Links a book or book set (left side: edition or multi-volume set) to the thematic series it was published in (right side: book series), with optional series number.

Printed By

biblioteka/association/printed_by.json

Links a book edition (left side: book) to the printer responsible for its physical production (right side: printer).

Published By

biblioteka/association/published_by.json

Links a book edition or book set (left side: book or book_set) to the publisher responsible for its publication (right side: publisher).

Published In

biblioteka/association/published_in.json

Links a published work (left side: book or book set) to the settlement or place where it was published (right side: settlement or place).

Reprint Of

biblioteka/association/reprint_of.json

Links a book edition (left side) to an earlier book edition it was reprinted or derived from (right side). Covers reprints, later editions, and other derivative editions.

Sequel Of

biblioteka/association/sequel_of.json

Links a literary work (left side: sequel) to the literary work it continues (right side: predecessor). Represents series ordering.

Taken From

biblioteka/association/taken_from.json

Links a quote (left side) to the literary work it was extracted from (right side: literary work or translated literary work).

Takes Place In

biblioteka/association/takes_place_in.json

Links a creative work (left side: literary work or translated literary work) to the geographical location where the action occurs (right side: settlement or place).

Translated By

biblioteka/association/translated_by.json

Links a work (left side: book, literary work, or translated literary work) to the translator responsible for its translation (right side: persona or author).

Translation Of

biblioteka/association/translation_of.json

Links a translated literary work (left side: translated literary work) to the original literary work it was translated from (right side: literary work).

Volume Of

biblioteka/association/volume_of.json

Links a book (left side: individual volume) to the multi-volume set it belongs to (right side: book set), with its volume number.

Company

business/entity/company.json

A commercial or industrial enterprise.

Competed Against

business/association/competed_against.json

Links two entities in a competition or match (left and right sides are interchangeable: persona, software, company, or organization). Examples include chess matches, business rivalries, or sporting contests.

Headquartered In

business/association/headquartered_in.json

Links a company (left side) to the settlement or place where its headquarters is located (right side: settlement or place).

Incorporated In

business/association/incorporated_in.json

Links a company (left side) to the state or jurisdiction where it is legally incorporated or registered (right side: state).

Place

geography/entity/place.json

A named geographic location that is not a settlement.

Settlement

geography/entity/settlement.json

A populated place such as a city, town, or village.

Located In

geography/association/located_in.json

Links an entity (left side: place, settlement, organization, book exemplar, ephemera exemplar, or storage location) to the location it resides within (right side: settlement, state, or storage location).

Storage Location

library/entity/storage_location.json

A physical location where book exemplars are stored, supporting hierarchical nesting (shelf, bookcase, room, apartment). Book exemplars linked via located_in. Hierarchy built with located_in between storage locations (transitive). Can bridge to geographic hierarchy via located_in to settlement.

Image

media/entity/image.json

An image entity representing a binary image file with descriptive metadata.

Has Image

media/association/has_image.json

Links any entity (left side) to an image associated with it (right side: image), with a role specifying the image's purpose (e.g. front cover, portrait).

Primary Image

media/association/primary_image.json

Records an explicit user preference designating one image (right side: image) as the primary visual representation of any entity (left side). At most one primary_image association is allowed per entity. This is a user-selected display choice, not an inherent property of the entity or the image itself. The referenced image must also have a has_image association to the same entity.

Persona

people/entity/persona.json

A documented, disputed, traditional, or fictional figure with biographical attributes. Commonly linked as author via authored_by, translator via translated_by, or editor via edited_by. Birth and death locations recorded via born_in_settlement/born_in_state and died_in_settlement/died_in_state.

Born In Settlement

people/association/born_in_settlement.json

Links a persona (left side) to the settlement or city where they were born (right side: settlement).

Born In State

people/association/born_in_state.json

Links a persona (left side) to the state or country where they were born (right side: state).

Coauthor Of

people/association/coauthor_of.json

Links two personas who have coauthored a work together (left and right sides are interchangeable: persona).

Died In Settlement

people/association/died_in_settlement.json

Links a persona (left side) to the settlement or city where they passed away (right side: settlement).

Died In State

people/association/died_in_state.json

Links a persona (left side) to the state or country where they passed away (right side: state).

Friend Of

people/association/friend_of.json

Links two personas in a friendship (left and right sides are interchangeable: persona).

Granted By

people/association/title_granted_by.json

Links a persona (left side) to the organization or state that granted them a title, degree, or honor (right side: organization or state).

Interviewer Of

people/association/interviewer_of.json

Links an interviewer persona (left side) to the respondent persona they interviewed (right side: persona).

Lived In

people/association/lived_in.json

Links a persona (left side) to the settlement or place where they resided (right side: settlement or place).

Parent Of

people/association/parent_of.json

Links a parent persona (left side) to their child persona (right side: persona).

Relative Of

people/association/relative_of.json

Links two personas in a general family relationship (left and right sides are interchangeable: persona).

Resided In State

people/association/resided_in_state.json

Links a persona (left side) to the state or country where they resided for a period of time (right side: state).

Romantic Relationship With

people/association/romantic_relationship_with.json

Links two personas in a romantic relationship (left and right sides are interchangeable: persona).

Spouse Of

people/association/spouse_of.json

Links two personas in a marriage relationship (left and right sides are interchangeable: persona).

Worked For

people/association/worked_for.json

Links a persona (left side) to the persona or organization they worked for or were employed by (right side: persona or organization).

Cinematic Work

performing_arts/entity/cinematic_work.json

A film, documentary, or other motion picture.

Performance

performing_arts/entity/performance.json

A single show or event — one specific date and time at a particular venue, with a specific cast.

Production

performing_arts/entity/production.json

A specific staging of a stage work by a particular director, theater company, or festival, within a defined season.

Stage Work

performing_arts/entity/stage_work.json

An abstract composition for the performing arts — an opera, ballet, play, or musical — independent of any specific staging or performance.

Based On

performing_arts/association/based_on.json

Links a stage work or cinematic work (left side) to the literary work it is based on (right side: literary work).

Choreographed By

performing_arts/association/choreographed_by.json

Links a stage work or production (left side) to its choreographer (right side: persona).

Composed By

performing_arts/association/composed_by.json

Links a stage work (left side) to its composer (right side: persona).

Directed By

performing_arts/association/directed_by.json

Links a cinematic work or production (left side) to its director (right side: persona).

Features Performer

performing_arts/association/features_performer.json

Links a performance (left side) to a performer who participated in it (right side: persona), with optional role and instrument/voice type details.

Instance Of Production

performing_arts/association/instance_of_production.json

Links a performance (left side) to the production it belongs to (right side: production).

Libretto By

performing_arts/association/libretto_by.json

Links a stage work (left side) to its librettist (right side: persona).

Performed At

performing_arts/association/performed_at.json

Links a performance (left side) to the venue where it took place (right side: place or organization).

Produced By

performing_arts/association/produced_by.json

Links a production (left side) to the organization that produced it (right side: organization).

Staging Of

performing_arts/association/staging_of.json

Links a production (left side) to the stage work it realizes (right side: stage work).

Reader Persona

reader/entity/reader_persona.json

The reader's own persona used to track reading history and preferences.

User List

reader/entity/user_list.json

A user-curated, named list of arbitrary entities (e.g. a 'Desiderata' list of books to acquire, a 'Reading project 2026' set of works, a 'Recommendations from N' compilation, or a 'Bookshops to visit' wishlist). Items are attached via the per-listType subtype schema (filename `_list_contains_v1.json`; `associationType` discriminator value `_list_contains`); the set of allowed item entity types depends on the subtype — e.g. `reading_project` restricts rightSide to book / literary_work / translated_literary_work, while `desiderata` allows any entity type. Optionally owned by a reader_persona.

Custom List Contains

reader/association/custom_list_contains.json

Links a custom-typed user_list (left side: user_list with listType='custom') to an arbitrary item it contains (right side: any entity type). Carries a generic state machine (pending, done, abandoned) for kinds that do not fit any predefined listType. Supports an optional priority flag and an optional 1-based position when the parent user_list is ordered.

Desiderata List Contains

reader/association/desiderata_list_contains.json

Links a desiderata-typed user_list (left side: user_list with listType='desiderata') to an arbitrary item it contains (right side: any entity type, e.g. book, literary work, persona). Carries the acquisition state of the desideratum (pending, found, abandoned), the date it was acquired, and an optional priority flag to highlight items the user most wants to find first.

Reading Project List Contains

reader/association/reading_project_list_contains.json

Links a reading-project user_list (left side: user_list with listType='reading_project') to a work it contains (right side: book, literary_work, or translated_literary_work). Carries both list membership and the reading state for that work in the context of the list — the same status enum and date fields as reads_v1 (to_read, reading, finished, abandoned). When a work is on a reading-project list, this record is the consolidated source of truth for both 'on the list' and 'reading state'; a separate reads_v1 record is not required for that intersection.

Reads

reader/association/reads.json

Links a reader persona (left side: reader persona) to a creative work representing a reading experience (right side: book, literary work, or translated literary work).

Recommendations List Contains

reader/association/recommendations_list_contains.json

Links a recommendations-typed user_list (left side: user_list with listType='recommendations') to an arbitrary item it contains (right side: any entity type). Tracks whether the user has acted on the recommendation: pending, followed_up, or dismissed; optionally records the date of follow-up.

Reference List Contains

reader/association/reference_list_contains.json

Links a reference-typed user_list (left side: user_list with listType='reference') to an arbitrary item it contains (right side: any entity type, e.g. persona, literary_work, settlement). Reference lists are analytical groupings extracted from research (e.g. 'authors mentioned in Empire Must Die'); items just are or are not included, so this subtype carries no status field. Optional position records the canonical order within the source (e.g. order of mention).

Wishlist List Contains

reader/association/wishlist_list_contains.json

Links a wishlist-typed user_list (left side: user_list with listType='wishlist') to an arbitrary non-acquirable target it contains (right side: place, settlement, organization, performance, etc.). Tracks whether the target has been visited or experienced (pending, visited, abandoned), optionally records the visit date, supports an optional priority flag for must-see items, and an optional 1-based position when the wishlist is intentionally ordered.

Organization

social/entity/organization.json

A formal organization, institution, or group.

State

social/entity/state.json

A political entity such as a country, empire, or autonomous territory.

Software

software/entity/software.json

A software application, tool, video game, or web service.

Developed By

software/association/developed_by.json

Links a software work (left side: software) to its developer (right side: persona, company, or organization).