# _manifest.json > 119 lines of code and 0 definitions. Tree: Site tree Language: json Canonical: https://banes-lab.com/anatomy/tree#file-manifest-json Source text: https://banes-lab.com/assets/sources/source.ec2ad8fc549aec049f4d437aebd1735d615d9c9bd1254747a7f54881861dbe5b.generated.txt ## Source ```json { "label": "Bane's Lab Site", "summary": "The banes-lab.com site. It publishes the methodology, Pattern Abstract Grammar (PAG), the software architecture, the ontology and the anatomy of its own source as static pages built with Vite, each prerendered with a JSON payload and a Markdown twin, and a static query catalog under `/json/api` that addresses every section, ontology record and source file on its own.", "maturity": "experimental", "domains": [ {"meta": "frontend-ui", "sub": "dom-construction"}, {"meta": "frontend-ui", "sub": "navigation"}, {"meta": "content", "sub": "copywriting-strings"} ], "ecosystem": "typescript", "visibility": {"private": true, "hidden": false}, "capabilities": [ "register-pages-by-identifier", "route-between-pages-through-events", "render-inline-markup-without-parsed-html", "animate-elements-on-intersection", "copy-content-to-clipboard", "render-typed-document-sections", "switch-tabs-through-query-parameters", "render-chapter-layout-with-cited-panels", "link-vocabulary-to-ontology-records-and-chapters", "reveal-record-and-chapter-references-on-hover", "explore-ontology-records-by-face", "walk-the-source-tree-with-definitions-and-sources", "emit-per-route-head-metadata-and-schema" ], "governedBy": [ "separation-of-concerns", "type-safety" ], "entries": ["runtime/entrypoints/*.entrypoint.ts"], "docs": { "overview": "This member is the banes-lab.com site. Each page is registered by a record under `presentation/records/`, whose `registerPage` call names the page and loads its view from `presentation/views/` only when the page is opened, so the bundle carries one chunk per page. The route coordinator listens for `route.requested` events, renders the page into the main region and emits `route.changed`, and the panel and the mobile menu mark the active page from that event.\n\nThe copy lives in `configuration/strings/` as typed `Section` data (`types/document.types.ts`). Its blocks (`types/block.types.ts`, `types/grammar.types.ts`) are rendered by `presentation/renderers/block.renderer.ts`, and each kind of page goes through its own renderer:\n\n- the legal pages and the FAQ through `document.renderer.ts`;\n- the PAG, methodology, architecture, ontology and anatomy pages through `tab.widget.ts`;\n- the methodology and architecture chapters through `chapter.renderer.ts`, which sets the prose beside cited panels (`panel.renderer.ts`), with pan and zoom from `panel.component.ts` and diagrams fetched by digest in `diagram.renderer.ts`.\n\nTwo pages render snapshots that the build writes. The ontology page renders `core/assets/ontology.generated.ts` through the converters in `domain/converters/`. The anatomy page renders `core/assets/anatomy.generated.ts`, which holds three source trees: this site, the content build and the Coordination Surface package. For each file it shows the walk, the definitions, the document checks and the source (`anatomy.renderer.ts`, `folder.renderer.ts`, `walk.renderer.ts`, `source.renderer.ts`).\n\n`site.strings.ts` passes every content module through `linkTabs` in `domain/converters/link.converter.ts`, which turns the first mention of an ontology term or another page's chapter in each section into a link. `reference.widget.ts` shows the record or chapter behind such a link on hover, focus or tap, together with the places in the anatomy that implement it, which `evidence.loader.ts` resolves.\n\nIcons live in `configuration/icons/`, section ids in `core/ids/` and resource locations in `core/assets/`. Every element is built through `core/factories/element.factory.ts`. Inline markup in the copy is converted to text runs by `core/converters/markup.converter.ts` and rendered by `presentation/renderers/text.renderer.ts`, so parsed HTML never reaches the page. `page.renderer.ts` derives each route's head (the title, description, canonical address, Open Graph type, and the JSON-LD graph from `schema.renderer.ts`), and `text.converter.ts` turns a rendered page into the Markdown twin that the copy button and the prerender share.", "whenToUse": [ "To add a page, you add a `.record.ts` under `presentation/records/` whose `registerPage` call names the page and loads its `.view.ts` from `presentation/views/`. The glob barrel discovers the record, the prerender writes its route, payload and twin, and the browser fetches the view's chunk only when the page is opened.", "To change copy, you edit the `.strings.ts` module that owns it, because no view carries a literal. A section that outgrows the file-length limit continues in `.fragment.strings.ts`, and a chapter section cites each of its panels by tag from the prose.", "To cite the ontology or another page, you write the record's exact name or the chapter's exact title, and the vocabulary linker resolves it. An anchor that the vocabulary does not carry goes through `stageLink`, `layerLink` or `nodeLink` from `link.converter.ts`.", "To add a block kind, you extend `types/block.types.ts` (or `grammar.types.ts`), render it in `block.renderer.ts`, style it in `presentation/styles/`, and declare it in the panel kinds if a chapter may cite it.", "To change the page shell, you edit the panel widget, the menu widget and their styles under `presentation/`." ], "whenNotToUse": [ "Deploying the site belongs to the deploy member, which owns the server, nginx and the upload. This member only builds.", "The ontology, anatomy and diagram snapshots are written by the build plugins in the workspace scripts member, so they are not edited by hand here.", "Governance code, meaning the rules and validators, belongs to `.govlab/` and the `govlab.*` members.", "The tests for this member live under `codebase.testing/test.web/`." ], "install": "The `workspaces` glob in the root `package.json` resolves this member, and every third-party dependency is hoisted from the root. `npm run dev` from the root serves the site over HTTPS with a generated self-signed certificate. `npm run build -w @banes-lab/web` runs the build plugins in `vite.config.ts`, writes the static site into the output declared as `builds.web` in `project.paths/paths.yaml`, and then renders the methodology repository and its wiki.", "quickStart": [ { "intent": "Register a page", "lang": "ts", "code": "import { registerPage } from \"#domain/registries/page.registry\";\n\nregisterPage({\n description: HOME_DESCRIPTION,\n icon: HOME_ICON,\n id: HOME_PAGE,\n listed: true,\n load: async () => (await import(\"#presentation/views/home.view\")).PAGE,\n order: 10,\n title: HOME_TITLE,\n});" }, { "intent": "Request a route from anywhere", "lang": "ts", "code": "import { emitEvent } from \"#core/buses/base.bus\";\nimport { ROUTE_REQUESTED } from \"#core/ids/route.ids\";\n\nemitEvent({ name: ROUTE_REQUESTED, page: HOME_PAGE });" }, { "intent": "Link a content module against the ontology and the chapter vocabulary", "lang": "ts", "code": "import { METHODOLOGY_CONTENT } from \"#configuration/strings/methodology.strings\";\nimport { METHODOLOGY_PAGE } from \"#core/ids/page.ids\";\nimport { SITE_VOCABULARY } from \"#configuration/strings/site.strings\";\nimport { linkTabs } from \"#domain/converters/link.converter\";\n\nexport const METHODOLOGY_TABS = linkTabs(METHODOLOGY_CONTENT, SITE_VOCABULARY, METHODOLOGY_PAGE);" } ], "configuration": [ { "option": "vite.config.ts", "note": "The application build and its plugins in the order they run, with the roots, the output and the development certificate resolved through `@ssot/paths`. The anatomy snapshot is derived before the build starts." }, { "option": ".govlab/taxonomy.config.ts `containers`", "note": "Declares this member as a governed root with the containers `configuration`, `core`, `domain`, `presentation` and `runtime`, and the flat `types` folder." }, { "option": "configuration/constants/vocabulary.constants.ts", "note": "The ambiguous phrases that the vocabulary linker never turns into links." }, { "option": "configuration/constants/evidence.source.constants.ts", "note": "The registry that ties ontology records and chapters to the constructs in this member that implement them. The reference widget reads it in both directions." } ], "disposal": [ "Remove the member's workspace entry from the root `package.json`, and the `#host/*` imports key.", "Remove its governed-root entry from `containers` and `specialContainers` in `.govlab/taxonomy.config.ts`.", "Remove the `app` branch from `project.paths/paths.yaml`.", "Delete the directory, reinstall, and run `npm run verify`." ], "apiNotes": [ { "name": "registerPage", "note": "Stores each page by `id`, so a second registration of the same id replaces the first. Only pages with `listed: true` appear in the panel, but every registered page can be routed to, and the prerender stops with an error when an id declared in `page.ids.ts` has no record that registers it." }, { "name": "linkTabs", "note": "Links the first occurrence of each vocabulary phrase in a section. It matches whole words and ignores case, plurals and the difference between British and American spelling. It never links inside code, a diagram, a tag or an existing link, and it never links a section to itself." }, { "name": "createLink", "note": "Builds every link on the site. A hash on the same tab scrolls to its target and opens a collapsed record, a page path routes through the event bus, and an external address opens as a plain anchor." }, { "name": "mountReference", "note": "Adds the hover, focus and tap reveal to every link that points to an ontology record or a chapter. It reads a chapter from the route's JSON payload and a record from its record module, which it imports on first use." } ], "aiContext": [ "Views carry no copy. A new string is a constant in the `.strings.ts` module that owns it.", "Interactive controls (buttons, inputs) are constructed only inside `presentation/components/*.component.ts`.", "A child component emits events and its parent subscribes to them. A widget never receives a callback to call upward.", "A `*.generated.ts` asset is written by a build plugin and is not edited by hand. When one is missing or out of date, the build has not run.", "Tests for this member live at `codebase.testing/test.web//tests/` and import it by package specifier." ] } } ```