Skip to main content

NeonInk's Relationship to SESM

SVG Embedded Semantic Metadata (SESM) is a standalone Aptlantis standard (see the SESM standard, City Hall position 23). It is not a NeonInk-owned standard, but NeonInk's Docs/ folder in the source tree contains a working copy — SESM-v0.2.md — because Neon Ink, NIPC, and AIC are written to interlock tightly with SESM's metadata model.

:::info Why this page exists instead of a duplicate spec This standard's Docs/ folder includes a full copy of the SESM v0.2 draft alongside NeonInk's own documents (NIPC, AIC, APGC, Neon Ink itself). Rather than publish that text twice in this Docusaurus site, the full SESM spec lives at docs/sesm/overview. This page records only how NeonInk uses SESM. :::

What SESM Provides To NeonInk

SESM is the embedded metadata carrier for compiled SVG artifacts. In the Neon Ink four-layer model:

LayerCanonical DocumentResponsibility
MeaningSESM standardEmbedded metadata, identity, provenance, links, agent hints
PaletteNIPCHue, semantic family, psychological intent, intensity validation
ContractAICArtifact type, required fields, layout, render targets
ExpressionNeon InkBrand system, typography, panel grammar, page composition
GeometryAPGCShape families, angle energy, corner profiles, safe zones

Every compiled SVG artifact in Aptlantis Studio (dataset cards, pipeline panels, theme boards) should carry a <metadata id="sesm"> block. NeonInk's AIC contract defines which SESM fields are required per artifact type; NIPC defines the semantic role/family/intensity vocabulary that populates SESM's theme object; APGC defines the geometry fields that live in SESM's ui/extra.vendor.aptlantis.apgc blocks.

NeonInk-Specific SESM Examples

The two worked examples below come from NeonInk's own SVG-Panels-Examples.md and SESM-v0.2.md source files and are kept here because they show NeonInk's actual production SESM usage (including legacy pre-NIPC color values), rather than SESM's generic examples:

  • SVG Panel Examples — real compiled related-datasets.svg and dataset-header.svg panels with full SESM blocks, still using legacy hex values like #00E5FF.
  • AIC §2.2 and NIPC §7 — the recommended NIPC-aligned theme object shape for new SESM blocks.

NeonInk's Docs/pptx/ and Docs/pdf/ folders include a dedicated SVG-Embedded-Semantic-Metadata-SESM slide deck and PDF, generated as part of this design system's documentation suite rather than the SESM standard's own suite. See References for links to those files.

For Integration

Links from this page to ../sesm/overview.md assume the SESM standard is built at docs/sesm/ with the standard overview.md filename, per the City Hall numbering table (position 23). If that page's slug differs, this link (and the equivalent ones in overview.md, nipc.md, aic.md, and apgc.md) will need a quick fix during the cross-standard integration pass.