@tileflow/maps 0.1.0-alpha.3 → 0.1.0-alpha.5

package/README.md

@@ -1,205 +1,142 @@
-# `@tileflow/maps`
+# @tileflow/maps
 
-Official Tileflow maps and the assets they own.
+Official Tileflow maps with their icon, pattern, and font assets. Extend a map with
+`@tileflow/core`; render its prepared output with a framework adapter or MapLibre.
+
+> Related packages and guides: [documentation index](https://raw.githubusercontent.com/tileflow/tileflow-sdk/main/llms.txt).
+
+## Install
+
+```sh
+npm install @tileflow/maps@alpha @tileflow/core@alpha
+```
+
+Core is a peer dependency: it owns the map language and compiler. This package owns map definitions
+and assets. It does not include a tile archive, a browser renderer, or a hosted service subscription.
+
+## Use an official map
+
+Create `tileflow.config.ts`:
+
+<!-- docs:check -->
 
 ```ts
 import {defineMap} from '@tileflow/core';
 import {streets} from '@tileflow/maps';
 
 export default defineMap({
-  id: 'main',
+  id: 'madrid',
+  name: 'Madrid',
   version: 1,
   extends: streets,
   defaultTheme: 'dark',
+  view: {center: [-3.7038, 40.4168], zoom: 12},
 });
 ```
 
-This still inherits both Streets themes; it changes only which concrete theme is selected by
-default.
+This inherits both Streets themes and changes only the default selection and initial view.
+Coordinates are `[longitude, latitude]`. To preview it:
 
-Every export is an ordinary, complete first-party Tileflow map. No official map imports or extends
-another official map; each declares its data, modules, render stacks, themes, and asset
-providers directly. Applications can still use the public `extends` contract to derive their own
-maps from any official root. Streets and Siegfried each contain structurally identical `light` and
-`dark` appearances.
+```sh
+npm install --save-dev --save-exact tileflow@alpha
+npx tileflow validate
+npx tileflow preview
+```
 
-The official map objects are deeply frozen package singletons so one consumer cannot mutate
-the definition seen by another. This does not change Core authoring: `defineMap(...)` still returns
-the application-owned object without freezing it, and an application extends an official map by
-declaring its own modules or other atomic overrides.
+Rendering can request remote tiles, glyphs, or terrain. Installing the package does not make those
+resources available offline.
+
+## Choose a map
+
+- `streets`: contemporary street cartography with coordinated light and dark themes, ranked POIs,
+  and generic road-reference shields.
+- `baedeker`: warm travel-atlas styling, serif labels, original engraved patterns, and contours.
+- `civica`: illustrated civic-print styling with warm paper, olive parks, blue annotations, and
+  vermilion landmarks.
+- `ferraris`: printed-atlas styling with patterned land cover and settlements.
+- `harad`: the historical green-map design displayed as **Härad**.
+- `siegfried`: a terrain atlas with coordinated light/dark ink palettes, contours, and engraved patterns.
+- `soundings`: bathymetric reference cartography with depth bands, continuous relief, and port context.
+- `cyberpunk`: a dark heads-up-display design with destination beacons and Oxanium typography.
+- `matrix`: a monochrome green-screen design with scanline and dot patterns.
+- `verdant`: a contemporary field atlas emphasizing trails, vegetation, and hydrography.
+- `sanFrancisto`: a dark architectural-blueprint design centered on San Francisco. The export is
+  spelled `sanFrancisto`.
+- `superTileWorld`: a pixel-art overworld with layered shores, golden routes, destination sprites,
+  and packaged arcade lettering.
+
+Every official map is a complete, independent root using the same Core compiler. Official map
+objects are deeply frozen shared instances. Do not mutate them; use `defineMap({extends: ...})`
+to create an application-owned map.
+
+Soundings is not a navigation product. Its depth-band edges are approximate reference geometry,
+not surveyed isolines or vessel-specific safety contours. Experimental nautical aids and hazards
+are not enabled by that official map.
+
+## Themes and assets
+
+`streetsThemes` and `siegfriedThemes` expose complete `light` and `dark` themes. Import those
+collections when using `defineTheme()` to derive a new appearance. A declared `themes` collection
+replaces the inherited collection, so also declare the intended `defaultTheme` and `systemThemes`
+mapping. `system` belongs to browser selection; captures and builds use concrete theme names.
+
+Every map exports an icon-directory descriptor: `streetsIcons`, `baedekerIcons`, `civicaIcons`,
+`ferrarisIcons`, `haradIcons`, `siegfriedIcons`, `soundingsIcons`, `cyberpunkIcons`, `matrixIcons`,
+`verdantIcons`, `sanFrancistoIcons`, and `superTileWorldIcons`. The descriptors point into this installed package; they are not sprite URLs.
+The CLI and build integrations compile the selected directories into runtime assets.
+
+Baedeker and Siegfried also export `baedekerFonts` and `siegfriedFonts` for their packaged Cormorant
+Garamond faces. Cyberpunk and Matrix export `cyberpunkFonts` and `matrixFonts` for Oxanium.
+Cívica exports `civicaFonts` for DM Serif Text, Barlow Semi Condensed, and Noto Sans fallback.
+Super Tile World exports `superTileWorldFonts` for Pixelify Sans, Tile World Arcade, and Noto Sans fallback.
+Streets, Ferraris, Härad, Soundings, Verdant, and San Francisto declare Noto Sans URL glyph providers
+from one immutable Hosted base-asset set, versioned independently of World data.
+
+Omitting `icons` inherits the parent's directory list. Declaring a list replaces it; `[]` removes
+all icon directories. Compose explicitly when adding application icons:
+
+<!-- docs:check -->
 
 ```ts
-import {
-  baedeker,
-  baedekerFonts,
-  baedekerIcons,
-  cyberpunk,
-  cyberpunkFonts,
-  cyberpunkIcons,
-  ferraris,
-  ferrarisIcons,
-  harad,
-  haradIcons,
-  matrix,
-  matrixFonts,
-  matrixIcons,
-  sanFrancisto,
-  sanFrancistoIcons,
-  siegfried,
-  siegfriedFonts,
-  siegfriedIcons,
-  siegfriedThemes,
-  soundings,
-  soundingsIcons,
-  streets,
-  streetsIcons,
-  streetsThemes,
-  verdant,
-  verdantIcons,
-} from '@tileflow/maps';
+import {defineMap} from '@tileflow/core';
+import {streets, streetsIcons} from '@tileflow/maps';
+
+export default defineMap({
+  id: 'store-locator',
+  version: 1,
+  extends: streets,
+  icons: [streetsIcons, './icons'],
+});
 ```
 
-`baedeker` is a self-contained travel-atlas and town-plan design with open warm paper, fine coral
-building and residential hatching, paper-negative streets, dominant black railways, horizontally
-engraved cyan water, ring-stippled gardens, and browser-derived Mapterhorn contours. Travel POIs
-are rendered as compact serif labels without modern pictograms. It declares
-`[baedekerIcons]`, whose eight original Tileflow SVG patterns describe hachures, orchards, paper
-grain, public gardens, residential blocks, sand, water lines, and wetlands, plus
-`[baedekerFonts]`, its own package copy of Cormorant Garamond Regular, SemiBold, and Italic. Its
-visual grammar was informed by the
-[Baedeker / Karl Wagner & Debes collection](https://www.antiquemapsandprints.com/collections/baedeker-karl-wagner-debes?srsltid=AfmBOoqG_2Q_Zje0wPPVYjShDjDZe5aIgH_h08XcPkpu7zFaPvF6n5hq)
-and Wikimedia Commons'
-[maps by Karl Baedeker of Italy](https://commons.wikimedia.org/wiki/Category:Maps_by_Karl_Baedeker_of_Italy).
-The package includes no historical scan, raster pixel, historical typeface, legend artwork,
-geospatial data, or source map; the style and patterns are original Tileflow work. The packaged
-Cormorant faces are unmodified upstream font software under the SIL Open Font License 1.1. No
-Mapterhorn terrain tile is packaged or redistributed. Baedeker is an official Tileflow map and is
-not affiliated with or endorsed by Baedeker or Wagner & Debes.
-
-`ferraris` is a self-contained printed-atlas design. It uses Core's semantic compiler, but
-it does not import or extend the `streets` map and it does not inherit Streets assets. It declares
-only `[ferrarisIcons]`, which contains nine original seamless SVG patterns for paper, cultivated
-land, vegetation, settlements, sand, wetlands, and water. Applications can import it directly or
-extend it like any other root.
-
-`harad` is a self-contained historical green-map design named “Härad”. It uses Core's semantic
-compiler ABI without importing or extending the `streets` map or reusing any Streets asset.
-It declares only `[haradIcons]`, whose nine original Tileflow SVG patterns describe arable land,
-coniferous and deciduous woodland, orchards, paper grain, sand, settlements, water lines, and
-wetlands. The visual grammar is inspired by Lantmäteriet's CC0 Häradsekonomiska kartan series
-(1859–1934) and official legend. The package redistributes no Lantmäteriet scan, source pixel, legend
-artwork, font, or map data; the shipped style and SVG patterns are original Tileflow work.
-
-`soundings` is a self-contained bathymetric-chart design with ivory land, thirteen-stop
-depth-graded water, labelled band edges, continuous colour relief, multidirectional seabed shading,
-port context, named ferry routes, and restrained technical magenta. Its initial camera faces the
-Strait of Gibraltar, allowing an Iberian GEBCO pilot to exercise both Atlantic and Mediterranean
-relief. It selects the public semantic compiler contract without importing or extending `streets`
-and explicitly composes World with `bathymetry({display: 'hybrid'})` while setting Nautical to
-`false`.
-
-Vector bands come from `tileflow-bathymetry`; continuous colour relief and hillshade come from
-`tileflow-bathymetry-dem`. The stronger DEM treatment is balanced against the vector wash and depth
-labels rather than against experimental navigation symbols. Dashed outlines remain an honest
-fallback traced from broad GEBCO band polygons until native contour geometry is released. Labels
-show the absolute `min_depth` value, not an inferred range or vessel-specific safety contour.
-Harbours and ferries are ordinary World context. Experimental `nautical-v1` tiles, aids, lights,
-soundings, hazards, reefs, and wrecks are deliberately absent from the official map and remain
-available only to explicitly configured laboratory maps. Soundings is reference cartography and is
-not a navigation product.
-
-`siegfried` is a self-contained terrain atlas based on the visual grammar documented for
-swisstopo's nineteenth-century Siegfried Map. It does not import or extend `streets`. The default
-`light` theme preserves black, brown, blue, and an ivory paper substrate; browser-derived contours
-replace modern hillshade and retain the 30-metre Alpine cadence at detailed zooms. Rock and scree
-are re-engraved in key ink after the contour deck, while dedicated SVG motifs distinguish forest,
-glacier, wetland, gravel, orchard, and water. Its coordinated `dark` theme is explicitly a nocturnal
-engraver's proof, not a historical facsimile: it keeps identical geometry and semantic ink roles on
-charcoal paper. `[siegfriedIcons]` owns nine light and nine dark pattern variants,
-`[siegfriedFonts]` owns the locally packaged Cormorant Garamond Regular, SemiBold, and Italic faces,
-and `[siegfriedThemes]` exposes the two complete visual vocabularies for safe derivation.
-
-`verdant` is a self-contained contemporary field-atlas design. It combines a park-map information
-hierarchy with a cool mineral substrate, clean blue hydrography, graphite buildings, and a
-trail-forward accent; its original botanical textures appear only where detailed zooms make them
-useful. It uses the same semantic compiler contract without importing or extending `streets`,
-declares its own Noto Sans glyph provider, and owns its complete icon and pattern set through
-`[verdantIcons]`.
-
-`sanFrancisto` is a self-contained dark architectural-blueprint design centered on San Francisco.
-Fine technical road strokes, survey-like uppercase labels, precise building footprints, contour
-dimensions, and dedicated landscape and water hatches replace naturalistic map color. It declares
-the canonical Noto Sans glyph provider and only `[sanFrancistoIcons]`, whose four original patterns
-and schematic POI node form its complete sprite vocabulary.
-
-`cyberpunk` is a self-contained dark HUD root. Its road hierarchy, building signals, destination
-beacons, semantic render passes, theme, World data selection, `[cyberpunkIcons]`, and
-`[cyberpunkFonts]` are all declared directly; it does not import or extend `streets`.
-
-`matrix` is a self-contained monochrome green-screen root. It explicitly owns its sparse HUD
-geometry, reviewed phosphor-green ramp, modules, semantic render passes, and theme. It
-omits a bright road centerline and building circuit texture, and uses compact square destination
-nodes through `[matrixIcons]`. A translucent scanline and dot pattern masks the cartographic
-linework so bright strokes break into the phosphor rows of an old CRT without baking that texture
-into the map data; text layers render afterwards and stay crisp. `[matrixFonts]` owns Matrix's
-packaged Oxanium faces for uppercase labels, independently of Cyberpunk's font provider.
-
-`streetsThemes.light` and `streetsThemes.dark` are complete appearance documents consumed by the
-same semantic module structure. Selecting `dark` changes colors, typography roles, image roles, and
-lighting without changing a source, filter, layer order, zoom gate, collision rule, or module. Both
-sidewalk patterns live in the shared `[streetsIcons]` atlas and the selected theme resolves the
-semantic `roads.sidewalkPattern` image token to the correct asset.
-
-Streets uses one ranked destination hierarchy in both themes. Major transit and cultural anchors
-appear first; lodging, health, education, services, shopping, food, coffee, and parking enter
-progressively as the camera approaches street level. Each visible destination is one collision
-unit made from a colored circular pictogram and an optional neutral name, so the marker remains
-useful when the label cannot fit. The pictogram scale grows gently from 1× at z12 to 1.06× at z17,
-giving detailed street views a little more visual presence without increasing POI density.
-Portal-number labels are intentionally disabled. The ten POI
-pictograms are adapted from the pinned CC0 Maki subset documented in
-`THIRD_PARTY_NOTICES.md`; their containers, colors, sizing, and composition are Tileflow-authored.
-
-Road references use a compact Tileflow-owned family of generic rectangular and circular shields.
-The data's normalized `shield_kind` selects neutral, blue, green, red, orange, yellow, or circular
-artwork; `shield_text_color` independently selects the light or dark theme token. Unknown and
-unsupported networks fall back to the neutral rectangle with dark text instead of guessing a
-country from the spelling of `ref`. Both themes retain the same signaling colors.
-
-Streets has separate shield phases for scale, not separate hand-authored network layers. Overview
-uses pre-deduplicated point candidates; detail switches to repeated line placement. Both the fitted
-plate and its complete route reference are viewport-aligned, so shields remain horizontal as the
-map rotates or pitches. The rectangular base plate is 20 by 14 pixels with a one-pixel outline;
-the circular neutral base is 14 by 14. Both use 9-pixel bold text and a small width-only fit
-allowance. Streets limits shields to the motorway-through-tertiary hierarchy; collision padding
-and the overview candidate schedule keep regional views legible while preserving useful repetition
-at street scale.
-
-The two palettes are Tileflow-owned, deterministic snapshots calibrated from rendered Mapbox
-Standard `default/day` and `default/night` references on 2026-08-27. They do not import Mapbox style
-JSON, rules, assets, or runtime dependencies. Public roles such as `surface.background`,
-`landuse.industrial`, `landuse.medical`, `labels.settlement`, `labels.neighborhood`, and
-`labels.road` remain independently wired; `hydro.ocean` also separates Standard Night's deep sea
-from urban and inland water. An agent can alter one cartographic intent without
-knowing or perturbing the physical layer topology. Because Standard is evergreen, later parity work
-must be an explicit dated recalibration rather than an implicit network-dependent change.
-
-At detailed zooms, the road-bearing official maps round-cap ordinary surface-road and bridge
-feature endpoints so adjacent vector segments overlap their antialiasing fringe instead of exposing
-hairline cuts. Tunnel portals retain butt caps; Streets, Cyberpunk, and Matrix also keep butt caps on
-steps and approaches carrying circular-road clearance so those structural ends do not protrude into
-the connected geometry. Streets pairs its blue/slate road decks with a darker casing that grows from
-1 px at z15 to 2 px at z22; tunnel casings use the compact dashed rhythm of the calibrated reference.
-
-A theme is not a loose override cascade. Module styles explicitly reference roles such as
-`roads.motorway`, `labels.road`, and `hydro.water`; the selected complete theme resolves those
-references before MapLibre output is generated. Use `defaultTheme` for a deterministic default and
-`systemThemes` plus the runtime `theme="system"` selection when the browser should follow the OS.
-
-The directory descriptors point into this installed package. A map inherits its parent's icon or
-font list when the property is omitted. Declaring a list replaces the inherited list, a later
-directory wins for an exact duplicate ID, and `[]` selects no directories.
-
-`@tileflow/maps` has a peer dependency on `@tileflow/core`. Core owns the map language and compiler;
-this package owns the official map definitions, icon and pattern sources, Cyberpunk, Matrix, and
-Siegfried fonts, and their notices. Core never depends on this package.
+Create `icons/` beside the config and add supported image files before building. Later directories
+replace earlier files with the same exact icon ID. Fonts follow the same ordered-directory model;
+`fonts` and `glyphs` are mutually exclusive providers.
+
+## Delivery and attribution
+
+Use the CLI or a build integration to prepare a map's complete asset set. Copying Style JSON alone
+can leave missing sprites, font files, or browser protocols. Keep the generated manifest and its
+referenced files together.
+
+Hosted deployment currently requires Tileflow World and rejects local/package font bundles before
+uploading a style. Maps with packaged fonts therefore need self-hosted delivery or an explicitly
+replaced, compatible public glyph provider. Check with `tileflow validate --target hosted` before
+planning a hosted deployment.
+
+Tileflow-owned designs and artwork use Apache-2.0. Historical inspiration does not mean the package
+redistributes historical scans, source cartography, or data. Third-party fonts and the pinned Maki
+icon subset retain their own terms. Preserve
+[THIRD_PARTY_NOTICES.md](https://github.com/tileflow/tileflow-sdk/blob/main/packages/maps/THIRD_PARTY_NOTICES.md)
+and the notices next to packaged assets. Map data and terrain services have separate attribution
+and usage requirements.
+
+See the [Core guide](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/README.md)
+for inheritance and styling, or the
+[public exports](https://github.com/tileflow/tileflow-sdk/blob/main/packages/maps/src/index.ts)
+for exact names. The installed package's definitions and README take precedence over a newer `main`.
+
+## Design and asset reference
+
+The [design and asset notes](https://github.com/tileflow/tileflow-sdk/blob/main/packages/maps/docs/design-and-assets.md) describe each map's visual grammar, source references, and third-party asset boundaries. They are also included under
+`docs/` in the installed package.

package/THIRD_PARTY_NOTICES.md

@@ -1,7 +1,7 @@
 # Third-party notices
 
 Except for the Streets POI pictograms documented below, the official themed Streets, Baedeker,
-Ferraris, Härad, Siegfried, Soundings, Cyberpunk, Matrix, Verdant, and San Francisto icon and pattern
+Ferraris, Härad, Siegfried, Soundings, Cyberpunk, Matrix, Verdant, San Francisto, Cívica, and Super Tile World icon and pattern
 artwork published under `assets/` is original Tileflow artwork.
 
 This file is shipped with `@tileflow/maps` so future third-party assets have a stable place for
@@ -138,3 +138,66 @@ respective `assets/cyberpunk/fonts/` and `assets/matrix/fonts/` directories. Oxa
 2019 The Oxanium Project Authors and is distributed under the SIL Open Font License 1.1 included
 beside both font copies. The canonical license filename consumed by Tileflow's generic font
 pipeline is `LICENSE.txt`.
+
+## Cívica artwork and fonts
+
+The `civica` map, its five SVG patterns, and its eleven SVG POI pictograms are original Tileflow
+code and artwork. Its civic print-atlas vocabulary takes broad visual inspiration from the user's
+[Inside the Belt Way — Washington DC reference](https://www.etsy.com/listing/990932175/inside-the-belt-way-washington-dc).
+This package does not include or redistribute the reference map, geography, composition,
+lettering, symbols, images, or other artwork. Cívica declares its own assets and does not import
+another official map's artwork or font directories.
+
+Cívica includes five unmodified upstream font files under `assets/civica/fonts/`:
+
+- `DMSerifText-Regular.ttf` and `DMSerifText-Italic.ttf` are from the official Google Fonts
+  [DM Serif Text directory](https://github.com/google/fonts/tree/2536d8f1f906c7bb1f4b1d09ac073109dc6a7cd9/ofl/dmseriftext),
+  pinned to revision `2536d8f1f906c7bb1f4b1d09ac073109dc6a7cd9`. Their complete upstream
+  SIL Open Font License 1.1 notice is preserved at `assets/civica/fonts/OFL.txt`.
+- `BarlowSemiCondensed-Regular.ttf` and `BarlowSemiCondensed-SemiBold.ttf` are from the official
+  Google Fonts [Barlow Semi Condensed directory](https://github.com/google/fonts/tree/3218ae2acc5bce7ccd97c477965b5b4094241fb0/ofl/barlowsemicondensed),
+  pinned to revision `3218ae2acc5bce7ccd97c477965b5b4094241fb0`. Their complete upstream
+  SIL Open Font License 1.1 notice is preserved at `assets/civica/fonts/LICENSE-BarlowSemiCondensed.txt`.
+- `NotoSans-Regular.ttf` is from the official Noto
+  [static hinted Noto Sans directory](https://github.com/notofonts/noto-fonts/tree/c971829a87e7920f960e7277c3dafd9bedd3c601/hinted/ttf/NotoSans),
+  pinned to revision `c971829a87e7920f960e7277c3dafd9bedd3c601`. Its complete upstream
+  SIL Open Font License 1.1 notice is preserved at `assets/civica/fonts/LICENSE-NotoSans.txt`.
+
+`assets/civica/fonts/LICENSE.txt` combines all three complete upstream notices and licenses with
+component filenames and source revisions for Tileflow's generic font preparation pipeline.
+`assets/civica/fonts/README.md` records individual pinned source links and verified OpenType full
+names. No font file has been subsetted, renamed internally, or modified.
+
+## Super Tile World artwork and fonts
+
+The `superTileWorld` map, sixteen SVG sprites, and seven SVG patterns are original Tileflow code
+and artwork. Its pixel-art overworld takes visual inspiration from _Super Mario World_. This
+package includes no extracted game sprites, Nintendo logo, source map, or downloaded icon artwork.
+Super Mario World is a Nintendo trademark; this independent showcase has no affiliation with or
+endorsement from Nintendo. The asset research references are recorded in
+`assets/super-tile-world/README.md`.
+
+Super Tile World packages three unmodified static upstream font files and one renamed derivative in its own
+`assets/super-tile-world/fonts/` directory:
+
+- `PixelifySans-Regular.ttf` and `PixelifySans-SemiBold.ttf` are from the official
+  [Pixelify Sans project](https://github.com/eifetx/Pixelify-Sans/tree/39df74aba80df8157546034b878e8be1eb565ced),
+  pinned to revision `39df74aba80df8157546034b878e8be1eb565ced`. Its complete SIL Open Font
+  License 1.1 notice is preserved as `LICENSE-PixelifySans.txt`.
+- `TileWorldArcade-Regular.ttf` is a name-table-only derivative of `PressStart2P-Regular.ttf`
+  from the official Google Fonts
+  [Press Start 2P directory](https://github.com/google/fonts/tree/e06fe11c39051bddaef73ec338a9d1c8175723f1/ofl/pressstart2p),
+  pinned to revision `e06fe11c39051bddaef73ec338a9d1c8175723f1`. The derivative is named
+  “Tile World Arcade” to satisfy the upstream reserved-font-name requirement and to give browser
+  canvas rendering a compatible family name. Glyph outlines, metrics, and character mappings
+  remain unchanged. Its complete SIL Open Font License 1.1 notice, including the upstream
+  reserved font name, is preserved as `LICENSE-PressStart2P.txt`.
+- `NotoSans-Regular.ttf` is from the official Noto
+  [static hinted Noto Sans directory](https://github.com/notofonts/noto-fonts/tree/c971829a87e7920f960e7277c3dafd9bedd3c601/hinted/ttf/NotoSans),
+  pinned to revision `c971829a87e7920f960e7277c3dafd9bedd3c601`. Its complete SIL Open Font
+  License 1.1 notice is preserved as `LICENSE-NotoSans.txt`.
+
+`LICENSE.txt` combines all three complete font-family notices and licenses for the generic local
+font preparation pipeline. The adjacent `fonts/README.md` records the pinned source files,
+verified OpenType full names, and the derivative's exact name-table changes. No font is subsetted;
+Pixelify Sans and Noto Sans remain unmodified upstream files.

package/assets/README.md

@@ -1,15 +1,15 @@
 # Official map assets
 
 These directories contain the package-owned sources required by the official Streets, Baedeker,
-Ferraris, Härad, Siegfried, Soundings, Cyberpunk, Matrix, Verdant, and San Francisto maps. Their SVG icons and
+Ferraris, Härad, Siegfried, Soundings, Cyberpunk, Matrix, Verdant, San Francisto, Cívica, and Super Tile World maps. Their SVG icons and
 patterns live under each map's `icons/` directory. Streets includes a pinned CC0 subset of Maki
 pictograms inside Tileflow-authored circular POI markers; its provenance is recorded in
 `../THIRD_PARTY_NOTICES.md` and the upstream license is kept at `streets/LICENSE-MAKI.txt`. A map
 refers to those directories through the exported `streetsIcons`, `baedekerIcons`, `ferrarisIcons`,
 `haradIcons`, `siegfriedIcons`, `soundingsIcons`, `cyberpunkIcons`, `matrixIcons`, `verdantIcons`,
-and `sanFrancistoIcons` descriptors. Baedeker, Cyberpunk, Matrix, and Siegfried refer to their own
-packaged font directories through `baedekerFonts`, `cyberpunkFonts`, `matrixFonts`, and
-`siegfriedFonts`; the files and their `LICENSE.txt` remain beside the map that owns them.
+`sanFrancistoIcons`, `civicaIcons`, and `superTileWorldIcons` descriptors. Baedeker, Cívica, Cyberpunk, Matrix, Siegfried, and Super Tile World refer to their own
+packaged font directories through `baedekerFonts`, `civicaFonts`, `cyberpunkFonts`, `matrixFonts`, and
+`siegfriedFonts`, and `superTileWorldFonts`; the files and their `LICENSE.txt` remain beside the map that owns them.
 
 The seven `road-shield-*` SVGs are original Tileflow artwork: a deliberately generic neutral,
 colored-rectangle, and neutral-circle vocabulary. They do not reproduce a national sign template
@@ -71,6 +71,22 @@ technical symbol: `san-francisto-blueprint-grid`, `san-francisto-building-hatch`
 Together they provide drawing-paper grid, building, landscape, and water notation plus a schematic
 POI marker without importing another official map's sprite assets.
 
+The Cívica directory contains five original transparent patterns: `civica-paper-grain`,
+`civica-park-groves`, `civica-orchard`, `civica-water-lines`, and `civica-industrial-hatch`.
+Eleven original `civica-poi-*` pictograms provide civic, cultural, garden, transport, and everyday
+destination glyphs with fine ivory clearances and compact paper squares for transport symbols.
+Small marks and a quiet secondary point preserve the map's label hierarchy. The map also owns its packaged fonts; artwork and font
+provenance are recorded in `civica/README.md` and `civica/fonts/README.md`.
+
+The Super Tile World directory contains sixteen original pixel-art SVG sprites and seven
+intrinsic-size patterns for grass, water, forest, brick, sand, meadow, and farmland. Its `stw-*`
+asset vocabulary supports a game-board interpretation of real geography without importing another
+map's sprites. Pixelify Sans Regular and SemiBold supply detail lettering; Tile World Arcade Regular
+supplies display lettering, with Noto Sans Regular as a local fallback. Tile World Arcade is a
+name-table-only derivative of Press Start 2P, with its glyphs preserved and a distinct family name
+for reliable browser canvas rendering. All four font faces and their complete OFL notices are packaged
+locally. See `super-tile-world/README.md` and `super-tile-world/fonts/README.md`.
+
 `@tileflow/dev` resolves each package descriptor, verifies that its real path remains inside the
 installed package, and compiles the complete ordered directory composition into deterministic
 MapLibre sprite atlases. `<id>.<ext>` publishes an icon as `<id>` and
@@ -90,7 +106,10 @@ Verdant, and San Francisto each declare the canonical Tileflow glyph URL with ex
 `Noto Sans Regular` and `Noto Sans Bold` stacks. Cyberpunk and Matrix name `Oxanium Medium` and
 `Oxanium SemiBold`, while Baedeker and Siegfried each name `Cormorant Garamond Regular`,
 `Cormorant Garamond SemiBold`, and `Cormorant Garamond Italic` from their respective packaged
-directories. The compatibility URL
+directories. Cívica packages `DM Serif Text Regular` and `DM Serif Text Italic` for its place
+and water lettering, `Barlow Semi Condensed Regular` and `Barlow Semi Condensed SemiBold` for
+roads and destinations, and `Noto Sans Regular` as an explicit local fallback. It declares only local fonts because the public contract makes local
+font directories and remote glyph providers mutually exclusive. The compatibility URL
 is canonical but not content-addressed; responses
 revalidate and do not provide an exact-byte receipt. Reproducible official PBF delivery will use the
 separate `/base/<assetSetSha256>/glyphs/...` contract once Hosted has verified and published that

package/assets/civica/README.md

@@ -0,0 +1,35 @@
+# Cívica artwork
+
+The SVG patterns and point-of-interest pictograms in `icons/` are original artwork drawn from
+scratch for the Cívica Tileflow map. They use a civic print-atlas vocabulary: warm paper,
+vermilion destinations, blue transport ink, loose olive tree rings, broken horizontal water
+strokes, and fine diagonal industrial overprinting. The design takes broad visual inspiration
+from the user's reference, _Inside the Belt Way — Washington DC_, without copying its map,
+geography, lettering, composition, symbols, or artwork.
+
+No downloaded imagery, existing map style, or external icon set is included.
+Every icon and pattern is a self-contained SVG with an explicit intrinsic size for Tileflow's sprite
+pipeline. Patterns have transparent backgrounds so the map owns the underlying land or water
+color. Ink marks remain intentionally small and sparse to avoid competing with road and label
+hierarchies at different zoom levels.
+
+The POI pictograms use a 28 × 28 canvas and remain useful at icon sizes of 0.65–0.85. Fine ivory
+clearances keep the original glyphs legible over colored map areas. Vermilion identifies civic,
+cultural, and medical destinations; quiet gray-green identifies everyday businesses; gardens use
+green ink. Transit and airports use compact paper squares with fine blue keylines.
+`civica-poi-dot` is a quiet secondary point occupying less of the same canvas.
+
+Pattern runtime IDs remove the `.pattern.svg` filename suffix:
+
+- `civica-paper-grain` — sparse warm ink flecks; 128 × 128.
+- `civica-park-groves` — loose clusters of small tree rings; 64 × 64.
+- `civica-orchard` — staggered small orchard crowns; 64 × 32.
+- `civica-water-lines` — broken horizontal blue strokes; 64 × 32.
+- `civica-industrial-hatch` — seamless diagonal working-landscape hatch; 16 × 16.
+
+POI runtime IDs are `civica-poi-civic-star`, `civica-poi-museum`, `civica-poi-monument`,
+`civica-poi-garden`, `civica-poi-transit`, `civica-poi-food`, `civica-poi-lodging`,
+`civica-poi-hospital`, `civica-poi-shopping`, `civica-poi-airport`, and `civica-poi-dot`.
+
+The separately licensed fonts packaged under `fonts/` have their own upstream provenance in
+`fonts/README.md` and their complete license beside the font files.

package/assets/civica/fonts/LICENSE-BarlowSemiCondensed.txt

@@ -0,0 +1,93 @@
+Copyright 2017 The Barlow Project Authors (https://github.com/jpt/barlow)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.