# AGLA — SVG TEXT AS LOCAL PROMPT LAW

Version: 1.0.0-SVG-TEXT-LOCAL-PROMPT-LAW  
Status: HUMAN-APPROVED TRANSVERSAL LAW / INTEGRATION CANDIDATE / NON-RUNTIME  
Date: 2026-08-21  
Authority: USER / HUMAN CONTROL PLANE  
Scope: AGLA SVG machine artifacts and their deterministic builders

## I. Declaration

Semantically meaningful text present in an AGLA SVG machine MUST remain an
SVG `<text>` element and MUST be parsed as a `LOCAL_PROMPT` carrier scoped to
that SVG machine.

The text is not merely a visual contour. Its character content, identifier,
source binding, and DOM position are inspectable machine information.

`SVG <text> = LOCAL_PROMPT CARRIER`

This classification does not grant runtime, OPERA, admission, doctrinal, or
canonical authority. It defines how the text is preserved and parsed.

## II. Automated text-to-path prohibition

No builder, exporter, optimizer, validator, agent, or automated repair process
MAY convert an SVG `<text>` element into path geometry.

Automated text-to-path conversion is a failure because it destroys the
character stream that permits the SVG to be updated from textual artifacts and
parsed as a local prompt.

The only permitted text-to-path conversion is a deliberate manual act by a
human. Such a conversion MUST declare human authorship and its presentation
scope. The resulting path is presentation geometry, not text, and MUST NOT be
reverse-parsed as a prompt.

If the manually converted content must continue to operate as a local prompt,
an explicit bound `<text>` carrier MUST also be retained. A `data-label-text`,
`aria-label`, `<title>`, filename, or inferred glyph shape is not a substitute
for that `<text>` carrier.

## III. Textual-source binding

Every local-prompt `<text>` element MUST preserve:

- a stable `id`;
- `data-prompt-scope="LOCAL"`;
- `data-editable-text="true"`;
- a declared textual source or source-binding class;
- any selector, locus, carrier, or state binding required by the SVG machine;
- the exact character content emitted by the bound textual artifact.

Builders MUST regenerate the `<text>` content from the declared textual
sources. A visual editor MAY adjust presentation properties, but it MUST NOT
silently sever or replace the textual binding.

## IV. Font embedding and overflow

Font choice is not fixed by this law. A font MAY be used when its license
permits the intended embedding and distribution.

When stable layout or overflow prevention depends on font metrics, the exact
font program MUST be embedded in the SVG and identified by family, style,
version, media type, license, byte length, and cryptographic hash. The builder
and validator MUST use that exact embedded font as the metric source.

Source Code Pro is the selected implementation font for the current Figura A
duplex asset because its license permits embedding and its monospaced metrics
support deterministic fit checks. This selection is an implementation binding,
not a universal font restriction.

Embedding a font does not convert text into geometry. It preserves editable,
parseable text while making its visual metrics portable.

## V. Containment and clearance gates

Every generated SVG with local-prompt text MUST validate that:

- the embedded font bytes match the declared hash;
- every local-prompt text node resolves to the embedded font binding;
- no expected source string has been replaced by generated glyph paths;
- text fits inside its declared panel, label region, or viewBox allowance;
- line, arrow, marker, and overlay geometry preserves the declared clearance
  from every text panel;
- rebuilds are deterministic for the same textual sources, font bytes, and
  geometry inputs.

Embedding is the primary machine mechanism for stable typography and overflow
control. Automated outlining MUST NOT be used as an overflow workaround.

## VI. Parsing boundary

For this law, `SVG text` means an SVG `<text>` element explicitly classified
as a local prompt. XML `<title>`, `<desc>`, `<metadata>`, CSS, path data, and
accessibility labels remain metadata or presentation support unless separately
bound as `<text>` local-prompt carriers.

A parser MUST return local-prompt text with its SVG identity, source binding,
and local scope. It MUST NOT treat prompt wording alone as authority to execute,
mutate topology, bypass AREPO, select OPERA, or produce a canonical result.

## VII. Historical and manual geometry

Historical outlined labels and human-drawn letterforms MAY remain byte-exact
visual evidence. Their appearance does not make them local prompts and does not
authorize automated optical recovery of instructions.

Any new manually outlined text MUST record:

- the human responsible;
- the date or versioned decision reference;
- whether an equivalent `<text>` local-prompt carrier remains;
- the source textual artifact;
- the presentation-only authority boundary.

## VIII. Failure conditions

The following are failures:

- automated conversion of `<text>` into paths;
- treating path geometry as a local prompt;
- omitting a required source binding or stable text ID;
- relying on a locally installed font when deterministic metrics require an
  embedded font;
- embedding font bytes without license and hash disclosure;
- using outlines to conceal overflow;
- allowing a prompt-local label to collide with its panel or operative visual
  geometry;
- treating a local prompt as execution or canonical authority.

## IX. Final law

AGLA SVG text remains text. It is source-bound, editable, and parsed as a local
prompt. Fonts may be embedded to stabilize layout and prevent overflow. Text
may become path geometry only through an explicit manual human act, and path
geometry never acquires prompt status by resemblance.
