{
  "schema_version": 1,
  "package_version": "2.2.0",
  "brand_edition": "04.2",
  "required": [
    {
      "id": "identity.masters",
      "rule": "Use current neutral Cut and Current Blue tonal Facet/lockup assets. Preserve supplied silhouette, canvas, plane geometry and quarter-ink-height clear space. Historical coloured masters remain intact but are not the current presentation default."
    },
    {
      "id": "color.roles",
      "rule": "Cool off-white Frost #F4F7FB and charcoal/slate structure. Current Blue is bluer and less green than the rejected Petrol draft: light primary #245F9E, hover/text #1C4D82; dark primary/text/focus #8ABBE8, hover/tint #E5EFFA; tint ink #204E7D. Preserve imported palette bytes. Semantic signals retain labels; spectral RGB remains optical only."
    },
    {
      "id": "type.readable",
      "rule": "Geist is the only current presentation family, including metadata and figures; tabular numerals where useful. Plex is retained historical only. No essential web reading below 14px; default body 16px. No eyebrows, overlines or uppercase chapter markers."
    },
    {
      "id": "material.hierarchy",
      "rule": "Dense persistent reading/forms/data stay opaque. Functional glass buttons, navigation, menus, popovers, short context panels and drawers are supported. One material owner per shared plane; no stacked child filters. A requested readable glass panel is not banned. Compact group inset 6px; preserve targets."
    },
    {
      "id": "interaction.access",
      "rule": "44px web targets, visible labels/focus, keyboard operation, truthful busy/disabled/error/recovery states."
    },
    {
      "id": "data.honest",
      "rule": "Digital-first reports, presentations and charts have working navigation and readable source/units/uncertainty/value equivalents. Optional finite attention light never changes encoded data colours or meaning; print/PDF is a static secondary export."
    },
    {
      "id": "motion.optional",
      "rule": "Implement requested optical interactions: quiet rest, local hover lens/light, stronger held-press refraction/RGB split and settling release. Coordinate GSAP/CSS reveal/return with one owner per property, interrupt from current state and preserve semantics. Working solid/reduced/failure end states are required."
    },
    {
      "id": "evidence.boundary",
      "rule": "Relevant subject-led imagery with creator/source/license and crop provenance. Generated concepts labelled nearby; never use photorealistic AI as documentary proof of people, premises, process or delivered work."
    },
    {
      "id": "review.rendered",
      "rule": "Automated checks do not replace rendered, device or physical proof."
    },
    {
      "id": "optics.boundary",
      "rule": "Transparent lightly frosted glass is the ideal: perceptible image, gentle haze/light bending, low body tint, thin rim and soft shadow. Avoid dark opaque plates and thick chrome borders. State supported backdrop mapping; generic DOM frosting is not known-image refraction. Bound root lifecycle and stop closed/hidden/offscreen work; keep labels sharp and reduced/solid end states usable."
    },
    {
      "id": "copy.direct",
      "rule": "No em dashes in authored copy. Sentence-case Geist text; no eyebrows, overlines, monospaced metadata or decorative technical labels."
    },
    {
      "id": "composition.quiet",
      "rule": "Group with space/alignment. No decorative border grids or outlined cards; retain necessary field, focus, state, table and material boundaries."
    },
    {
      "id": "imagery.editorial",
      "rule": "One relevant credible subject, natural editorial light/cool whites, honest material colour, no blue wash. Define wide/portrait/thumbnail crops and retain uncropped master. Water, robots, crystals and macro texture wallpaper are not defaults."
    },
    {
      "id": "icons.clean",
      "rule": "Use existing Phosphor Regular consistently at 20/24px optical size in 44px minimum targets. Visible touch labels for ambiguity and accessible names. No emojis, mixed families, decorative heading icons or redundant link arrows."
    },
    {
      "id": "motion.choreography",
      "rule": "Actual buttons/menus/panels/drawers must support press/release and open/close/reverse without queues, stale pressure or reset jumps. Material and grouped content move coherently. GSAP/CSS/shader reductions end together; modal semantics and focus return are verified separately from visual motion."
    },
    {
      "id": "interaction.finish",
      "rule": "Use quiet coherent pressed/selected states. Close glyphs have no permanent thick white enclosure; keyboard focus remains discreet and visible. Centre the filled Phosphor three-dot glyph in its optical box. Focused fields keep one fine 1px boundary. Nested radii derive from outer minus inset and border. Preserve material through exits and actual 44px targets."
    },
    {
      "id": "field.selected",
      "rule": "Cursor field is opt-in only on selected [data-magnetic-field] areas, bounded low-opacity and no idle motion. Honor density/theme/strength/align/static options, reset on exit/cancel, keep ordinary cursor/text/controls intact and make reduced/touch/solid/contrast modes static. Stop hidden/offscreen work."
    },
    {
      "id": "identity.motion",
      "rule": "Identity is static by default. Optional Facet flight is one gentle finite path/shimmer of the intact supplied form, with settled/replay/still states. Never move feather geometry, reshape planes, animate wordmark or loop through required reading."
    }
  ],
  "defaults": {
    "web_body_px": 16,
    "dense_px": 14,
    "metadata_px": 12,
    "body_line_height": 1.65,
    "spacing_px": [
      8,
      16,
      24
    ],
    "control_radius_px": 8,
    "panel_radius_px": 16,
    "narrow_panel_radius_px": 12,
    "state_ms": 160,
    "reveal_ms": 240,
    "expansion_ms": 280,
    "reading_measure_ch": 72,
    "nested_radius": "max(0, outer - padding - border), including segmented selections",
    "environment": "neutral",
    "light_shell": "#f4f7fb",
    "light_surface": "#fcfdfe",
    "light_ink": "#18202a",
    "dark_shell": "#18202a",
    "dark_surface": "#222d38",
    "dark_ink": "#f4f7fb",
    "glass_inset_px": 6,
    "glass_border_px": 1,
    "glass_control_height_px": 52,
    "narrow_glass_control_height_px": 46,
    "minimum_web_target_px": 44,
    "glass_selection": "neutral tonal mark on the shared plane",
    "display_weight": 400,
    "emphasis_weight": 500,
    "glass_refraction": "quiet at rest; local hover; stronger press; settling release",
    "glass_optical_reference": "examples/glass/",
    "glass_fill": "low-tint reviewed photographic material; .88 generic fill is only an unknown-backdrop reading guard, not the visual ideal",
    "presentation_font": "Geist",
    "numeric_style": "tabular where useful",
    "historical_font_only": "IBM Plex Mono",
    "light_accent": "#245f9e",
    "light_accent_hover": "#1c4d82",
    "light_accent_ink": "#1c4d82",
    "light_accent_on": "#f4f7fb",
    "dark_accent": "#8abbe8",
    "dark_accent_hover": "#e5effa",
    "dark_accent_ink": "#8abbe8",
    "dark_accent_on": "#18202a",
    "accent_soft": "#e5effa",
    "accent_soft_ink": "#204e7d",
    "icon_family": "Phosphor Regular",
    "icon_optical_px": [
      20,
      24
    ],
    "decorative_borders": false,
    "overlines": false,
    "eyebrows": false,
    "em_dashes": false,
    "functional_glass_roles": [
      "button",
      "navigation-group",
      "menu",
      "popover",
      "short-context-panel",
      "drawer"
    ],
    "persistent_content_material": "opaque",
    "glass_roots": "one owner per shared plane; distinct functional roots allowed within a measured budget",
    "coordinated_motion": "GSAP when supplied by consumer, CSS local states; one owner per property",
    "material_controls_repository_source": "docs/brand/prototypes/material-controls/",
    "implementation_proof": "source/routing notes are not working or rendered proof",
    "identity_current_assets": [
      "fyronyx-balance-cut-ink.svg",
      "fyronyx-balance-cut-blue.svg",
      "fyronyx-balance-facet-blue.svg",
      "fyronyx-balance-facet-blue-light.svg",
      "fyronyx-wordmark-balance-ink.svg",
      "fyronyx-wordmark-balance-blue.svg",
      "fyronyx-lockup-balance-ink.svg",
      "fyronyx-lockup-balance-blue.svg",
      "fyronyx-wordmark-balance-frost.svg",
      "fyronyx-lockup-balance-frost.svg"
    ],
    "accent_name": "Current Blue",
    "glass_visual_character": "transparent, lightly frosted, gentle distortion, low tint, thin rim, soft shadow",
    "text_field_focus_border_px": 1,
    "selected_state": "quiet tonal fill, not a saturated badge or nested glass slab",
    "cursor_field_selector": "[data-magnetic-field]",
    "cursor_field_runtime": "runtime/magnetic-field.js",
    "cursor_field_styles": "runtime/magnetic-field.css",
    "cursor_field_defaults": {
      "density": "medium",
      "theme": "auto",
      "strength": 0.6,
      "align": "right"
    },
    "cursor_field_no_idle": true,
    "material_controls_route": "/ui/material-controls/",
    "identity_provenance": "fyronyx-current-identity-provenance.v1.json",
    "cursor_field_static_states": [
      "touch",
      "reduced motion",
      "reduced transparency",
      "increased contrast",
      "solid material",
      "ancestor reduced/paused",
      "data-field-static=true"
    ],
    "cursor_field_hidden_states": [
      "forced colors",
      "print"
    ],
    "identity_source_edition": "04.1",
    "document_default": "digital-first responsive report/presentation/chart; print is secondary export",
    "identity_motion_default": "static",
    "facet_flight": "optional finite intact-form path/shimmer; no feather geometry motion",
    "attention_light": "optional finite white-to-spectrum material/framing response; no semantic data encoding"
  },
  "adaptation": "Record medium, units, reason and verification. Native units are not CSS px. RGB is not CMYK.",
  "asset_contract": {
    "required": [
      "version",
      "kind",
      "files",
      "intent",
      "audience",
      "medium",
      "data_status",
      "adaptations",
      "review"
    ],
    "kinds": [
      "chart",
      "document",
      "web",
      "native",
      "print",
      "diagram",
      "slides",
      "email"
    ],
    "data_status": [
      "illustrative",
      "sourced",
      "none"
    ]
  },
  "migration": "2.2.0 / edition 04.2 adds digital-first studio guidance, exact nested radii, quiet close/overflow finish and optional finite attention/Facet studies. Published 2.0.0 and 2.1.0 remain reproducible. Identity source edition 04.1 and its static SVG geometry/bytes remain unchanged. Existing products require authorized migration."
}
