+++ /dev/null
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="UTF-8">
- <title>Epimetheus: The Only Primitive</title>
- <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+JP&display=swap" rel="stylesheet">
-
- <script src="style/body_visibility_hidden.js"></script>
- <script>
- window.StyleRT.body_visibility_hidden();
- </script>
- </head>
- <body>
- <RT-article>
- <RT-title
- author="Thomas Walker Lynch"
- date="2026-01-14"
- title="Epimetheus: The Only Primitive">
- </RT-title>
-
- <RT-TOC level="1"></RT-TOC>
-
- <h1>Introduction</h1>
-
- <p>
- Epimetheus is a Python library for <RT-term>Higher Order Analysis</RT-term> and <RT-term>Semantic Annotation</RT-term>. A data scientist might say it is a mechanism for <RT-term>Late Binding</RT-term> of ontology, while a programmer will call it a <RT-term>type system</RT-term>.
- </p>
-
- <p>
- Unlike Prometheus (Forethought), who defines what an object <em>is</em> before it is born (classic class instantiation), Epimetheus allows you to attach meaning, identity, and semantic types to objects <em>after</em> they exist.
- </p>
-
- <p>
- In standard programming, the <RT-term>primitives</RT-term> are things like
- <RT-code>int</RT-code>, <RT-code>float</RT-code>, <RT-code>char</RT-code>, or <RT-code>boolean</RT-code>. These carry inherent meaning and behavior before you ever use them. An integer <em>is</em> a number; it must add and subtract.
- </p>
-
- <p>
- Epimetheus (Afterthought) rejects this. It allows you to attach meaning (semantics) to objects after they are born. You can decide later that an object behaves like a number, or a string, or a user.
- </p>
-
- <p>
- If you strip away all pre-defined types and behaviors (no ints, no strings, no classes), what is left? What is the one thing you absolutely <em>cannot</em> add later?
- </p>
-
- <p>
- <RT-neologism>Distinctness</RT-neologism>.
- </p>
-
- <p>
- You cannot attach meaning to an object if you cannot point to it. You cannot say "This object is a Number" if you cannot distinguish "This object" from "That object."
- </p>
-
- <p>
- Thus the <RT-term>Symbol</RT-term> (the unique, persistent identity) is the most primitive data entity. Given <RT-term>Symbol</RT-term>s, and a <RT-term>Turing Machine</RT-term> for building structure, everything else follows. But this is not an article about constructing mathematics or computer science, rather it is about a <RT-term>type system</RT-term>, so lets not get too carried away with the grand strokes of the pen.
- </p>
-
- <h1>Assumptions and Terms</h1>
-
- <h2>Given</h2>
-
- <p>
- As is apparent while you read this, English prose is a given. The goal in making use of prose is to explain that the code is internally consistent without the English description. Once the formal relations are established, the prose is no longer needed, as the logic permits no dependence on the medium used for its introduction. In other words, code does not read the comments to decide what to do.
- </p>
-
-
- <p>
- The code related to this discussion is implemented in Python; however, issues with other languages are considered. One salient difference involves the fact that Python integers are bignums and are passed by reference. In some other languages, integers are considered <RT-term>primitives</RT-term>, are bounded in magnitude, and are bit-copied.
- </p>
-
- <h2>Symbol</h2>
-
- <h3>Instance</h3>
-
- <p>
- We are given a <RT-term>symbol instance</RT-term> factory. Each time the <RT-code>make</RT-code> function on the factory interface is called, the factory returns an instance of a distinct <RT-term>symbol</RT-term>.
- </p>
-
- <p>
- In some languages <RT-term>symbol</RT-term>s are implemented over primitive integers, and a <RT-term>symbol instance</RT-term> will be an integer. Thus <RT-term>symbol instance</RT-term>s can be copied. A common method for making a copy is to use assignment, e.g., <RT-code>x = y</RT-code>, where <RT-code>y</RT-code> is a variable holding a <RT-term>symbol instance</RT-term>. After execution of the assignment, <RT-code>x</RT-code> will hold another instance of the same <RT-term>symbol</RT-term>.
- </p>
-
- <p>
- In the Python version of Epimetheus <RT-term>symbol</RT-term>s are indeed implemented over integers. However, Python integers are non-primitive and thus are passed by reference. The Python Epimetheus <RT-term>symbol instance</RT-term> factory will return a reference to an integer, not the base integer, as the <RT-term>symbol instance</RT-term>. Assignment will then copy the reference. Thus this reference is the <RT-term>symbol instance</RT-term> rather than the integer the <RT-term>symbol</RT-term> is based on.
- </p>
-
- <p>
- In Epimetheus, we use a dictionary to give a <RT-term>symbol</RT-term> a name. The names need not meet the requirements imposed on a <RT-term>symbol instance</RT-term>, but it can be confusing when they don't. This is avoided in other <RT-term>symbol</RT-term> systems by implementing <RT-term>symbol</RT-term>s over character strings, and using the character string as both the name and the instance.
- </p>
-
- <h2>Required Properties</h2>
-
- <p>
- Any two, or by transitivity, any number of, <RT-term>symbol instance</RT-term>s can be compared for equality, say <RT-code>x == y</RT-code>. A comparison between <RT-term>symbol instance</RT-term>s will always return <RT-code>True</RT-code> or <RT-code>False</RT-code>.
- </p>
-
- <p>
- A <RT-term>symbol instance</RT-term> newly minted using the given <RT-term>symbol</RT-term> factory <RT-code>make</RT-code> function is said to <RT-neologism>come direct from the factory</RT-neologism>. A <RT-term>symbol instance</RT-term> direct from the factory is also called an <RT-neologism>original symbol</RT-neologism>.
- </p>
-
- <p>
- Equality over <RT-term>symbol instance</RT-term>s is an equivalence relation: <RT-code>x == x</RT-code> is True; <RT-code>x == y</RT-code> implies <RT-code>y == x</RT-code>; and if <RT-code>x == y</RT-code> and <RT-code>y == z</RT-code> then <RT-code>x == z</RT-code>.
- </p>
-
- <p>
- Any two <RT-term>symbol instance</RT-term>s returned directly from the factory using two different <RT-code>make</RT-code> calls will always equality compare to be <RT-code>False</RT-code>. In other words, two distinct <RT-neologism>original</RT-neologism>s will always be not equal.
- </p>
-
- <p>
- Given an <RT-neologism>original</RT-neologism>, all copies <RT-neologism>stemming from</RT-neologism> it will be equal to each other and to the <RT-neologism>original</RT-neologism>. By <RT-neologism-em>stemming from</RT-neologism-em> we mean to include all direct copies and copies of copies.
- </p>
-
- <p>
- Given any two <RT-neologism>original</RT-neologism>s, say <var>A</var> and <var>B</var>, we know that <var>A</var> is not equal to <var>B</var>, as discussed above. Note also that <var>A</var> is not equal to any copy <RT-neologism>stemming from</RT-neologism> <var>B</var>, and <var>B</var> is not equal to any copy <RT-neologism>stemming from</RT-neologism> <var>A</var>.
- </p>
-
- <p>
- Though <RT-term>symbol instance</RT-term>s are integer-like in that copy and equality compare can be used with them, <RT-term>symbol instance</RT-term>s are disallowed from being used with other integer operators. <RT-term>Symbol</RT-term>s cannot be compared for greater-than or less-than; they cannot be incremented, added, nor subtracted, etc.
- </p>
-
-
- <h2>What <em>is</em> a Symbol?</h2>
-
- <p>
- Only <RT-term>symbol instance</RT-term>s exist at runtime, so a <RT-term>symbol</RT-term> is never manipulated directly.
- </p>
-
- <p>
- Define a relation <var>~</var> over instances by <RT-code>x ~ y</RT-code> iff <RT-code>x == y</RT-code>. Since <RT-code>==</RT-code> is an equivalence relation, this partitions instances into equivalence classes. Each such equivalence class is a <RT-term>symbol</RT-term>.
- </p>
-
- <p>
- The factory’s <RT-code>make</RT-code> returns an <RT-neologism>original</RT-neologism> instance that is not equal to any other <RT-neologism>original</RT-neologism>. All copies <RT-neologism>stemming from</RT-neologism> an <RT-neologism>original</RT-neologism> remain in the same equivalence class. Therefore any instance in the class can represent the <RT-term>symbol</RT-term>, and we may choose any one instance as the <RT-term>symbol</RT-term>’s name (a canonical representative), or we could use a dictionary, and use, say, the <RT-neologism>original</RT-neologism> instance, to lookup a string as a name, among other possibilities.
- </p>
-
- <h3>Distinctness Across Contexts</h3>
- <p>
- If a <RT-term>symbol</RT-term> persists across contexts (such as across scopes or processes), it must remain distinct from all other <RT-term>symbol</RT-term>s as it enters those new environments.
- </p>
-
- <p>
- In this implementation, we meet this constraint by utilizing a global <RT-term>symbol instance</RT-term> factory and by explicitly disallowing a <RT-term>symbol</RT-term> from being employed outside the process of its creation. As a means of enforcement, there are no permitted methods to serialize a <RT-term>symbol</RT-term> to a string, nor to output one to a console or stream.
- </p>
-
- <p>
- These constraints do not apply to <RT-term>symbol</RT-term> names, which are text strings. However, a <RT-term>symbol</RT-term> cannot be recovered from its name; the name is a label, not a reconstruction key.
- </p>
-
- <h2>Object</h2>
- <p>
- The term "Python object" refers to anything that can or could appear in legal Python code and could be associated with a <RT-term>symbol</RT-term>. This includes <RT-term>symbol</RT-term>s themselves.
- </p>
-
- <p>
- A <RT-term>symbol</RT-term> is associated with an object using a Python dictionary. The <RT-term>symbol</RT-term> is the key, and the object is that thing which is "looked up" via said key.
- One such example is the <RT-term>symbol</RT-term> name dictionary mentioned in the prior section.
- </p>
-
- <h2>Tape</h2>
-
- <p>
- In the TTCA, we gave a formal definition for a <RT-term>tape</RT-term>. A <RT-term>tape</RT-term> is an ordered sequence of cells with a leftmost cell, zero or more interior cells, and a rightmost cell. If the <RT-term>tape</RT-term> is infinite, then there is no rightmost cell. The original <RT-term>Turing Machine</RT-term> <RT-term>tape</RT-term> is a <RT-term>symbol tape</RT-term> due to each cell of the <RT-term>tape</RT-term> holding exactly one <RT-term>symbol</RT-term>. The TTCA <RT-term>tape</RT-term> generalizes this by permitting a cell to hold any object.
- </p>
-
- <p>
- Two <RT-term-em>tapes</RT-term-em>, say <RT-math>A</RT-math> and <RT-math>B</RT-math>, are equal if and only if they are the same length and all their cells have equal contents.
- </p>
- <RT-math>
- A = B \iff \forall i \in \text{indices}, A[i] = B[i]
- </RT-math>
-
- <p>
- If a <RT-term>tape</RT-term> is treated as nothing more than its cells, then deleting the last cell causes the <RT-term>tape</RT-term> to no longer exist. In a system that has a higher level structure that preserves the <RT-term>tape</RT-term> as a distinct entity, deleting the last cell produces an empty <RT-term>tape</RT-term> entity that is said to have zero cells.
- </p>
-
- <blockquote>
- Consider a web browser. When the last tab is closed, the window disappears, forcing the user to create a new window to continue. Some users don't like this behavior, and would prefer that the window to remain as an empty canvas. Then a mistaken close could be undone by selecting 'reopen closed tab', without having to relaunch the browser and resettle the new window into the workspace.
- </blockquote>
-
-
- <p>
- The <RT-term>tape</RT-term> abstraction is particularly expressive in the Python context, as the language utilizes object references and permits lists to hold objects of any type. Once data within a container is modeled as a <RT-term>tape</RT-term>, structures such as lists, arrays, token streams, argument lists, and sequences all share the same abstract model.
- </p>
-
-
- <h2>Path</h2>
-
- <p> The term <RT-term>path</RT-term> is an ontological alias for <RT-term-em>tape</RT-term-em>. Adopting the term <RT-term-em>path</RT-term-em> brings with it a specialized vocabulary and a semantic framework for discussing traversal. The structure is unchanged, but the interpretation changes, as a tape becomes something to follow. </p>
-
- <p>
- The leftmost cell in a <RT-term>path</RT-term> is called the <RT-term>destination</RT-term>.
- All cells of the <RT-term>path</RT-term> to the right of the <RT-term>destination</RT-term>
- cell are called the <RT-term>way</RT-term>. If the <RT-term>path</RT-term> has two or more
- cells, dropping the leftmost cell leaves a <RT-term>tape</RT-term> holding exactly the
- <RT-term>way</RT-term>. Hence a <RT-term>path</RT-term> can be viewed as a pair,
- (<RT-term>destination</RT-term> ,<RT-term>way</RT-term>), where the destination is a single
- cell and the way is a tape (possibly empty).
- </p>
-
- <p>
- The reader might have expected the <RT-term>path</RT-term> to go from left to right, with the <RT-term>destination</RT-term> being in the rightmost cell. This would be natural because we read characters from a written page going from left to right. However, such a definition would run into a problem for us, as we will need for paths to always have a destination, and <RT-term>tape</RT-term>s can be open on the right, so they do not always have a rightmost cell.
- </p>
-
- <blockquote>
- Think about it this way: you are sitting in a pub of an inn, and a stranger walks in. Though you know the stranger's current <RT-term>destination</RT-term>, you might not know where he came from.
- </blockquote>
-
- <h3>Discrete Function</h3>
- <p>
- Now consider a <RT-term>tape</RT-term>, say called <var>F</var>, where each cell in F holds a <RT-term>path</RT-term>. As a <RT-term>path</RT-term> is a <RT-term>tape</RT-term>, the structure of <var>F</var> is that of a <RT-term>tape</RT-term> of <RT-term>tape</RT-term>s.
- </p>
-
- <p>
- Now suppose we traverse <var>F</var> while examining the <RT-term>path</RT-term>s as (<RT-term>destination</RT-term> ,<RT-term>way</RT-term>) pairs. If we find that all equal <RT-term>way</RT-term>s lead to
- the same <RT-term>destination</RT-term>, then <RT-term>tape</RT-term> <var>F</var> is a <RT-term>discrete function</RT-term>. We say it is <em>discrete</em> because <var>F</var> is a <RT-term>tape</RT-term> with distinct cells. We say it is a function due to having the property that all <RT-term>path</RT-term>s with equal <RT-term>way</RT-term>s lead to the same <RT-term>destination</RT-term>.
- </p>
-
- <p>
- Thus a function is more restricted than a <RT-term>tape</RT-term> of paths, and due to this restriction it is possible to adopt the following notation, where a <RT-term>destination</RT-term> is said to be determined by, a function of, the <RT-term>way</RT-term>:
- </p>
-
- <RT-math>
- destination = f(way)
- </RT-math>
-
- <p>
- That the same <RT-term>way</RT-term> always leads to the same destination fits our common experience. If we ever followed the same way twice and landed in a different destination we would think ourselves to be in a Sci-Fi movie. It is also intuitive to us that the function restrictions do not exclude the possibility that multiple <RT-term>way</RT-term>s can lead to the same destination. Because we often compute things that are related to our daily experience it is not surprising that this is a very common pattern. And this is not a coincidence, this is the reason functions are defined as they are.
- </p>
-
- <script src="style/style_orchestrator.js"></script>
- <script>
- window.StyleRT.style_orchestrator();
- </script>
- </RT-article>
- </body>
-</html>
+++ /dev/null
-/*
- Processes <RT-TOC> tags.
- Populates each with headings found below it.
-
- Attributes:
- level="N" : Explicitly sets the target heading level (1-6).
- e.g., level="1" collects H1s. level="2" collects H2s.
- Stops collecting if it hits a heading of (level - 1) or higher.
-
- Default (No attribute):
- Context-Aware. Looks backwards for the nearest heading H(N).
- Targets H(N+1). Stops at the next H(N).
-*/
-window.StyleRT = window.StyleRT || {};
-
-window.StyleRT.RT_TOC = function() {
- const debug = window.StyleRT.debug || { log: function(){} };
- const toc_tags = document.querySelectorAll('rt-toc');
-
- toc_tags.forEach((container, toc_index) => {
- container.style.display = 'block';
-
- // 1. Determine Target Level
- const attr_level = parseInt(container.getAttribute('level'));
- let target_level;
-
- if (!isNaN(attr_level)) {
- // EXPLICIT MODE
- target_level = attr_level;
- if (debug.log) debug.log('RT_TOC', `TOC #${toc_index} explicit target: H${target_level}`);
- } else {
- // IMPLICIT / CONTEXT MODE
- let context_level = 0; // Default 0 (Root)
- let prev = container.previousElementSibling;
- while (prev) {
- const match = prev.tagName.match(/^H([1-6])$/);
- if (match) {
- context_level = parseInt(match[1]);
- break;
- }
- prev = prev.previousElementSibling;
- }
- target_level = context_level + 1;
- if (debug.log) debug.log('RT_TOC', `TOC #${toc_index} context implied target: H${target_level}`);
- }
-
- // Stop condition: Stop if we hit a heading that is a "parent" or "sibling" of the context.
- // Mathematically: Stop if found_level < target_level.
- const stop_threshold = target_level;
-
- // 2. Setup Container
- container.innerHTML = '';
- const title = document.createElement('h1');
- // Title logic: If targeting H1, it's a Main TOC. Otherwise it's a Section TOC.
- title.textContent = target_level === 1 ? 'Table of Contents' : 'Section Contents';
- title.style.textAlign = 'center';
- container.appendChild(title);
-
- const list = document.createElement('ul');
- list.style.listStyle = 'none';
- list.style.paddingLeft = '0';
- container.appendChild(list);
-
- // 3. Scan Forward
- let next_el = container.nextElementSibling;
- while (next_el) {
- const match = next_el.tagName.match(/^H([1-6])$/);
- if (match) {
- const found_level = parseInt(match[1]);
-
- // STOP Logic:
- // If we are looking for H2s, we stop if we hit an H1 (level 1).
- // If we are looking for H1s, we stop if we hit... nothing (level 0).
- if (found_level < target_level) {
- break;
- }
-
- // COLLECT Logic:
- if (found_level === target_level) {
- if (!next_el.id) next_el.id = `toc-ref-${toc_index}-${found_level}-${list.children.length}`;
-
- const li = document.createElement('li');
- li.style.marginBottom = '0.5rem';
-
- const a = document.createElement('a');
- a.href = `#${next_el.id}`;
- a.textContent = next_el.textContent;
- a.style.textDecoration = 'none';
- a.style.color = 'inherit';
- a.style.display = 'block';
-
- a.onmouseover = () => a.style.color = 'var(--rt-brand-primary)';
- a.onmouseout = () => a.style.color = 'inherit';
-
- li.appendChild(a);
- list.appendChild(li);
- }
- }
- next_el = next_el.nextElementSibling;
- }
- });
-};
+++ /dev/null
-/*
- Processes <RT-CODE> tags.
- Uses the central config or CSS variables from the theme.
-*/
-function RT_code() {
- const RT = window.StyleRT;
- const U = RT.utility;
- const debug = RT.debug;
-
- debug.log('RT_code', 'Starting render cycle.');
-
- const metrics = U.measure_ink_ratio('monospace');
-
- // Scoped Selector: find code blocks anywhere, but styling relies on inheritance
- document.querySelectorAll('rt-code').forEach((el) => {
- el.style.fontFamily = 'monospace';
-
- // Check context for accent color (CSS Variable fallback)
- const computed = window.getComputedStyle(el);
- const accent = computed.getPropertyValue('--rt-accent').trim() || 'gold';
-
- const is_block = U.is_block_content(el);
- const parentColor = computed.color;
- const is_text_light = U.is_color_light(parentColor);
-
- const alpha = is_block ? 0.08 : 0.15;
- const overlay = is_text_light ? `rgba(255,255,255,${alpha})` : `rgba(0,0,0,${alpha})`;
- const text_color = is_text_light ? '#ffffff' : '#000000';
-
- el.style.backgroundColor = overlay;
-
- if (is_block) {
- el.style.display = 'block';
- el.style.whiteSpace = 'pre';
- el.style.fontSize = (parseFloat(computed.fontSize) * metrics.ratio * 0.95) + 'px';
- el.style.padding = '1.2rem';
- el.style.margin = '1.5rem 0';
- el.style.borderLeft = `4px solid ${accent}`;
- el.style.color = 'inherit';
- } else {
- el.style.display = 'inline';
- const exactPx = parseFloat(computed.fontSize) * metrics.ratio * 1.0;
- el.style.fontSize = exactPx + 'px';
- el.style.padding = '0.1rem 0.35rem';
- el.style.borderRadius = '3px';
- // Vertical align fix for inline code
- const offsetPx = metrics.baseline_diff * (exactPx / 100);
- el.style.verticalAlign = offsetPx + 'px';
- el.style.color = text_color;
- }
- });
-
- debug.log('RT_code', 'Render cycle complete.');
-}
-
-window.StyleRT = window.StyleRT || {};
-window.StyleRT.RT_code = RT_code;
+++ /dev/null
-/*
- Processes <RT-MATH> tags.
- JavaScript: RT_math()
- HTML Tag: <RT-MATH> (parsed as rt-math)
-*/
-function RT_math(){
- // querySelector treats 'rt-math' as case-insensitive for the tag
- document.querySelectorAll('rt-math').forEach(el => {
- if (el.textContent.startsWith('$')) return;
-
- const is_block = el.parentElement.tagName === 'DIV' ||
- el.textContent.includes('\n') ||
- el.parentElement.childNodes.length === 1;
-
- const delimiter = is_block ? '$$' : '$';
- el.style.display = is_block ? 'block' : 'inline';
- el.textContent = `${delimiter}${el.textContent.trim()}${delimiter}`;
- });
-
- // MathJax must find its config at window.MathJax
- window.MathJax = {
- tex: {
- inlineMath: [['$', '$']],
- displayMath: [['$$', '$$']]
- }
- };
-
- const script = document.createElement('script');
- script.src = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js';
- script.async = true;
- document.head.appendChild(script);
-}
-
-window.StyleRT = window.StyleRT || {};
-window.StyleRT.RT_math = RT_math;
+++ /dev/null
-/*
- Processes <RT-TERM> and <RT-NEOLOGISM> tags.
- - Styles only the first occurrence of a unique term/neologism.
- - The "-em" variants (e.g., <RT-term-em>) are always styled.
- - Automatically generates IDs for first occurrences for future indexing.
-*/
-
-window.StyleRT = window.StyleRT || {};
-
-window.StyleRT.RT_term = function() {
- const RT = window.StyleRT;
-
- const debug = RT.debug || {
- log: function() {}
- ,warn: function() {}
- ,error: function() {}
- };
-
- const DEBUG_TOKEN_S = 'term';
-
- try {
- // Track seen terms so only the first occurrence is decorated
- const seen_terms_dpa = new Set();
-
- const apply_style = (el, is_neologism_b) => {
- el.style.fontStyle = 'italic';
- el.style.fontWeight = is_neologism_b ? '600' : '500';
- el.style.color = is_neologism_b
- ? 'var(--rt-brand-secondary)'
- : 'var(--rt-brand-primary)';
- el.style.paddingRight = '0.1em'; // Compensation for italic slant
- el.style.display = 'inline';
- };
-
- const clear_style = (el) => {
- el.style.fontStyle = 'normal';
- el.style.color = 'inherit';
- el.style.fontWeight = 'inherit';
- el.style.paddingRight = '';
- el.style.display = '';
- };
-
- const selector_s = [
- 'rt-term'
- ,'rt-term-em'
- ,'rt-neologism'
- ,'rt-neologism-em'
- ].join(',');
-
- const tags_dpa = document.querySelectorAll(selector_s);
-
- debug.log(DEBUG_TOKEN_S, `Scanning ${tags_dpa.length} term tags`);
-
- tags_dpa.forEach(el => {
- const tag_name_s = el.tagName.toLowerCase();
- const is_neologism_b = tag_name_s.includes('neologism');
- const is_explicit_em_b = tag_name_s.endsWith('-em');
-
- const term_text_raw_s = (el.textContent || '').trim();
- if (!term_text_raw_s.length) {
- debug.warn(DEBUG_TOKEN_S, `Empty term tag encountered: <${tag_name_s}>`);
- return;
- }
-
- // Normalize text for uniqueness tracking
- const term_norm_s = term_text_raw_s.toLowerCase();
-
- // Slug for ID generation (simple + stable)
- const slug_s = term_norm_s.replace(/\s+/g, '-');
-
- const is_first_occurrence_b = !seen_terms_dpa.has(term_norm_s);
-
- if (is_explicit_em_b || is_first_occurrence_b) {
- apply_style(el, is_neologism_b);
-
- if (!is_explicit_em_b && is_first_occurrence_b) {
- seen_terms_dpa.add(term_norm_s);
-
- if (!el.id) {
- el.id = `def-${is_neologism_b ? 'neo-' : ''}${slug_s}`;
- debug.log(
- DEBUG_TOKEN_S
- ,`First occurrence: "${term_norm_s}" -> id="${el.id}"`
- );
- } else {
- debug.log(
- DEBUG_TOKEN_S
- ,`First occurrence: "${term_norm_s}" (existing id="${el.id}")`
- );
- }
- } else if (is_explicit_em_b) {
- debug.log(
- DEBUG_TOKEN_S
- ,`Emphasized occurrence: "${term_norm_s}" (<${tag_name_s}>)`
- );
- }
- } else {
- // Subsequent mentions render as normal prose
- clear_style(el);
- }
- });
-
- debug.log(DEBUG_TOKEN_S, `Unique terms defined: ${seen_terms_dpa.size}`);
- } catch (e) {
- debug.error('error', `RT_term failed: ${e && e.message ? e.message : String(e)}`);
- }
-};
+++ /dev/null
-/*
- Processes <RT-TITLE> tags.
- Generates a standard document header block.
-
- Usage:
- <RT-title title="..." author="..." date="..."></RT-title>
-*/
-window.StyleRT = window.StyleRT || {};
-
-window.StyleRT.RT_title = function() {
- const debug = window.StyleRT.debug || { log: function(){} };
-
- document.querySelectorAll('rt-title').forEach(el => {
- const title = el.getAttribute('title') || 'Untitled Document';
- const author = el.getAttribute('author');
- const date = el.getAttribute('date');
-
- if (debug.log) debug.log('RT_title', `Generating title block: ${title}`);
-
- // Container
- const container = document.createElement('div');
- container.style.textAlign = 'center';
- container.style.marginBottom = '3rem';
- container.style.marginTop = '2rem';
- container.style.borderBottom = '1px solid var(--rt-border-default)';
- container.style.paddingBottom = '1.5rem';
-
- // Main Title (H1)
- const h1 = document.createElement('h1');
- h1.textContent = title;
- h1.style.margin = '0 0 0.8rem 0';
- h1.style.border = 'none'; // Override standard H1 border
- h1.style.padding = '0';
- h1.style.color = 'var(--rt-brand-primary)';
- h1.style.fontSize = '2.5em';
- h1.style.lineHeight = '1.1';
- h1.style.letterSpacing = '-0.03em';
-
- container.appendChild(h1);
-
- // Metadata Row (Author | Date)
- if (author || date) {
- const meta = document.createElement('div');
- meta.style.color = 'var(--rt-content-muted)';
- meta.style.fontStyle = 'italic';
- meta.style.fontSize = '1.1em';
- meta.style.fontFamily = '"Georgia", "Times New Roman", serif'; // Classy serif
-
- const parts = [];
- if (author) parts.push(`<span style="font-weight:600; color:var(--rt-brand-secondary)">${author}</span>`);
- if (date) parts.push(date);
-
- meta.innerHTML = parts.join(' — ');
- container.appendChild(meta);
- }
-
- // Replace the raw tag with the generated block
- el.replaceWith(container);
- });
-};
+++ /dev/null
-/* Style: The "State Department" Override
- Description: Restores decorum.
-*/
-(function(){
- const RT = window.StyleRT || {};
-
- // Force the font regardless of other settings
- RT.rubio = function() {
- const articles = document.querySelectorAll("rt-article");
- articles.forEach(el => {
- el.style.fontFamily = '"Times New Roman", "Times", serif';
- el.style.letterSpacing = "0px"; // No modern spacing allowed
- });
- };
-})();
+++ /dev/null
-/*
- Article Layout: Technical Reference
- Standard: Theme 1.0
- Description: High-readability layout for technical documentation on screens.
- Features: Sans-serif, justified text, distinct headers, boxed code.
-*/
-(function(){
- const RT = window.StyleRT = window.StyleRT || {};
-
- RT.article = function() {
- const debug = RT.debug || { log: function(){} };
- debug.log('layout', 'RT.article starting...');
-
- RT.config = RT.config || {};
-
- // Default Configuration
- RT.config.article = {
- font_family: '"Noto Sans", "Segoe UI", "Helvetica Neue", sans-serif'
- ,line_height: "1.8"
- ,font_size: "16px"
- ,font_weight: "400" // Default (String)
- ,max_width: "820px"
- ,margin: "0 auto"
- };
-
- // SAFE THEME DETECTION
- // If the theme is loaded and explicitly Light, bump the weight.
- try {
- if (RT.config.theme && RT.config.theme.meta_is_dark === false) {
- RT.config.article.font_weight = "600";
- debug.log('layout', 'Light theme detected: adjusting font weight to 600.');
- }
- } catch(e) {
- console.warn("StyleRT: Auto-weight adjustment failed, using default.", e);
- }
-
- const conf = RT.config.article;
- const article_seq = document.querySelectorAll("RT-article");
-
- if(article_seq.length === 0) {
- debug.log('layout', 'No <RT-article> elements found. Exiting.');
- return;
- }
-
- // 1. Apply Container Styles
- article_seq.forEach( (article) =>{
- const style = article.style;
- style.display = "block";
- style.fontFamily = conf.font_family;
- style.fontSize = conf.font_size;
- style.lineHeight = conf.line_height;
- style.fontWeight = conf.font_weight;
- style.maxWidth = conf.max_width;
- style.margin = conf.margin;
- style.padding = "0 20px";
- style.color = "var(--rt-content-main)";
- });
-
- // 2. Inject Child Typography
- const style_id = 'rt-article-typography';
- if (!document.getElementById(style_id)) {
- debug.log('layout', 'Injecting CSS typography rules.');
- const style_el = document.createElement('style');
- style_el.id = style_id;
-
- style_el.textContent = `
- /* --- HEADERS --- */
- rt-article h1 {
- color: var(--rt-brand-primary);
- font-size: 2.0em;
- font-weight: 500;
- text-align: center;
- margin-top: 1.2em;
- margin-bottom: 0.6em;
- border-bottom: 2px solid var(--rt-border-default);
- padding-bottom: 0.3em;
- line-height: 1.2;
- letter-spacing: -0.02em;
- }
-
- rt-article h2 {
- color: var(--rt-brand-secondary);
- font-size: 1.5em;
- font-weight: 400;
- text-align: center;
- margin-top: 1.0em;
- margin-bottom: 0.5em;
- }
-
- rt-article h2 + h3 {
- margin-top: -0.3em;
- padding-top: 0;
- }
-
- rt-article h3 {
- color: var(--rt-brand-tertiary);
- font-size: 1.4em;
- font-weight: 400;
- margin-top: 1.0em;
- margin-bottom: 0.5em;
- }
-
- /* --- DEEP LEVELS (H4-H6) --- */
- rt-article h4, rt-article h5, rt-article h6 {
- color: var(--rt-brand-tertiary);
- font-weight: bold;
- margin-top: 1.2em;
- font-style: italic;
- }
- rt-article h4 { margin-left: 2em; }
- rt-article h5 { margin-left: 4em; }
- rt-article h6 { margin-left: 6em; }
-
- /* --- BODY TEXT --- */
- rt-article p {
- margin-bottom: 1.4em;
- text-align: justify;
- hyphens: auto;
- color: var(--rt-content-main);
- }
-
- /* --- RICH ELEMENTS --- */
- rt-article blockquote {
- border-left: 4px solid var(--rt-brand-secondary);
- margin: 1.5em 0;
- padding: 0.5em 1em;
- font-style: italic;
- color: var(--rt-content-muted);
- background: var(--rt-surface-1);
- border-radius: 0 4px 4px 0;
- }
-
- rt-article ul, rt-article ol {
- margin-bottom: 1.4em;
- padding-left: 2em;
- }
- rt-article li {
- margin-bottom: 0.4em;
- }
- rt-article li::marker {
- color: var(--rt-brand-secondary);
- font-weight: bold;
- }
-
- /* Links */
- rt-article a {
- color: var(--rt-brand-link);
- text-decoration: none;
- border-bottom: 1px dotted var(--rt-border-default);
- transition: all 0.2s;
- }
- rt-article a:hover {
- color: var(--rt-brand-primary);
- border-bottom: 1px solid var(--rt-brand-primary);
- background: var(--rt-surface-1);
- }
-
- /* --- TECHNICAL --- */
- rt-article pre {
- background: var(--rt-surface-code);
- padding: 1em;
- border-radius: 4px;
- overflow-x: auto;
- border: 1px solid var(--rt-border-default);
- }
- `;
- document.head.appendChild(style_el);
- }
- };
-})();
+++ /dev/null
-/*
- Targets the root element to ensure total blackout during load.
-*/
-function body_visibility_hidden(){
- const gate = document.createElement('style');
- gate.id = 'rt-visibility-gate';
- gate.textContent = 'html{visibility:hidden !important; background:black !important;}';
- document.head.appendChild(gate);
-}
-
-window.StyleRT = window.StyleRT || {};
-window.StyleRT.body_visibility_hidden = body_visibility_hidden;
+++ /dev/null
-/*
- Restores visibility by removing the visibility gate.
-*/
-function body_visibility_visible(){
- const gate = document.getElementById('rt-visibility-gate');
- if (gate){
- gate.remove();
- }
- document.body.style.visibility = 'visible';
-}
-
-window.StyleRT = window.StyleRT || {};
-window.StyleRT.body_visibility_visible = body_visibility_visible;
+++ /dev/null
- <RT-article>: The root container.
- <RT-page>: The page wrapper.
-
-<RT-math>
-<RT-code>
-
- <RT-term>: For Conventional terms (standard definitions)
-<RT-neologism>: Terms introduced in this article
+++ /dev/null
-/*
- Page Layout: Fixed Glow
- Standard: Theme 1.0
- Description: A fixed-height container with a glowing border effect that matches the active theme.
-*/
-(function(){
- const RT = window.StyleRT = window.StyleRT || {};
-
- // Function name stays generic so the orchestrator can call RT.page() regardless of file choice
- RT.page = function() {
- RT.config = RT.config || {};
-
- // Default Configuration
- // We use CSS Variables here so the Theme controls the actual colors.
- const defaults = {
- width: "100%"
- ,height: "1056px"
- ,padding: "3rem"
- ,margin: "4rem auto"
-
- // Dynamic Theme Bindings
- ,bg_color: "var(--rt-surface-0)" // Black (Dark) or Cream (Light)
- ,border_color: "var(--rt-brand-primary)" // The Main Accent Color
- ,text_color: "var(--rt-brand-primary)" // Page Number Color
-
- // The Glow: Uses the primary brand color for the shadow
- ,shadow: "drop-shadow(0px 0px 15px var(--rt-brand-primary))"
- };
-
- // Merge defaults
- RT.config.page = Object.assign({}, defaults, RT.config.page || {});
-
- const conf = RT.config.page;
- const style_id = 'rt-page-fixed-glow';
-
- if (!document.getElementById(style_id)) {
- const style_el = document.createElement('style');
- style_el.id = style_id;
-
- style_el.textContent = `
- /* Reset page counter on the article container */
- rt-article {
- counter-reset: rt-page-counter;
- }
-
- rt-page {
- display: block;
- position: relative;
- box-sizing: border-box;
- overflow: hidden;
-
- /* Dimensions */
- width: ${conf.width};
- height: ${conf.height};
- margin: ${conf.margin};
- padding: ${conf.padding};
-
- /* Theming */
- background-color: ${conf.bg_color};
- border: 1px solid ${conf.border_color};
-
- /* The "Glow" Effect */
- filter: ${conf.shadow};
-
- /* Counter Increment */
- counter-increment: rt-page-counter;
- }
-
- /* Page Numbering */
- rt-page::after {
- content: "Page " counter(rt-page-counter);
- position: absolute;
- bottom: 1.5rem;
- right: 3rem;
-
- font-family: "Noto Sans", sans-serif;
- font-size: 0.9rem;
- font-weight: bold;
-
- color: ${conf.text_color};
- opacity: 0.8;
- pointer-events: none; /* Prevent interference with clicks */
- }
- `;
- document.head.appendChild(style_el);
- }
- };
-})();
+++ /dev/null
-/*
- Layout Paginator: paginate_by_element
-*/
-window.StyleRT = window.StyleRT || {};
-
-window.StyleRT.paginate_by_element = function() {
- const RT = window.StyleRT;
-
- // Fix: Read safely without overwriting the config namespace
- const page_conf = (RT.config && RT.config.page) ? RT.config.page : {};
- const page_height_limit = page_conf.height_limit || 1000;
-
- const article_seq = document.querySelectorAll("RT-article");
-
- // HURDLE: Error if no articles found to paginate
- if(article_seq.length === 0) {
- RT.debug.error('pagination', 'No <RT-article> elements found. Pagination aborted.');
- return;
- }
-
- article_seq.forEach( (article) => {
- const raw_elements = Array.from(article.children).filter(el =>
- !['SCRIPT', 'STYLE', 'RT-PAGE'].includes(el.tagName)
- );
-
- if(raw_elements.length === 0) return;
-
- const pages = [];
- let current_batch = [];
- let current_h = 0;
-
- const get_el_height = (el) => {
- const rect = el.getBoundingClientRect();
- const style = window.getComputedStyle(el);
- const margin = parseFloat(style.marginTop) + parseFloat(style.marginBottom);
- return (rect.height || 0) + (margin || 0);
- };
-
- for (let i = 0; i < raw_elements.length; i++) {
- const el = raw_elements[i];
- const h = get_el_height(el);
- const is_heading = /^H[1-6]/.test(el.tagName);
-
- let total_required_h = h;
- if (is_heading && i + 1 < raw_elements.length) {
- total_required_h += get_el_height(raw_elements[i + 1]);
- }
-
- if (current_h + total_required_h > page_height_limit && current_batch.length > 0) {
- pages.push(current_batch);
- current_batch = [];
- current_h = 0;
- }
-
- current_batch.push(el);
- current_h += h;
- }
-
- if (current_batch.length > 0) pages.push(current_batch);
-
- article.innerHTML = '';
-
- pages.forEach( (list, index) => {
- const page_el = document.createElement('rt-page');
- page_el.id = `page-${index+1}`;
- list.forEach(item => page_el.appendChild(item));
- article.appendChild(page_el);
- });
-
- if (RT.debug) RT.debug.log('pagination', `Article paginated into ${pages.length} pages.`);
- });
-};
+++ /dev/null
-/*
- Master Loader & Orchestrator for StyleRT.
-*/
-
-window.StyleRT = window.StyleRT || {};
-
-window.StyleRT.style_orchestrator = function() {
- const RT = window.StyleRT;
-
- const modules = [
- // Theme & Semantics
- 'style/RT_title.js',
- 'style/theme_dark_gold.js',
- 'style/RT_term.js',
- 'style/RT_math.js',
- 'style/RT_code.js',
- 'style/article_tech_ref.js',
- 'style/RT_TOC.js',
-
- // Layout & Pagination
- 'style/paginate_by_element.js',
- 'style/page_fixed_glow.js',
-
- // Visibility
- 'style/body_visibility_visible.js'
- ];
-
- // 1. Bootloader
- const utility = document.createElement('script');
- utility.src = 'style/utility.js';
-
- utility.onload = () => { load_next(0); };
- utility.onerror = () => { console.error("StyleRT: Critical failure - utility.js missing."); };
- document.head.appendChild(utility);
-
- // 2. The Chain Loader
- const load_next = (index) => {
- if (index >= modules.length) {
- run_style();
- return;
- }
- const src = modules[index];
- if (RT.debug) RT.debug.log('style', `Loading: ${src}`);
-
- const script = document.createElement('script');
- script.src = src;
- script.onload = () => load_next(index + 1);
- script.onerror = () => {
- console.error(`StyleRT: Failed load on ${src}`);
- load_next(index + 1);
- };
- document.head.appendChild(script);
- };
-
- // 3. Phase 1: Semantics
- const run_style = () => {
- RT.debug.log('style', 'Starting Phase 1: Setup & Semantics');
-
- // Naming Convention: RT.<filename_without_js>
- if(RT.theme) RT.theme();
- if(RT.article) RT.article();
-
- // NEW: Trigger the Title Generator
- if(RT.RT_title) RT.RT_title();
-
- if(RT.RT_term) RT.RT_term();
- if(RT.RT_math) RT.RT_math();
- if(RT.RT_code) RT.RT_code();
-
- if (window.MathJax && MathJax.Hub && MathJax.Hub.Queue) {
- RT.debug.log('style', 'MathJax detected. Queueing layout tasks...');
- MathJax.Hub.Queue(["Typeset", MathJax.Hub], continue_style);
- } else {
- continue_style();
- }
- };
-
- // 4. Phase 2: Layout
- const continue_style = () => {
- RT.debug.log('style', 'Starting Phase 2: Layout & Reveal');
-
- // Debug: Dump the config to see what values we are using
- if(RT.debug) RT.debug.log('config', JSON.stringify(RT.config || {}, null, 2));
-
- if(RT.RT_TOC) RT.RT_TOC();
- if(RT.paginate_by_element) RT.paginate_by_element();
- if(RT.page) RT.page(); // Defined in page_css_pn.js
- if(RT.body_visibility_visible) RT.body_visibility_visible();
-
- RT.debug.log('style', 'Style execution complete.');
- };
-};
+++ /dev/null
-/*
- Theme: Inverse Wheat (Dark)
- Standard: Theme 1.0
- Description: High contrast Amber on Deep Charcoal.
-*/
-( function(){
- const RT = window.StyleRT = window.StyleRT || {};
-
- RT.theme = function(){
- RT.config = RT.config || {};
-
- // THEME 1.0 DATA CONTRACT
- RT.config.theme = {
- meta_is_dark: true
- ,meta_name: "Inverse Wheat"
-
- // --- SURFACES (Depth & Container Hierarchy) ---
- ,surface_0: "hsl(0, 0%, 5%)" // App Background (Deepest)
- ,surface_1: "hsl(0, 0%, 10%)" // Sidebar / Nav / Panels
- ,surface_2: "hsl(0, 0%, 14%)" // Cards / Floating Elements
- ,surface_3: "hsl(0, 0%, 18%)" // Modals / Dropdowns / Popovers
- ,surface_input: "hsl(0, 0%, 12%)" // Form Inputs
- ,surface_code: "hsl(0, 0%, 11%)" // Code Block Background
- ,surface_select: "hsl(45, 100%, 15%)" // Text Selection Highlight
-
- // --- CONTENT (Text & Icons) ---
- ,content_main: "hsl(50, 60%, 85%)" // Primary Reading Text
- ,content_muted: "hsl(36, 15%, 60%)" // Metadata, subtitles
- ,content_subtle: "hsl(36, 10%, 40%)" // Placeholders, disabled states
- ,content_inverse: "hsl(0, 0%, 5%)" // Text on high-contrast buttons
-
- // --- BRAND & ACTION (The "Wheat" Identity) ---
- ,brand_primary: "hsl(45, 100%, 50%)" // Main Action / H1 / Focus Ring
- ,brand_secondary: "hsl(38, 90%, 65%)" // Secondary Buttons / H2
- ,brand_tertiary: "hsl(30, 60%, 70%)" // Accents / H3
- ,brand_link: "hsl(48, 100%, 50%)" // Hyperlinks (High Visibility)
-
- // --- BORDERS & DIVIDERS ---
- ,border_faint: "hsl(36, 20%, 15%)" // Subtle separation
- ,border_default: "hsl(36, 20%, 25%)" // Standard Card Borders
- ,border_strong: "hsl(36, 20%, 40%)" // Active states / Inputs
-
- // --- STATE & FEEDBACK (Earth Tones) ---
- ,state_success: "hsl(100, 50%, 45%)" // Olive Green
- ,state_warning: "hsl(35, 90%, 55%)" // Burnt Orange
- ,state_error: "hsl(0, 60%, 55%)" // Brick Red
- ,state_info: "hsl(200, 40%, 55%)" // Slate Blue
-
- // --- SYNTAX HIGHLIGHTING (For Code) ---
- ,syntax_keyword: "hsl(35, 100%, 65%)" // Orange
- ,syntax_string: "hsl(75, 50%, 60%)" // Sage Green
- ,syntax_func: "hsl(45, 90%, 70%)" // Light Gold
- ,syntax_comment: "hsl(36, 15%, 45%)" // Brown/Gray
- };
-
- // --- APPLY THEME ---
- const palette = RT.config.theme;
- const body = document.body;
- const html = document.documentElement;
-
- // 1. Paint Base
- html.style.backgroundColor = palette.surface_0;
- body.style.backgroundColor = palette.surface_0;
- body.style.color = palette.content_main;
-
- // 2. Export Variables (Standardization)
- const s = body.style;
- for (const [key, value] of Object.entries(palette)) {
- s.setProperty(`--rt-${key.replace(/_/g, '-')}`, value);
- }
-
- // 3. Global Overrides
- const style_id = 'rt-global-overrides';
- if (!document.getElementById(style_id)) {
- const style = document.createElement('style');
- style.id = style_id;
- style.textContent = `
- ::selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
- ::-moz-selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
-
- ::-webkit-scrollbar { width: 12px; }
- ::-webkit-scrollbar-track { background: var(--rt-surface-0); }
- ::-webkit-scrollbar-thumb {
- background: var(--rt-border-default);
- border: 2px solid var(--rt-surface-0);
- border-radius: 8px;
- }
- ::-webkit-scrollbar-thumb:hover { background: var(--rt-brand-secondary); }
- `;
- document.head.appendChild(style);
- }
- };
-
-} )();
+++ /dev/null
-/*
- Theme: Classic Wheat (Light)
- Standard: Theme 1.0
- Description: Warm paper tones with Burnt Orange accents.
-*/
-( function(){
- const RT = window.StyleRT = window.StyleRT || {};
-
- RT.theme_light = function(){
- RT.config = RT.config || {};
-
- // THEME 1.0 DATA CONTRACT
- RT.config.theme = {
- meta_is_dark: false
- ,meta_name: "Classic Wheat"
-
- // --- SURFACES ---
- ,surface_0: "hsl(40, 30%, 94%)" // App Background (Cream/Linen)
- ,surface_1: "hsl(40, 25%, 90%)" // Sidebar (Slightly darker beige)
- ,surface_2: "hsl(40, 20%, 98%)" // Cards (Lighter, almost white)
- ,surface_3: "hsl(0, 0%, 100%)" // Modals (Pure White)
- ,surface_input: "hsl(40, 20%, 98%)" // Form Inputs
- ,surface_code: "hsl(40, 15%, 90%)" // Code Block Background
- ,surface_select: "hsl(45, 100%, 85%)" // Text Selection Highlight
-
- // --- CONTENT ---
- ,content_main: "hsl(30, 20%, 20%)" // Deep Umber (Not Black)
- ,content_muted: "hsl(30, 15%, 45%)" // Medium Brown
- ,content_subtle: "hsl(30, 10%, 65%)" // Light Brown/Gray
- ,content_inverse: "hsl(40, 30%, 94%)" // Text on dark buttons
-
- // --- BRAND & ACTION ---
- ,brand_primary: "hsl(30, 90%, 35%)" // Burnt Orange (Action)
- ,brand_secondary: "hsl(35, 70%, 45%)" // Rust / Gold
- ,brand_tertiary: "hsl(25, 60%, 55%)" // Copper
- ,brand_link: "hsl(30, 100%, 35%)" // Link Color
-
- // --- BORDERS ---
- ,border_faint: "hsl(35, 20%, 85%)"
- ,border_default: "hsl(35, 20%, 75%)"
- ,border_strong: "hsl(35, 20%, 55%)"
-
- // --- STATE & FEEDBACK ---
- ,state_success: "hsl(100, 40%, 40%)" // Forest Green
- ,state_warning: "hsl(30, 90%, 50%)" // Persimmon
- ,state_error: "hsl(0, 60%, 45%)" // Crimson
- ,state_info: "hsl(200, 50%, 45%)" // Navy Blue
-
- // --- SYNTAX ---
- ,syntax_keyword: "hsl(20, 90%, 45%)" // Rust
- ,syntax_string: "hsl(100, 35%, 35%)" // Ivy Green
- ,syntax_func: "hsl(300, 30%, 40%)" // Muted Purple
- ,syntax_comment: "hsl(35, 10%, 60%)" // Light Brown
- };
-
- // --- APPLY THEME ---
- const palette = RT.config.theme;
- const body = document.body;
- const html = document.documentElement;
-
- html.style.backgroundColor = palette.surface_0;
- body.style.backgroundColor = palette.surface_0;
- body.style.color = palette.content_main;
-
- const s = body.style;
- for (const [key, value] of Object.entries(palette)) {
- s.setProperty(`--rt-${key.replace(/_/g, '-')}`, value);
- }
- };
-} )();
+++ /dev/null
-/*
- Theme: Golden Wheat (Light) - "Spanish Gold Edition"
- File: style/theme-light-gold.js
- Standard: Theme 1.0
- Description: Light Parchment background with Oxblood Red ink.
-*/
-( function(){
- const RT = window.StyleRT = window.StyleRT || {};
-
- RT.theme = function(){
- RT.config = RT.config || {};
-
- RT.config.theme = {
- meta_is_dark: false
- ,meta_name: "Golden Wheat (Yellow)"
-
- // --- SURFACES (Light Parchment) ---
- // Shifted lightness up to 94% for a "whiter" feel that still holds the yellow tint.
- ,surface_0: "hsl(48, 50%, 94%)" // Main Page: Fine Parchment
- ,surface_1: "hsl(48, 40%, 90%)" // Panels: Slightly darker
- ,surface_2: "hsl(48, 30%, 97%)" // Cards: Very light
- ,surface_3: "hsl(0, 0%, 100%)" // Popups
- ,surface_input: "hsl(48, 20%, 96%)"
- ,surface_code: "hsl(48, 25%, 88%)" // Distinct Code BG
- ,surface_select: "hsl(10, 70%, 85%)" // Red Highlight
-
- // --- CONTENT (Deep Ink) ---
- ,content_main: "hsl(10, 25%, 7%)" // Deep Warm Black (Ink)
- ,content_muted: "hsl(10, 15%, 35%)" // Dark Grey-Red
- ,content_subtle: "hsl(10, 10%, 55%)"
- ,content_inverse: "hsl(48, 50%, 90%)"
-
- // --- BRAND & ACTION (The Red Spectrum) ---
- ,brand_primary: "hsl(12, 85%, 30%)" // H1 (Deep Oxblood)
- ,brand_secondary: "hsl(10, 80%, 35%)" // H2 (Garnet)
- ,brand_tertiary: "hsl(8, 70%, 40%)" // H3 (Brick)
- ,brand_link: "hsl(12, 90%, 35%)" // Link
-
- // --- BORDERS ---
- ,border_faint: "hsl(45, 30%, 80%)"
- ,border_default: "hsl(45, 30%, 70%)" // Pencil Grey
- ,border_strong: "hsl(12, 50%, 40%)"
-
- // --- STATE ---
- ,state_success: "hsl(120, 40%, 30%)"
- ,state_warning: "hsl(25, 90%, 45%)"
- ,state_error: "hsl(0, 75%, 35%)"
- ,state_info: "hsl(210, 60%, 40%)"
-
- // --- SYNTAX ---
- ,syntax_keyword: "hsl(0, 75%, 35%)"
- ,syntax_string: "hsl(100, 35%, 25%)"
- ,syntax_func: "hsl(15, 85%, 35%)"
- ,syntax_comment: "hsl(45, 20%, 50%)"
- };
-
- // --- APPLY THEME ---
- const palette = RT.config.theme;
- const body = document.body;
- const html = document.documentElement;
-
- html.style.backgroundColor = palette.surface_0;
- body.style.backgroundColor = palette.surface_0;
- body.style.color = palette.content_main;
-
- const s = body.style;
- for (const [key, value] of Object.entries(palette)) {
- s.setProperty(`--rt-${key.replace(/_/g, '-')}`, value);
- }
-
- // Global overrides
- const style_id = 'rt-global-overrides';
- if (!document.getElementById(style_id)) {
- const style = document.createElement('style');
- style.id = style_id;
- style.textContent = `
- ::selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
- ::-moz-selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
-
- ::-webkit-scrollbar { width: 12px; }
- ::-webkit-scrollbar-track { background: var(--rt-surface-0); }
- ::-webkit-scrollbar-thumb {
- background: var(--rt-border-default);
- border: 2px solid var(--rt-surface-0);
- border-radius: 8px;
- }
- ::-webkit-scrollbar-thumb:hover { background: var(--rt-brand-secondary); }
-
- rt-article p, rt-article li {
- text-shadow: 0px 0px 0.5px rgba(0,0,0, 0.2);
- }
-
- .MathJax, .MathJax_Display, .mjx-chtml {
- color: var(--rt-content-main) !important;
- fill: var(--rt-content-main) !important;
- stroke: var(--rt-content-main) !important;
- }
- `;
- document.head.appendChild(style);
- }
- };
-
-} )();
+++ /dev/null
-/*
- General utilities for the StyleRT library.
-*/
-
-window.StyleRT = window.StyleRT || {};
-
-// --- DEBUG SYSTEM ---
-window.StyleRT.debug = {
-
- // all debug messages enabled
-/*
- active_tokens: new Set([
- 'style', 'layout', 'pagination'
- ,'selector', 'config', 'error'
- ,'term'
- ]),
-*/
- active_tokens: new Set([
- 'term'
- ]),
-
- log: function(token, message) {
- if (this.active_tokens.has(token)) {
- console.log(`[StyleRT:${token}]`, message);
- }
- },
-
- warn: function(token, message) {
- if (this.active_tokens.has(token)) {
- console.warn(`[StyleRT:${token}]`, message);
- }
- },
-
- // New: Always log errors regardless of token, but tag them
- error: function(token, message) {
- console.error(`[StyleRT:${token}] CRITICAL:`, message);
- },
-
- enable: function(token) { this.active_tokens.add(token); console.log(`Enabled: ${token}`); },
- disable: function(token) { this.active_tokens.delete(token); console.log(`Disabled: ${token}`); }
-};
-
-// --- UTILITIES ---
-window.StyleRT.utility = {
- // --- FONT PHYSICS ---
- measure_ink_ratio: function(target_font, ref_font = null) {
- const debug = window.StyleRT.debug;
- debug.log('layout', `Measuring ink ratio for ${target_font}`);
-
- const canvas = document.createElement('canvas');
- const ctx = canvas.getContext('2d');
-
- if (!ref_font) {
- const bodyStyle = window.getComputedStyle(document.body);
- ref_font = bodyStyle.fontFamily;
- }
-
- const get_metrics = (font) => {
- ctx.font = '100px ' + font;
- const metrics = ctx.measureText('M');
- return {
- ascent: metrics.actualBoundingBoxAscent,
- descent: metrics.actualBoundingBoxDescent
- };
- };
-
- const ref_m = get_metrics(ref_font);
- const target_m = get_metrics(target_font);
-
- const ratio = ref_m.ascent / target_m.ascent;
- // debug.log('layout', `Ink Ratio calculated: ${ratio.toFixed(3)}`);
-
- return {
- ratio: ratio,
- baseline_diff: ref_m.descent - target_m.descent
- };
- },
-
- // --- COLOR PHYSICS ---
- is_color_light: function(color_string) {
- const debug = window.StyleRT.debug;
-
- // 1. HSL Check
- if (color_string.startsWith('hsl')) {
- const numbers = color_string.match(/\d+/g);
- if (numbers && numbers.length >= 3) {
- const lightness = parseInt(numbers[2]);
- return lightness > 50;
- }
- }
-
- // 2. RGB Check
- const rgb = color_string.match(/\d+/g);
- if (!rgb) {
- // debug.warn('color_layout', `Failed to parse color: "${color_string}". Defaulting to Light.`);
- return true;
- }
-
- const r = parseInt(rgb[0]);
- const g = parseInt(rgb[1]);
- const b = parseInt(rgb[2]);
- const luma = (r * 299 + g * 587 + b * 114) / 1000;
- return luma > 128;
- },
-
- is_block_content: function(element) {
- return element.textContent.trim().includes('\n');
- }
-};
+++ /dev/null
-<!DOCTYPE html>
-<html lang="en">
-<head>
- <meta charset="UTF-8">
- <title>RT Style System: Reference Manual</title>
-
- <script src="style/body_visibility_hidden.js"></script>
- <script> window.StyleRT.body_visibility_hidden(); </script>
-
- <script src="style/utility.js"></script>
-
- <script src="style/theme_dark_gold.js"></script>
-
- <script src="style/article_tech_ref.js"></script>
-
- <script src="style/RT_math.js"></script>
- <script src="style/RT_code.js"></script>
- <script src="style/RT_term.js"></script>
- <script src="style/RT_TOC.js"></script>
-
-</head>
-<body>
-
- <RT-article>
- <RT-title author="Gemini" date="2026-01-14" title="RT Style System: Reference Manual"></RT-title>
-
- <RT-TOC level="1"></RT-TOC>
-
- <h1>Architecture Overview</h1>
- <p>
- The <RT-term>RT Style System</RT-term> is a client-side, JavaScript-driven publishing framework designed to turn raw HTML into high-readability technical documentation. Unlike standard CSS frameworks, RT uses JavaScript to handle complex layout tasks like <RT-neologism>ink-ratio balancing</RT-neologism> and dynamic pagination.
- </p>
-
- <h2>The Orchestrator</h2>
- <p>
- The core of the system is <RT-code>style_orchestrator.js</RT-code>. It is placed at the bottom of the HTML <RT-code><body></RT-code>. Its job is to:
- </p>
- <ol>
- <li>Detect which modules are already loaded.</li>
- <li>Load missing modules (defaulting to Dark Theme if none is specified).</li>
- <li>Execute the <strong>Semantics Phase</strong> (styling tags).</li>
- <li>Wait for MathJax (if present).</li>
- <li>Execute the <strong>Layout Phase</strong> (pagination, page rendering).</li>
- <li>Reveal the document.</li>
- </ol>
-
- <h1>Semantic Tags</h1>
- <p>
- The system relies on a specific set of custom tags in the <RT-code>RT-</RT-code> namespace to separate structure from presentation.
- </p>
-
- <h2>Terminology</h2>
-
- <h3>Conventional Terms</h3>
- <p>
- Use <RT-code><RT-term></RT-code> for standard, industry accepted technical terms. The system decorates only the first occurrence of each unique term so that the first appearance functions as a definition point, and later appearances do not overload the page with styling.
- </p>
-
- <RT-code>
-The <RT-term>Singleton Pattern</RT-term> restricts instantiation...
- </RT-code>
-
- <p>
- <em>Renders as:</em> The <RT-term>Singleton Pattern</RT-term> restricts instantiation...
- </p>
-
- <h3>Neologisms</h3>
- <p>
- Use <RT-code><RT-neologism></RT-code> for terms invented specifically for the current document or project. Neologisms are styled more strongly than conventional terms, visually distinguishing "jargon you should know" from "jargon we just made up."
- </p>
-
- <RT-code>
-We define the <RT-neologism>Hyper Tape</RT-neologism> as a construct...
- </RT-code>
-
- <p>
- <em>Renders as:</em> We define the <RT-neologism>Hyper Tape</RT-neologism> as a construct...
- </p>
-
- <h3>First Occurrence Rule</h3>
- <p>
- The term system is intentionally conservative. For the tags <RT-code><RT-term></RT-code> and <RT-code><RT-neologism></RT-code>, only the first occurrence of a unique term is decorated. Subsequent mentions are rendered as normal prose.
- </p>
-
- <p>
- Uniqueness is tracked by normalizing the term text (trimmed, then lowercased). This means that <RT-code>Symbol</RT-code> and <RT-code>symbol</RT-code> count as the same term.
- </p>
-
- <h3>Forced Emphasis Variants</h3>
- <p>
- Sometimes a later mention of a term should be emphasized again. For that purpose, the system provides explicit emphasis tags:
- </p>
-
- <ul>
- <li><RT-code><RT-term-em></RT-code></li>
- <li><RT-code><RT-neologism-em></RT-code></li>
- </ul>
-
- <p>
- These variants are always decorated, even if the term appeared earlier.
- </p>
-
- <h3>Automatic Definition Anchors</h3>
- <p>
- For first occurrences, the term module automatically assigns an <RT-code>id</RT-code> attribute if one does not already exist. This creates stable anchors for future indexing and linking.
- </p>
-
- <RT-code>
-We define a <RT-term>Symbol</RT-term> as...
- </RT-code>
-
- <p>
- The first occurrence will be given an id similar to <RT-code>def-symbol</RT-code>. For neologisms, an additional marker is used, for example <RT-code>def-neo-hyper-tape</RT-code>.
- </p>
-
- <h2>Technical Content</h2>
-
- <h3>Code</h3>
- <p>
- Use <RT-code><RT-code></RT-code>. If placed inline, it acts like a span. If placed as a block (with newlines), it acts like a pre formatted block with a theme aware border.
- </p>
-
- <RT-code>
-# Block Code Example
-def hello():
- return "World"
- </RT-code>
-
- <h3>Mathematics</h3>
- <p>
- Use <RT-code><RT-math></RT-code>. The system auto detects if it is a block equation or inline variable and wraps it in MathJax delimiters.
- </p>
- <p>
- Inline: Let <RT-math>x</RT-math> be the input.
- </p>
- <p>
- Block:
- </p>
- <RT-math>
- f(x) = \sum_{i=0}^{n} x_i
- </RT-math>
-
- <h1>Navigation & Layout</h1>
-
- <h2>Automatic Table of Contents</h2>
- <p>
- Use <RT-code><RT-TOC></RT-code> to insert a generated table of contents. The tag scans the document <em>forward</em> from its current position to collect headings.
- </p>
-
- <h3>Explicit Mode</h3>
- <p>
- Use the <RT-code>level="N"</RT-code> attribute to target a specific heading depth.
- </p>
- <ul>
- <li><RT-code><RT-TOC level="1"></RT-code>: Collects all <RT-code><h1></RT-code> elements until the end of the document. Best for the main document index.</li>
- <li><RT-code><RT-TOC level="2"></RT-code>: Collects all <RT-code><h2></RT-code> elements until it encounters the next <RT-code><h1></RT-code>. Best for chapter summaries.</li>
- </ul>
-
- <h3>Implicit Mode</h3>
- <p>
- If no level is specified, the TOC scans backwards to find the nearest heading (for example H1) and assumes you want to collect children one level deeper (for example H2).
- </p>
- <p>
- <em>Note: Implicit mode can fail if placed before the first heading of a section. Use explicit levels for robust results.</em>
- </p>
-
- <h2>The Title Block</h2>
- <p>
- Use <RT-code><RT-title></RT-code> as the first element in your <RT-code><body></RT-code> (before the article container). This tag generates a standardized, styled header block with the document title and metadata.
- </p>
-
- <h3>Attributes</h3>
- <ul>
- <li><RT-code>title</RT-code> (Required): The main heading of the document.</li>
- <li><RT-code>author</RT-code> (Optional): The author's name. Renders in a bold accent color.</li>
- <li><RT-code>date</RT-code> (Optional): The publication or revision date.</li>
- </ul>
-
- <h3>Example</h3>
- <RT-code>
- <RT-title
- title="RT Style System: Reference Manual"
- author="Gemini"
- date="2026-01-14">
- </RT-title>
- </RT-code>
-
- <p>
- <em>Renders as:</em> A centered, high contrast H1 followed by a serif styled metadata row containing the author and date.
- </p>
-
- <h2>The Article Container</h2>
- <p>
- The root element must be <RT-code><RT-article></RT-code>. This is the boundary for the pagination logic.
- </p>
-
- <h2>Pagination</h2>
- <p>
- The script <RT-code>paginate_by_element.js</RT-code> scans the article. It calculates the height of every element (including margins) and bundles them into <RT-code><RT-page></RT-code> elements.
- </p>
- <p>
- <RT-neologism>Soft Limit Pagination</RT-neologism>: The system attempts to keep headers with their following paragraphs. It will break a page early rather than stranding a header at the bottom.
- </p>
-
- <h1>Debugging</h1>
-
- <h2>Debug Tokens</h2>
- <p>
- RT provides a lightweight debug logging system in <RT-code>utility.js</RT-code>. Logging is controlled by a set of active debug tokens. Each log message is assigned a token, and the message prints only if that token is enabled.
- </p>
-
- <p>
- Examples of common tokens include <RT-code>style</RT-code>, <RT-code>layout</RT-code>, <RT-code>pagination</RT-code>, <RT-code>selector</RT-code>, <RT-code>config</RT-code>, and <RT-code>term</RT-code>.
- </p>
-
- <h2>How Logging is Gated</h2>
- <p>
- Normal log and warning output are gated. The methods <RT-code>debug.log(token,message)</RT-code> and <RT-code>debug.warn(token,message)</RT-code> will print only when the token exists in <RT-code>debug.active_tokens</RT-code>.
- </p>
-
- <p>
- This prevents the console from being flooded during normal use, while still allowing deep visibility during development.
- </p>
-
- <h2>Errors are Always Printed</h2>
- <p>
- Errors are treated differently. The method <RT-code>debug.error(token,message)</RT-code> always prints, regardless of token state. These messages represent failures that require attention.
- </p>
-
- <h2>Enabling and Disabling Tokens</h2>
- <p>
- Tokens may be enabled or disabled in two ways: by editing the <RT-code>active_tokens</RT-code> set in <RT-code>utility.js</RT-code>, or at runtime by calling:
- </p>
-
- <RT-code>
-window.StyleRT.debug.enable('term')
-window.StyleRT.debug.disable('term')
- </RT-code>
-
- <p>
- For example, the term system (<RT-code>RT_term.js</RT-code>) uses the <RT-code>term</RT-code> token. When that token is enabled, the module will print messages describing how terms were detected and which term definitions were assigned IDs.
- </p>
-
- <h1>Themes</h1>
- <p>
- The system supports hot swapping themes by changing the script import in the head.
- </p>
- <ul>
- <li><strong>Dark:</strong> <RT-code>style/theme_dark_gold.js</RT-code> (Default)</li>
- <li><strong>Light:</strong> <RT-code>style/theme_light_gold.js</RT-code></li>
- </ul>
-
- <h1>Manifest</h1>
- <RT-code>
-1. style_orchestrator.js (Example/default footer script)
-2. utility.js (Math/Color physics)
-3. article_tech_ref.js (Typography and CSS injection)
-4. RT_code.js (Code block logic)
-5. RT_math.js (MathJax wrapper)
-6. RT_term.js (Term styling)
-7. RT_TOC.js (Navigation generator)
-8. paginate_by_element.js (Page splitter)
-9. page_fixed_glow.js (Visual page container)
- </RT-code>
-
- <script src="style/style_orchestrator.js"></script>
- <script>
- window.StyleRT.style_orchestrator();
- </script>
- </RT-article>
-</body>
-</html>
+++ /dev/null
-<!DOCTYPE html>
-<html lang="en">
-<head>
- <meta charset="UTF-8">
- <title>Test File</title>
- <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+JP&display=swap" rel="stylesheet">
-
- <script src="style/body_visibility_hidden.js"></script>
- <script>
- window.StyleRT.body_visibility_hidden();
- </script>
-</head>
-<body>
-
- <p> text before the first heading </p>
-
- <h1>Given</h1>
- <p>The English language is a given, apparently.</p>
- <p>
- This discussion happens to appear in the context of a Python implementation.
- </p>
-
- <h1>Symbol</h1>
- <h2>Definition</h2>
- <p>x
- We have a symbol instance factory. Each time the <RT-code>make</RT-code>
- method is called, we get a unique identity <RT-math>i</RT-math>.
-
- A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- </p>
- <RT-code>
-x = y
-# y is a variable holding a symbol instance
- </RT-code>
-
- <p>
- 1. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 2. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 3. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 4. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 5. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 6. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 7. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 8. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 11. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 12. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 13. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 14. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 15. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 16. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 17. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- 18. A symbol instance may be copied as though it were an integer.
- Thus, a common method for making a copy is assignment:
- </p>
-
-
- <h1>Path</h1>
- <h2>Discrete Function</h2>
- <p>Topologically it gives us a satisfying feeling that a given 'way' never leads to different destinations.</p>
-
- <p>A common notation for a function is:</p>
- <RT-math>
- destination = f(way)
- </RT-math>
-
- <p>
- Because the same way always leads to the given destination,
- we can represent the mapping as follows:
- </p>
- <RT-code>
- def resolve_path(way):
- return hypergraph.lookup(way)
- </RT-code>
-
- <script src="style/style_orchestrator.js"></script>
- <script>
- window.StyleRT.style_orchestrator();
- </script>
-
-</body>
-</html>
--- /dev/null
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8">
+ <title>Epimetheus: The Only Primitive</title>
+ <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+JP&display=swap" rel="stylesheet">
+
+ <script src="style/body_visibility_hidden.js"></script>
+ <script>
+ window.StyleRT.body_visibility_hidden();
+ </script>
+ </head>
+ <body>
+ <RT-article>
+ <RT-title
+ author="Thomas Walker Lynch"
+ date="2026-01-14"
+ title="Epimetheus: The Only Primitive">
+ </RT-title>
+
+ <RT-TOC level="1"></RT-TOC>
+
+ <h1>Introduction</h1>
+
+ <p>
+ Epimetheus is a Python library for <RT-term>Higher Order Analysis</RT-term> and <RT-term>Semantic Annotation</RT-term>. A data scientist might say it is a mechanism for <RT-term>Late Binding</RT-term> of ontology, while a programmer will call it a <RT-term>type system</RT-term>.
+ </p>
+
+ <p>
+ Unlike Prometheus (Forethought), who defines what an object <em>is</em> before it is born (classic class instantiation), Epimetheus allows you to attach meaning, identity, and semantic types to objects <em>after</em> they exist.
+ </p>
+
+ <p>
+ In standard programming, the <RT-term>primitives</RT-term> are things like
+ <RT-code>int</RT-code>, <RT-code>float</RT-code>, <RT-code>char</RT-code>, or <RT-code>boolean</RT-code>. These carry inherent meaning and behavior before you ever use them. An integer <em>is</em> a number; it must add and subtract.
+ </p>
+
+ <p>
+ Epimetheus (Afterthought) rejects this. It allows you to attach meaning (semantics) to objects after they are born. You can decide later that an object behaves like a number, or a string, or a user.
+ </p>
+
+ <p>
+ If you strip away all pre-defined types and behaviors (no ints, no strings, no classes), what is left? What is the one thing you absolutely <em>cannot</em> add later?
+ </p>
+
+ <p>
+ <RT-neologism>Distinctness</RT-neologism>.
+ </p>
+
+ <p>
+ You cannot attach meaning to an object if you cannot point to it. You cannot say "This object is a Number" if you cannot distinguish "This object" from "That object."
+ </p>
+
+ <p>
+ Thus the <RT-term>Symbol</RT-term> (the unique, persistent identity) is the most primitive data entity. Given <RT-term>Symbol</RT-term>s, and a <RT-term>Turing Machine</RT-term> for building structure, everything else follows. But this is not an article about constructing mathematics or computer science, rather it is about a <RT-term>type system</RT-term>, so lets not get too carried away with the grand strokes of the pen.
+ </p>
+
+ <h1>Assumptions and Terms</h1>
+
+ <h2>Given</h2>
+
+ <p>
+ As is apparent while you read this, English prose is a given. The goal in making use of prose is to explain that the code is internally consistent without the English description. Once the formal relations are established, the prose is no longer needed, as the logic permits no dependence on the medium used for its introduction. In other words, code does not read the comments to decide what to do.
+ </p>
+
+
+ <p>
+ The code related to this discussion is implemented in Python; however, issues with other languages are considered. One salient difference involves the fact that Python integers are bignums and are passed by reference. In some other languages, integers are considered <RT-term>primitives</RT-term>, are bounded in magnitude, and are bit-copied.
+ </p>
+
+ <h2>Symbol</h2>
+
+ <h3>Instance</h3>
+
+ <p>
+ We are given a <RT-term>symbol instance</RT-term> factory. Each time the <RT-code>make</RT-code> function on the factory interface is called, the factory returns an instance of a distinct <RT-term>symbol</RT-term>.
+ </p>
+
+ <p>
+ In some languages <RT-term>symbol</RT-term>s are implemented over primitive integers, and a <RT-term>symbol instance</RT-term> will be an integer. Thus <RT-term>symbol instance</RT-term>s can be copied. A common method for making a copy is to use assignment, e.g., <RT-code>x = y</RT-code>, where <RT-code>y</RT-code> is a variable holding a <RT-term>symbol instance</RT-term>. After execution of the assignment, <RT-code>x</RT-code> will hold another instance of the same <RT-term>symbol</RT-term>.
+ </p>
+
+ <p>
+ In the Python version of Epimetheus <RT-term>symbol</RT-term>s are indeed implemented over integers. However, Python integers are non-primitive and thus are passed by reference. The Python Epimetheus <RT-term>symbol instance</RT-term> factory will return a reference to an integer, not the base integer, as the <RT-term>symbol instance</RT-term>. Assignment will then copy the reference. Thus this reference is the <RT-term>symbol instance</RT-term> rather than the integer the <RT-term>symbol</RT-term> is based on.
+ </p>
+
+ <p>
+ In Epimetheus, we use a dictionary to give a <RT-term>symbol</RT-term> a name. The names need not meet the requirements imposed on a <RT-term>symbol instance</RT-term>, but it can be confusing when they don't. This is avoided in other <RT-term>symbol</RT-term> systems by implementing <RT-term>symbol</RT-term>s over character strings, and using the character string as both the name and the instance.
+ </p>
+
+ <h2>Required Properties</h2>
+
+ <p>
+ Any two, or by transitivity, any number of, <RT-term>symbol instance</RT-term>s can be compared for equality, say <RT-code>x == y</RT-code>. A comparison between <RT-term>symbol instance</RT-term>s will always return <RT-code>True</RT-code> or <RT-code>False</RT-code>.
+ </p>
+
+ <p>
+ A <RT-term>symbol instance</RT-term> newly minted using the given <RT-term>symbol</RT-term> factory <RT-code>make</RT-code> function is said to <RT-neologism>come direct from the factory</RT-neologism>. A <RT-term>symbol instance</RT-term> direct from the factory is also called an <RT-neologism>original symbol</RT-neologism>.
+ </p>
+
+ <p>
+ Equality over <RT-term>symbol instance</RT-term>s is an equivalence relation: <RT-code>x == x</RT-code> is True; <RT-code>x == y</RT-code> implies <RT-code>y == x</RT-code>; and if <RT-code>x == y</RT-code> and <RT-code>y == z</RT-code> then <RT-code>x == z</RT-code>.
+ </p>
+
+ <p>
+ Any two <RT-term>symbol instance</RT-term>s returned directly from the factory using two different <RT-code>make</RT-code> calls will always equality compare to be <RT-code>False</RT-code>. In other words, two distinct <RT-neologism>original</RT-neologism>s will always be not equal.
+ </p>
+
+ <p>
+ Given an <RT-neologism>original</RT-neologism>, all copies <RT-neologism>stemming from</RT-neologism> it will be equal to each other and to the <RT-neologism>original</RT-neologism>. By <RT-neologism-em>stemming from</RT-neologism-em> we mean to include all direct copies and copies of copies.
+ </p>
+
+ <p>
+ Given any two <RT-neologism>original</RT-neologism>s, say <var>A</var> and <var>B</var>, we know that <var>A</var> is not equal to <var>B</var>, as discussed above. Note also that <var>A</var> is not equal to any copy <RT-neologism>stemming from</RT-neologism> <var>B</var>, and <var>B</var> is not equal to any copy <RT-neologism>stemming from</RT-neologism> <var>A</var>.
+ </p>
+
+ <p>
+ Though <RT-term>symbol instance</RT-term>s are integer-like in that copy and equality compare can be used with them, <RT-term>symbol instance</RT-term>s are disallowed from being used with other integer operators. <RT-term>Symbol</RT-term>s cannot be compared for greater-than or less-than; they cannot be incremented, added, nor subtracted, etc.
+ </p>
+
+
+ <h2>What <em>is</em> a Symbol?</h2>
+
+ <p>
+ Only <RT-term>symbol instance</RT-term>s exist at runtime, so a <RT-term>symbol</RT-term> is never manipulated directly.
+ </p>
+
+ <p>
+ Define a relation <var>~</var> over instances by <RT-code>x ~ y</RT-code> iff <RT-code>x == y</RT-code>. Since <RT-code>==</RT-code> is an equivalence relation, this partitions instances into equivalence classes. Each such equivalence class is a <RT-term>symbol</RT-term>.
+ </p>
+
+ <p>
+ The factory’s <RT-code>make</RT-code> returns an <RT-neologism>original</RT-neologism> instance that is not equal to any other <RT-neologism>original</RT-neologism>. All copies <RT-neologism>stemming from</RT-neologism> an <RT-neologism>original</RT-neologism> remain in the same equivalence class. Therefore any instance in the class can represent the <RT-term>symbol</RT-term>, and we may choose any one instance as the <RT-term>symbol</RT-term>’s name (a canonical representative), or we could use a dictionary, and use, say, the <RT-neologism>original</RT-neologism> instance, to lookup a string as a name, among other possibilities.
+ </p>
+
+ <h3>Distinctness Across Contexts</h3>
+ <p>
+ If a <RT-term>symbol</RT-term> persists across contexts (such as across scopes or processes), it must remain distinct from all other <RT-term>symbol</RT-term>s as it enters those new environments.
+ </p>
+
+ <p>
+ In this implementation, we meet this constraint by utilizing a global <RT-term>symbol instance</RT-term> factory and by explicitly disallowing a <RT-term>symbol</RT-term> from being employed outside the process of its creation. As a means of enforcement, there are no permitted methods to serialize a <RT-term>symbol</RT-term> to a string, nor to output one to a console or stream.
+ </p>
+
+ <p>
+ These constraints do not apply to <RT-term>symbol</RT-term> names, which are text strings. However, a <RT-term>symbol</RT-term> cannot be recovered from its name; the name is a label, not a reconstruction key.
+ </p>
+
+ <h2>Object</h2>
+ <p>
+ The term "Python object" refers to anything that can or could appear in legal Python code and could be associated with a <RT-term>symbol</RT-term>. This includes <RT-term>symbol</RT-term>s themselves.
+ </p>
+
+ <p>
+ A <RT-term>symbol</RT-term> is associated with an object using a Python dictionary. The <RT-term>symbol</RT-term> is the key, and the object is that thing which is "looked up" via said key.
+ One such example is the <RT-term>symbol</RT-term> name dictionary mentioned in the prior section.
+ </p>
+
+ <h2>Tape</h2>
+
+ <p>
+ In the TTCA, we gave a formal definition for a <RT-term>tape</RT-term>. A <RT-term>tape</RT-term> is an ordered sequence of cells with a leftmost cell, zero or more interior cells, and a rightmost cell. If the <RT-term>tape</RT-term> is infinite, then there is no rightmost cell. The original <RT-term>Turing Machine</RT-term> <RT-term>tape</RT-term> is a <RT-term>symbol tape</RT-term> due to each cell of the <RT-term>tape</RT-term> holding exactly one <RT-term>symbol</RT-term>. The TTCA <RT-term>tape</RT-term> generalizes this by permitting a cell to hold any object.
+ </p>
+
+ <p>
+ Two <RT-term-em>tapes</RT-term-em>, say <RT-math>A</RT-math> and <RT-math>B</RT-math>, are equal if and only if they are the same length and all their cells have equal contents.
+ </p>
+ <RT-math>
+ A = B \iff \forall i \in \text{indices}, A[i] = B[i]
+ </RT-math>
+
+ <p>
+ If a <RT-term>tape</RT-term> is treated as nothing more than its cells, then deleting the last cell causes the <RT-term>tape</RT-term> to no longer exist. In a system that has a higher level structure that preserves the <RT-term>tape</RT-term> as a distinct entity, deleting the last cell produces an empty <RT-term>tape</RT-term> entity that is said to have zero cells.
+ </p>
+
+ <blockquote>
+ Consider a web browser. When the last tab is closed, the window disappears, forcing the user to create a new window to continue. Some users don't like this behavior, and would prefer that the window to remain as an empty canvas. Then a mistaken close could be undone by selecting 'reopen closed tab', without having to relaunch the browser and resettle the new window into the workspace.
+ </blockquote>
+
+
+ <p>
+ The <RT-term>tape</RT-term> abstraction is particularly expressive in the Python context, as the language utilizes object references and permits lists to hold objects of any type. Once data within a container is modeled as a <RT-term>tape</RT-term>, structures such as lists, arrays, token streams, argument lists, and sequences all share the same abstract model.
+ </p>
+
+
+ <h2>Path</h2>
+
+ <p> The term <RT-term>path</RT-term> is an ontological alias for <RT-term-em>tape</RT-term-em>. Adopting the term <RT-term-em>path</RT-term-em> brings with it a specialized vocabulary and a semantic framework for discussing traversal. The structure is unchanged, but the interpretation changes, as a tape becomes something to follow. </p>
+
+ <p>
+ The leftmost cell in a <RT-term>path</RT-term> is called the <RT-term>destination</RT-term>.
+ All cells of the <RT-term>path</RT-term> to the right of the <RT-term>destination</RT-term>
+ cell are called the <RT-term>way</RT-term>. If the <RT-term>path</RT-term> has two or more
+ cells, dropping the leftmost cell leaves a <RT-term>tape</RT-term> holding exactly the
+ <RT-term>way</RT-term>. Hence a <RT-term>path</RT-term> can be viewed as a pair,
+ (<RT-term>destination</RT-term> ,<RT-term>way</RT-term>), where the destination is a single
+ cell and the way is a tape (possibly empty).
+ </p>
+
+ <p>
+ The reader might have expected the <RT-term>path</RT-term> to go from left to right, with the <RT-term>destination</RT-term> being in the rightmost cell. This would be natural because we read characters from a written page going from left to right. However, such a definition would run into a problem for us, as we will need for paths to always have a destination, and <RT-term>tape</RT-term>s can be open on the right, so they do not always have a rightmost cell.
+ </p>
+
+ <blockquote>
+ Think about it this way: you are sitting in a pub of an inn, and a stranger walks in. Though you know the stranger's current <RT-term>destination</RT-term>, you might not know where he came from.
+ </blockquote>
+
+ <h3>Discrete Function</h3>
+ <p>
+ Now consider a <RT-term>tape</RT-term>, say called <var>F</var>, where each cell in F holds a <RT-term>path</RT-term>. As a <RT-term>path</RT-term> is a <RT-term>tape</RT-term>, the structure of <var>F</var> is that of a <RT-term>tape</RT-term> of <RT-term>tape</RT-term>s.
+ </p>
+
+ <p>
+ Now suppose we traverse <var>F</var> while examining the <RT-term>path</RT-term>s as (<RT-term>destination</RT-term> ,<RT-term>way</RT-term>) pairs. If we find that all equal <RT-term>way</RT-term>s lead to
+ the same <RT-term>destination</RT-term>, then <RT-term>tape</RT-term> <var>F</var> is a <RT-term>discrete function</RT-term>. We say it is <em>discrete</em> because <var>F</var> is a <RT-term>tape</RT-term> with distinct cells. We say it is a function due to having the property that all <RT-term>path</RT-term>s with equal <RT-term>way</RT-term>s lead to the same <RT-term>destination</RT-term>.
+ </p>
+
+ <p>
+ Thus a function is more restricted than a <RT-term>tape</RT-term> of paths, and due to this restriction it is possible to adopt the following notation, where a <RT-term>destination</RT-term> is said to be determined by, a function of, the <RT-term>way</RT-term>:
+ </p>
+
+ <RT-math>
+ destination = f(way)
+ </RT-math>
+
+ <p>
+ That the same <RT-term>way</RT-term> always leads to the same destination fits our common experience. If we ever followed the same way twice and landed in a different destination we would think ourselves to be in a Sci-Fi movie. It is also intuitive to us that the function restrictions do not exclude the possibility that multiple <RT-term>way</RT-term>s can lead to the same destination. Because we often compute things that are related to our daily experience it is not surprising that this is a very common pattern. And this is not a coincidence, this is the reason functions are defined as they are.
+ </p>
+
+ <script src="style/style_orchestrator.js"></script>
+ <script>
+ window.StyleRT.style_orchestrator();
+ </script>
+ </RT-article>
+ </body>
+</html>
--- /dev/null
+/*
+ Processes <RT-TOC> tags.
+ Populates each with headings found below it.
+
+ Attributes:
+ level="N" : Explicitly sets the target heading level (1-6).
+ e.g., level="1" collects H1s. level="2" collects H2s.
+ Stops collecting if it hits a heading of (level - 1) or higher.
+
+ Default (No attribute):
+ Context-Aware. Looks backwards for the nearest heading H(N).
+ Targets H(N+1). Stops at the next H(N).
+*/
+window.StyleRT = window.StyleRT || {};
+
+window.StyleRT.RT_TOC = function() {
+ const debug = window.StyleRT.debug || { log: function(){} };
+ const toc_tags = document.querySelectorAll('rt-toc');
+
+ toc_tags.forEach((container, toc_index) => {
+ container.style.display = 'block';
+
+ // 1. Determine Target Level
+ const attr_level = parseInt(container.getAttribute('level'));
+ let target_level;
+
+ if (!isNaN(attr_level)) {
+ // EXPLICIT MODE
+ target_level = attr_level;
+ if (debug.log) debug.log('RT_TOC', `TOC #${toc_index} explicit target: H${target_level}`);
+ } else {
+ // IMPLICIT / CONTEXT MODE
+ let context_level = 0; // Default 0 (Root)
+ let prev = container.previousElementSibling;
+ while (prev) {
+ const match = prev.tagName.match(/^H([1-6])$/);
+ if (match) {
+ context_level = parseInt(match[1]);
+ break;
+ }
+ prev = prev.previousElementSibling;
+ }
+ target_level = context_level + 1;
+ if (debug.log) debug.log('RT_TOC', `TOC #${toc_index} context implied target: H${target_level}`);
+ }
+
+ // Stop condition: Stop if we hit a heading that is a "parent" or "sibling" of the context.
+ // Mathematically: Stop if found_level < target_level.
+ const stop_threshold = target_level;
+
+ // 2. Setup Container
+ container.innerHTML = '';
+ const title = document.createElement('h1');
+ // Title logic: If targeting H1, it's a Main TOC. Otherwise it's a Section TOC.
+ title.textContent = target_level === 1 ? 'Table of Contents' : 'Section Contents';
+ title.style.textAlign = 'center';
+ container.appendChild(title);
+
+ const list = document.createElement('ul');
+ list.style.listStyle = 'none';
+ list.style.paddingLeft = '0';
+ container.appendChild(list);
+
+ // 3. Scan Forward
+ let next_el = container.nextElementSibling;
+ while (next_el) {
+ const match = next_el.tagName.match(/^H([1-6])$/);
+ if (match) {
+ const found_level = parseInt(match[1]);
+
+ // STOP Logic:
+ // If we are looking for H2s, we stop if we hit an H1 (level 1).
+ // If we are looking for H1s, we stop if we hit... nothing (level 0).
+ if (found_level < target_level) {
+ break;
+ }
+
+ // COLLECT Logic:
+ if (found_level === target_level) {
+ if (!next_el.id) next_el.id = `toc-ref-${toc_index}-${found_level}-${list.children.length}`;
+
+ const li = document.createElement('li');
+ li.style.marginBottom = '0.5rem';
+
+ const a = document.createElement('a');
+ a.href = `#${next_el.id}`;
+ a.textContent = next_el.textContent;
+ a.style.textDecoration = 'none';
+ a.style.color = 'inherit';
+ a.style.display = 'block';
+
+ a.onmouseover = () => a.style.color = 'var(--rt-brand-primary)';
+ a.onmouseout = () => a.style.color = 'inherit';
+
+ li.appendChild(a);
+ list.appendChild(li);
+ }
+ }
+ next_el = next_el.nextElementSibling;
+ }
+ });
+};
--- /dev/null
+/*
+ Processes <RT-CODE> tags.
+ Uses the central config or CSS variables from the theme.
+*/
+function RT_code() {
+ const RT = window.StyleRT;
+ const U = RT.utility;
+ const debug = RT.debug;
+
+ debug.log('RT_code', 'Starting render cycle.');
+
+ const metrics = U.measure_ink_ratio('monospace');
+
+ // Scoped Selector: find code blocks anywhere, but styling relies on inheritance
+ document.querySelectorAll('rt-code').forEach((el) => {
+ el.style.fontFamily = 'monospace';
+
+ // Check context for accent color (CSS Variable fallback)
+ const computed = window.getComputedStyle(el);
+ const accent = computed.getPropertyValue('--rt-accent').trim() || 'gold';
+
+ const is_block = U.is_block_content(el);
+ const parentColor = computed.color;
+ const is_text_light = U.is_color_light(parentColor);
+
+ const alpha = is_block ? 0.08 : 0.15;
+ const overlay = is_text_light ? `rgba(255,255,255,${alpha})` : `rgba(0,0,0,${alpha})`;
+ const text_color = is_text_light ? '#ffffff' : '#000000';
+
+ el.style.backgroundColor = overlay;
+
+ if (is_block) {
+ el.style.display = 'block';
+ el.style.whiteSpace = 'pre';
+ el.style.fontSize = (parseFloat(computed.fontSize) * metrics.ratio * 0.95) + 'px';
+ el.style.padding = '1.2rem';
+ el.style.margin = '1.5rem 0';
+ el.style.borderLeft = `4px solid ${accent}`;
+ el.style.color = 'inherit';
+ } else {
+ el.style.display = 'inline';
+ const exactPx = parseFloat(computed.fontSize) * metrics.ratio * 1.0;
+ el.style.fontSize = exactPx + 'px';
+ el.style.padding = '0.1rem 0.35rem';
+ el.style.borderRadius = '3px';
+ // Vertical align fix for inline code
+ const offsetPx = metrics.baseline_diff * (exactPx / 100);
+ el.style.verticalAlign = offsetPx + 'px';
+ el.style.color = text_color;
+ }
+ });
+
+ debug.log('RT_code', 'Render cycle complete.');
+}
+
+window.StyleRT = window.StyleRT || {};
+window.StyleRT.RT_code = RT_code;
--- /dev/null
+/*
+ Processes <RT-MATH> tags.
+ JavaScript: RT_math()
+ HTML Tag: <RT-MATH> (parsed as rt-math)
+*/
+function RT_math(){
+ // querySelector treats 'rt-math' as case-insensitive for the tag
+ document.querySelectorAll('rt-math').forEach(el => {
+ if (el.textContent.startsWith('$')) return;
+
+ const is_block = el.parentElement.tagName === 'DIV' ||
+ el.textContent.includes('\n') ||
+ el.parentElement.childNodes.length === 1;
+
+ const delimiter = is_block ? '$$' : '$';
+ el.style.display = is_block ? 'block' : 'inline';
+ el.textContent = `${delimiter}${el.textContent.trim()}${delimiter}`;
+ });
+
+ // MathJax must find its config at window.MathJax
+ window.MathJax = {
+ tex: {
+ inlineMath: [['$', '$']],
+ displayMath: [['$$', '$$']]
+ }
+ };
+
+ const script = document.createElement('script');
+ script.src = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js';
+ script.async = true;
+ document.head.appendChild(script);
+}
+
+window.StyleRT = window.StyleRT || {};
+window.StyleRT.RT_math = RT_math;
--- /dev/null
+/*
+ Processes <RT-TERM> and <RT-NEOLOGISM> tags.
+ - Styles only the first occurrence of a unique term/neologism.
+ - The "-em" variants (e.g., <RT-term-em>) are always styled.
+ - Automatically generates IDs for first occurrences for future indexing.
+*/
+
+window.StyleRT = window.StyleRT || {};
+
+window.StyleRT.RT_term = function() {
+ const RT = window.StyleRT;
+
+ const debug = RT.debug || {
+ log: function() {}
+ ,warn: function() {}
+ ,error: function() {}
+ };
+
+ const DEBUG_TOKEN_S = 'term';
+
+ try {
+ // Track seen terms so only the first occurrence is decorated
+ const seen_terms_dpa = new Set();
+
+ const apply_style = (el, is_neologism_b) => {
+ el.style.fontStyle = 'italic';
+ el.style.fontWeight = is_neologism_b ? '600' : '500';
+ el.style.color = is_neologism_b
+ ? 'var(--rt-brand-secondary)'
+ : 'var(--rt-brand-primary)';
+ el.style.paddingRight = '0.1em'; // Compensation for italic slant
+ el.style.display = 'inline';
+ };
+
+ const clear_style = (el) => {
+ el.style.fontStyle = 'normal';
+ el.style.color = 'inherit';
+ el.style.fontWeight = 'inherit';
+ el.style.paddingRight = '';
+ el.style.display = '';
+ };
+
+ const selector_s = [
+ 'rt-term'
+ ,'rt-term-em'
+ ,'rt-neologism'
+ ,'rt-neologism-em'
+ ].join(',');
+
+ const tags_dpa = document.querySelectorAll(selector_s);
+
+ debug.log(DEBUG_TOKEN_S, `Scanning ${tags_dpa.length} term tags`);
+
+ tags_dpa.forEach(el => {
+ const tag_name_s = el.tagName.toLowerCase();
+ const is_neologism_b = tag_name_s.includes('neologism');
+ const is_explicit_em_b = tag_name_s.endsWith('-em');
+
+ const term_text_raw_s = (el.textContent || '').trim();
+ if (!term_text_raw_s.length) {
+ debug.warn(DEBUG_TOKEN_S, `Empty term tag encountered: <${tag_name_s}>`);
+ return;
+ }
+
+ // Normalize text for uniqueness tracking
+ const term_norm_s = term_text_raw_s.toLowerCase();
+
+ // Slug for ID generation (simple + stable)
+ const slug_s = term_norm_s.replace(/\s+/g, '-');
+
+ const is_first_occurrence_b = !seen_terms_dpa.has(term_norm_s);
+
+ if (is_explicit_em_b || is_first_occurrence_b) {
+ apply_style(el, is_neologism_b);
+
+ if (!is_explicit_em_b && is_first_occurrence_b) {
+ seen_terms_dpa.add(term_norm_s);
+
+ if (!el.id) {
+ el.id = `def-${is_neologism_b ? 'neo-' : ''}${slug_s}`;
+ debug.log(
+ DEBUG_TOKEN_S
+ ,`First occurrence: "${term_norm_s}" -> id="${el.id}"`
+ );
+ } else {
+ debug.log(
+ DEBUG_TOKEN_S
+ ,`First occurrence: "${term_norm_s}" (existing id="${el.id}")`
+ );
+ }
+ } else if (is_explicit_em_b) {
+ debug.log(
+ DEBUG_TOKEN_S
+ ,`Emphasized occurrence: "${term_norm_s}" (<${tag_name_s}>)`
+ );
+ }
+ } else {
+ // Subsequent mentions render as normal prose
+ clear_style(el);
+ }
+ });
+
+ debug.log(DEBUG_TOKEN_S, `Unique terms defined: ${seen_terms_dpa.size}`);
+ } catch (e) {
+ debug.error('error', `RT_term failed: ${e && e.message ? e.message : String(e)}`);
+ }
+};
--- /dev/null
+/*
+ Processes <RT-TITLE> tags.
+ Generates a standard document header block.
+
+ Usage:
+ <RT-title title="..." author="..." date="..."></RT-title>
+*/
+window.StyleRT = window.StyleRT || {};
+
+window.StyleRT.RT_title = function() {
+ const debug = window.StyleRT.debug || { log: function(){} };
+
+ document.querySelectorAll('rt-title').forEach(el => {
+ const title = el.getAttribute('title') || 'Untitled Document';
+ const author = el.getAttribute('author');
+ const date = el.getAttribute('date');
+
+ if (debug.log) debug.log('RT_title', `Generating title block: ${title}`);
+
+ // Container
+ const container = document.createElement('div');
+ container.style.textAlign = 'center';
+ container.style.marginBottom = '3rem';
+ container.style.marginTop = '2rem';
+ container.style.borderBottom = '1px solid var(--rt-border-default)';
+ container.style.paddingBottom = '1.5rem';
+
+ // Main Title (H1)
+ const h1 = document.createElement('h1');
+ h1.textContent = title;
+ h1.style.margin = '0 0 0.8rem 0';
+ h1.style.border = 'none'; // Override standard H1 border
+ h1.style.padding = '0';
+ h1.style.color = 'var(--rt-brand-primary)';
+ h1.style.fontSize = '2.5em';
+ h1.style.lineHeight = '1.1';
+ h1.style.letterSpacing = '-0.03em';
+
+ container.appendChild(h1);
+
+ // Metadata Row (Author | Date)
+ if (author || date) {
+ const meta = document.createElement('div');
+ meta.style.color = 'var(--rt-content-muted)';
+ meta.style.fontStyle = 'italic';
+ meta.style.fontSize = '1.1em';
+ meta.style.fontFamily = '"Georgia", "Times New Roman", serif'; // Classy serif
+
+ const parts = [];
+ if (author) parts.push(`<span style="font-weight:600; color:var(--rt-brand-secondary)">${author}</span>`);
+ if (date) parts.push(date);
+
+ meta.innerHTML = parts.join(' — ');
+ container.appendChild(meta);
+ }
+
+ // Replace the raw tag with the generated block
+ el.replaceWith(container);
+ });
+};
--- /dev/null
+/* Style: The "State Department" Override
+ Description: Restores decorum.
+*/
+(function(){
+ const RT = window.StyleRT || {};
+
+ // Force the font regardless of other settings
+ RT.rubio = function() {
+ const articles = document.querySelectorAll("rt-article");
+ articles.forEach(el => {
+ el.style.fontFamily = '"Times New Roman", "Times", serif';
+ el.style.letterSpacing = "0px"; // No modern spacing allowed
+ });
+ };
+})();
--- /dev/null
+/*
+ Article Layout: Technical Reference
+ Standard: Theme 1.0
+ Description: High-readability layout for technical documentation on screens.
+ Features: Sans-serif, justified text, distinct headers, boxed code.
+*/
+(function(){
+ const RT = window.StyleRT = window.StyleRT || {};
+
+ RT.article = function() {
+ const debug = RT.debug || { log: function(){} };
+ debug.log('layout', 'RT.article starting...');
+
+ RT.config = RT.config || {};
+
+ // Default Configuration
+ RT.config.article = {
+ font_family: '"Noto Sans", "Segoe UI", "Helvetica Neue", sans-serif'
+ ,line_height: "1.8"
+ ,font_size: "16px"
+ ,font_weight: "400" // Default (String)
+ ,max_width: "820px"
+ ,margin: "0 auto"
+ };
+
+ // SAFE THEME DETECTION
+ // If the theme is loaded and explicitly Light, bump the weight.
+ try {
+ if (RT.config.theme && RT.config.theme.meta_is_dark === false) {
+ RT.config.article.font_weight = "600";
+ debug.log('layout', 'Light theme detected: adjusting font weight to 600.');
+ }
+ } catch(e) {
+ console.warn("StyleRT: Auto-weight adjustment failed, using default.", e);
+ }
+
+ const conf = RT.config.article;
+ const article_seq = document.querySelectorAll("RT-article");
+
+ if(article_seq.length === 0) {
+ debug.log('layout', 'No <RT-article> elements found. Exiting.');
+ return;
+ }
+
+ // 1. Apply Container Styles
+ article_seq.forEach( (article) =>{
+ const style = article.style;
+ style.display = "block";
+ style.fontFamily = conf.font_family;
+ style.fontSize = conf.font_size;
+ style.lineHeight = conf.line_height;
+ style.fontWeight = conf.font_weight;
+ style.maxWidth = conf.max_width;
+ style.margin = conf.margin;
+ style.padding = "0 20px";
+ style.color = "var(--rt-content-main)";
+ });
+
+ // 2. Inject Child Typography
+ const style_id = 'rt-article-typography';
+ if (!document.getElementById(style_id)) {
+ debug.log('layout', 'Injecting CSS typography rules.');
+ const style_el = document.createElement('style');
+ style_el.id = style_id;
+
+ style_el.textContent = `
+ /* --- HEADERS --- */
+ rt-article h1 {
+ color: var(--rt-brand-primary);
+ font-size: 2.0em;
+ font-weight: 500;
+ text-align: center;
+ margin-top: 1.2em;
+ margin-bottom: 0.6em;
+ border-bottom: 2px solid var(--rt-border-default);
+ padding-bottom: 0.3em;
+ line-height: 1.2;
+ letter-spacing: -0.02em;
+ }
+
+ rt-article h2 {
+ color: var(--rt-brand-secondary);
+ font-size: 1.5em;
+ font-weight: 400;
+ text-align: center;
+ margin-top: 1.0em;
+ margin-bottom: 0.5em;
+ }
+
+ rt-article h2 + h3 {
+ margin-top: -0.3em;
+ padding-top: 0;
+ }
+
+ rt-article h3 {
+ color: var(--rt-brand-tertiary);
+ font-size: 1.4em;
+ font-weight: 400;
+ margin-top: 1.0em;
+ margin-bottom: 0.5em;
+ }
+
+ /* --- DEEP LEVELS (H4-H6) --- */
+ rt-article h4, rt-article h5, rt-article h6 {
+ color: var(--rt-brand-tertiary);
+ font-weight: bold;
+ margin-top: 1.2em;
+ font-style: italic;
+ }
+ rt-article h4 { margin-left: 2em; }
+ rt-article h5 { margin-left: 4em; }
+ rt-article h6 { margin-left: 6em; }
+
+ /* --- BODY TEXT --- */
+ rt-article p {
+ margin-bottom: 1.4em;
+ text-align: justify;
+ hyphens: auto;
+ color: var(--rt-content-main);
+ }
+
+ /* --- RICH ELEMENTS --- */
+ rt-article blockquote {
+ border-left: 4px solid var(--rt-brand-secondary);
+ margin: 1.5em 0;
+ padding: 0.5em 1em;
+ font-style: italic;
+ color: var(--rt-content-muted);
+ background: var(--rt-surface-1);
+ border-radius: 0 4px 4px 0;
+ }
+
+ rt-article ul, rt-article ol {
+ margin-bottom: 1.4em;
+ padding-left: 2em;
+ }
+ rt-article li {
+ margin-bottom: 0.4em;
+ }
+ rt-article li::marker {
+ color: var(--rt-brand-secondary);
+ font-weight: bold;
+ }
+
+ /* Links */
+ rt-article a {
+ color: var(--rt-brand-link);
+ text-decoration: none;
+ border-bottom: 1px dotted var(--rt-border-default);
+ transition: all 0.2s;
+ }
+ rt-article a:hover {
+ color: var(--rt-brand-primary);
+ border-bottom: 1px solid var(--rt-brand-primary);
+ background: var(--rt-surface-1);
+ }
+
+ /* --- TECHNICAL --- */
+ rt-article pre {
+ background: var(--rt-surface-code);
+ padding: 1em;
+ border-radius: 4px;
+ overflow-x: auto;
+ border: 1px solid var(--rt-border-default);
+ }
+ `;
+ document.head.appendChild(style_el);
+ }
+ };
+})();
--- /dev/null
+/*
+ Targets the root element to ensure total blackout during load.
+*/
+function body_visibility_hidden(){
+ const gate = document.createElement('style');
+ gate.id = 'rt-visibility-gate';
+ gate.textContent = 'html{visibility:hidden !important; background:black !important;}';
+ document.head.appendChild(gate);
+}
+
+window.StyleRT = window.StyleRT || {};
+window.StyleRT.body_visibility_hidden = body_visibility_hidden;
--- /dev/null
+/*
+ Restores visibility by removing the visibility gate.
+*/
+function body_visibility_visible(){
+ const gate = document.getElementById('rt-visibility-gate');
+ if (gate){
+ gate.remove();
+ }
+ document.body.style.visibility = 'visible';
+}
+
+window.StyleRT = window.StyleRT || {};
+window.StyleRT.body_visibility_visible = body_visibility_visible;
--- /dev/null
+ <RT-article>: The root container.
+ <RT-page>: The page wrapper.
+
+<RT-math>
+<RT-code>
+
+ <RT-term>: For Conventional terms (standard definitions)
+<RT-neologism>: Terms introduced in this article
--- /dev/null
+/*
+ Page Layout: Fixed Glow
+ Standard: Theme 1.0
+ Description: A fixed-height container with a glowing border effect that matches the active theme.
+*/
+(function(){
+ const RT = window.StyleRT = window.StyleRT || {};
+
+ // Function name stays generic so the orchestrator can call RT.page() regardless of file choice
+ RT.page = function() {
+ RT.config = RT.config || {};
+
+ // Default Configuration
+ // We use CSS Variables here so the Theme controls the actual colors.
+ const defaults = {
+ width: "100%"
+ ,height: "1056px"
+ ,padding: "3rem"
+ ,margin: "4rem auto"
+
+ // Dynamic Theme Bindings
+ ,bg_color: "var(--rt-surface-0)" // Black (Dark) or Cream (Light)
+ ,border_color: "var(--rt-brand-primary)" // The Main Accent Color
+ ,text_color: "var(--rt-brand-primary)" // Page Number Color
+
+ // The Glow: Uses the primary brand color for the shadow
+ ,shadow: "drop-shadow(0px 0px 15px var(--rt-brand-primary))"
+ };
+
+ // Merge defaults
+ RT.config.page = Object.assign({}, defaults, RT.config.page || {});
+
+ const conf = RT.config.page;
+ const style_id = 'rt-page-fixed-glow';
+
+ if (!document.getElementById(style_id)) {
+ const style_el = document.createElement('style');
+ style_el.id = style_id;
+
+ style_el.textContent = `
+ /* Reset page counter on the article container */
+ rt-article {
+ counter-reset: rt-page-counter;
+ }
+
+ rt-page {
+ display: block;
+ position: relative;
+ box-sizing: border-box;
+ overflow: hidden;
+
+ /* Dimensions */
+ width: ${conf.width};
+ height: ${conf.height};
+ margin: ${conf.margin};
+ padding: ${conf.padding};
+
+ /* Theming */
+ background-color: ${conf.bg_color};
+ border: 1px solid ${conf.border_color};
+
+ /* The "Glow" Effect */
+ filter: ${conf.shadow};
+
+ /* Counter Increment */
+ counter-increment: rt-page-counter;
+ }
+
+ /* Page Numbering */
+ rt-page::after {
+ content: "Page " counter(rt-page-counter);
+ position: absolute;
+ bottom: 1.5rem;
+ right: 3rem;
+
+ font-family: "Noto Sans", sans-serif;
+ font-size: 0.9rem;
+ font-weight: bold;
+
+ color: ${conf.text_color};
+ opacity: 0.8;
+ pointer-events: none; /* Prevent interference with clicks */
+ }
+ `;
+ document.head.appendChild(style_el);
+ }
+ };
+})();
--- /dev/null
+/*
+ Layout Paginator: paginate_by_element
+*/
+window.StyleRT = window.StyleRT || {};
+
+window.StyleRT.paginate_by_element = function() {
+ const RT = window.StyleRT;
+
+ // Fix: Read safely without overwriting the config namespace
+ const page_conf = (RT.config && RT.config.page) ? RT.config.page : {};
+ const page_height_limit = page_conf.height_limit || 1000;
+
+ const article_seq = document.querySelectorAll("RT-article");
+
+ // HURDLE: Error if no articles found to paginate
+ if(article_seq.length === 0) {
+ RT.debug.error('pagination', 'No <RT-article> elements found. Pagination aborted.');
+ return;
+ }
+
+ article_seq.forEach( (article) => {
+ const raw_elements = Array.from(article.children).filter(el =>
+ !['SCRIPT', 'STYLE', 'RT-PAGE'].includes(el.tagName)
+ );
+
+ if(raw_elements.length === 0) return;
+
+ const pages = [];
+ let current_batch = [];
+ let current_h = 0;
+
+ const get_el_height = (el) => {
+ const rect = el.getBoundingClientRect();
+ const style = window.getComputedStyle(el);
+ const margin = parseFloat(style.marginTop) + parseFloat(style.marginBottom);
+ return (rect.height || 0) + (margin || 0);
+ };
+
+ for (let i = 0; i < raw_elements.length; i++) {
+ const el = raw_elements[i];
+ const h = get_el_height(el);
+ const is_heading = /^H[1-6]/.test(el.tagName);
+
+ let total_required_h = h;
+ if (is_heading && i + 1 < raw_elements.length) {
+ total_required_h += get_el_height(raw_elements[i + 1]);
+ }
+
+ if (current_h + total_required_h > page_height_limit && current_batch.length > 0) {
+ pages.push(current_batch);
+ current_batch = [];
+ current_h = 0;
+ }
+
+ current_batch.push(el);
+ current_h += h;
+ }
+
+ if (current_batch.length > 0) pages.push(current_batch);
+
+ article.innerHTML = '';
+
+ pages.forEach( (list, index) => {
+ const page_el = document.createElement('rt-page');
+ page_el.id = `page-${index+1}`;
+ list.forEach(item => page_el.appendChild(item));
+ article.appendChild(page_el);
+ });
+
+ if (RT.debug) RT.debug.log('pagination', `Article paginated into ${pages.length} pages.`);
+ });
+};
--- /dev/null
+/*
+ Master Loader & Orchestrator for StyleRT.
+*/
+
+window.StyleRT = window.StyleRT || {};
+
+window.StyleRT.style_orchestrator = function() {
+ const RT = window.StyleRT;
+
+ const modules = [
+ // Theme & Semantics
+ 'style/RT_title.js',
+ 'style/theme_dark_gold.js',
+ 'style/RT_term.js',
+ 'style/RT_math.js',
+ 'style/RT_code.js',
+ 'style/article_tech_ref.js',
+ 'style/RT_TOC.js',
+
+ // Layout & Pagination
+ 'style/paginate_by_element.js',
+ 'style/page_fixed_glow.js',
+
+ // Visibility
+ 'style/body_visibility_visible.js'
+ ];
+
+ // 1. Bootloader
+ const utility = document.createElement('script');
+ utility.src = 'style/utility.js';
+
+ utility.onload = () => { load_next(0); };
+ utility.onerror = () => { console.error("StyleRT: Critical failure - utility.js missing."); };
+ document.head.appendChild(utility);
+
+ // 2. The Chain Loader
+ const load_next = (index) => {
+ if (index >= modules.length) {
+ run_style();
+ return;
+ }
+ const src = modules[index];
+ if (RT.debug) RT.debug.log('style', `Loading: ${src}`);
+
+ const script = document.createElement('script');
+ script.src = src;
+ script.onload = () => load_next(index + 1);
+ script.onerror = () => {
+ console.error(`StyleRT: Failed load on ${src}`);
+ load_next(index + 1);
+ };
+ document.head.appendChild(script);
+ };
+
+ // 3. Phase 1: Semantics
+ const run_style = () => {
+ RT.debug.log('style', 'Starting Phase 1: Setup & Semantics');
+
+ // Naming Convention: RT.<filename_without_js>
+ if(RT.theme) RT.theme();
+ if(RT.article) RT.article();
+
+ // NEW: Trigger the Title Generator
+ if(RT.RT_title) RT.RT_title();
+
+ if(RT.RT_term) RT.RT_term();
+ if(RT.RT_math) RT.RT_math();
+ if(RT.RT_code) RT.RT_code();
+
+ if (window.MathJax && MathJax.Hub && MathJax.Hub.Queue) {
+ RT.debug.log('style', 'MathJax detected. Queueing layout tasks...');
+ MathJax.Hub.Queue(["Typeset", MathJax.Hub], continue_style);
+ } else {
+ continue_style();
+ }
+ };
+
+ // 4. Phase 2: Layout
+ const continue_style = () => {
+ RT.debug.log('style', 'Starting Phase 2: Layout & Reveal');
+
+ // Debug: Dump the config to see what values we are using
+ if(RT.debug) RT.debug.log('config', JSON.stringify(RT.config || {}, null, 2));
+
+ if(RT.RT_TOC) RT.RT_TOC();
+ if(RT.paginate_by_element) RT.paginate_by_element();
+ if(RT.page) RT.page(); // Defined in page_css_pn.js
+ if(RT.body_visibility_visible) RT.body_visibility_visible();
+
+ RT.debug.log('style', 'Style execution complete.');
+ };
+};
--- /dev/null
+/*
+ Theme: Inverse Wheat (Dark)
+ Standard: Theme 1.0
+ Description: High contrast Amber on Deep Charcoal.
+*/
+( function(){
+ const RT = window.StyleRT = window.StyleRT || {};
+
+ RT.theme = function(){
+ RT.config = RT.config || {};
+
+ // THEME 1.0 DATA CONTRACT
+ RT.config.theme = {
+ meta_is_dark: true
+ ,meta_name: "Inverse Wheat"
+
+ // --- SURFACES (Depth & Container Hierarchy) ---
+ ,surface_0: "hsl(0, 0%, 5%)" // App Background (Deepest)
+ ,surface_1: "hsl(0, 0%, 10%)" // Sidebar / Nav / Panels
+ ,surface_2: "hsl(0, 0%, 14%)" // Cards / Floating Elements
+ ,surface_3: "hsl(0, 0%, 18%)" // Modals / Dropdowns / Popovers
+ ,surface_input: "hsl(0, 0%, 12%)" // Form Inputs
+ ,surface_code: "hsl(0, 0%, 11%)" // Code Block Background
+ ,surface_select: "hsl(45, 100%, 15%)" // Text Selection Highlight
+
+ // --- CONTENT (Text & Icons) ---
+ ,content_main: "hsl(50, 60%, 85%)" // Primary Reading Text
+ ,content_muted: "hsl(36, 15%, 60%)" // Metadata, subtitles
+ ,content_subtle: "hsl(36, 10%, 40%)" // Placeholders, disabled states
+ ,content_inverse: "hsl(0, 0%, 5%)" // Text on high-contrast buttons
+
+ // --- BRAND & ACTION (The "Wheat" Identity) ---
+ ,brand_primary: "hsl(45, 100%, 50%)" // Main Action / H1 / Focus Ring
+ ,brand_secondary: "hsl(38, 90%, 65%)" // Secondary Buttons / H2
+ ,brand_tertiary: "hsl(30, 60%, 70%)" // Accents / H3
+ ,brand_link: "hsl(48, 100%, 50%)" // Hyperlinks (High Visibility)
+
+ // --- BORDERS & DIVIDERS ---
+ ,border_faint: "hsl(36, 20%, 15%)" // Subtle separation
+ ,border_default: "hsl(36, 20%, 25%)" // Standard Card Borders
+ ,border_strong: "hsl(36, 20%, 40%)" // Active states / Inputs
+
+ // --- STATE & FEEDBACK (Earth Tones) ---
+ ,state_success: "hsl(100, 50%, 45%)" // Olive Green
+ ,state_warning: "hsl(35, 90%, 55%)" // Burnt Orange
+ ,state_error: "hsl(0, 60%, 55%)" // Brick Red
+ ,state_info: "hsl(200, 40%, 55%)" // Slate Blue
+
+ // --- SYNTAX HIGHLIGHTING (For Code) ---
+ ,syntax_keyword: "hsl(35, 100%, 65%)" // Orange
+ ,syntax_string: "hsl(75, 50%, 60%)" // Sage Green
+ ,syntax_func: "hsl(45, 90%, 70%)" // Light Gold
+ ,syntax_comment: "hsl(36, 15%, 45%)" // Brown/Gray
+ };
+
+ // --- APPLY THEME ---
+ const palette = RT.config.theme;
+ const body = document.body;
+ const html = document.documentElement;
+
+ // 1. Paint Base
+ html.style.backgroundColor = palette.surface_0;
+ body.style.backgroundColor = palette.surface_0;
+ body.style.color = palette.content_main;
+
+ // 2. Export Variables (Standardization)
+ const s = body.style;
+ for (const [key, value] of Object.entries(palette)) {
+ s.setProperty(`--rt-${key.replace(/_/g, '-')}`, value);
+ }
+
+ // 3. Global Overrides
+ const style_id = 'rt-global-overrides';
+ if (!document.getElementById(style_id)) {
+ const style = document.createElement('style');
+ style.id = style_id;
+ style.textContent = `
+ ::selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
+ ::-moz-selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
+
+ ::-webkit-scrollbar { width: 12px; }
+ ::-webkit-scrollbar-track { background: var(--rt-surface-0); }
+ ::-webkit-scrollbar-thumb {
+ background: var(--rt-border-default);
+ border: 2px solid var(--rt-surface-0);
+ border-radius: 8px;
+ }
+ ::-webkit-scrollbar-thumb:hover { background: var(--rt-brand-secondary); }
+ `;
+ document.head.appendChild(style);
+ }
+ };
+
+} )();
--- /dev/null
+/*
+ Theme: Classic Wheat (Light)
+ Standard: Theme 1.0
+ Description: Warm paper tones with Burnt Orange accents.
+*/
+( function(){
+ const RT = window.StyleRT = window.StyleRT || {};
+
+ RT.theme_light = function(){
+ RT.config = RT.config || {};
+
+ // THEME 1.0 DATA CONTRACT
+ RT.config.theme = {
+ meta_is_dark: false
+ ,meta_name: "Classic Wheat"
+
+ // --- SURFACES ---
+ ,surface_0: "hsl(40, 30%, 94%)" // App Background (Cream/Linen)
+ ,surface_1: "hsl(40, 25%, 90%)" // Sidebar (Slightly darker beige)
+ ,surface_2: "hsl(40, 20%, 98%)" // Cards (Lighter, almost white)
+ ,surface_3: "hsl(0, 0%, 100%)" // Modals (Pure White)
+ ,surface_input: "hsl(40, 20%, 98%)" // Form Inputs
+ ,surface_code: "hsl(40, 15%, 90%)" // Code Block Background
+ ,surface_select: "hsl(45, 100%, 85%)" // Text Selection Highlight
+
+ // --- CONTENT ---
+ ,content_main: "hsl(30, 20%, 20%)" // Deep Umber (Not Black)
+ ,content_muted: "hsl(30, 15%, 45%)" // Medium Brown
+ ,content_subtle: "hsl(30, 10%, 65%)" // Light Brown/Gray
+ ,content_inverse: "hsl(40, 30%, 94%)" // Text on dark buttons
+
+ // --- BRAND & ACTION ---
+ ,brand_primary: "hsl(30, 90%, 35%)" // Burnt Orange (Action)
+ ,brand_secondary: "hsl(35, 70%, 45%)" // Rust / Gold
+ ,brand_tertiary: "hsl(25, 60%, 55%)" // Copper
+ ,brand_link: "hsl(30, 100%, 35%)" // Link Color
+
+ // --- BORDERS ---
+ ,border_faint: "hsl(35, 20%, 85%)"
+ ,border_default: "hsl(35, 20%, 75%)"
+ ,border_strong: "hsl(35, 20%, 55%)"
+
+ // --- STATE & FEEDBACK ---
+ ,state_success: "hsl(100, 40%, 40%)" // Forest Green
+ ,state_warning: "hsl(30, 90%, 50%)" // Persimmon
+ ,state_error: "hsl(0, 60%, 45%)" // Crimson
+ ,state_info: "hsl(200, 50%, 45%)" // Navy Blue
+
+ // --- SYNTAX ---
+ ,syntax_keyword: "hsl(20, 90%, 45%)" // Rust
+ ,syntax_string: "hsl(100, 35%, 35%)" // Ivy Green
+ ,syntax_func: "hsl(300, 30%, 40%)" // Muted Purple
+ ,syntax_comment: "hsl(35, 10%, 60%)" // Light Brown
+ };
+
+ // --- APPLY THEME ---
+ const palette = RT.config.theme;
+ const body = document.body;
+ const html = document.documentElement;
+
+ html.style.backgroundColor = palette.surface_0;
+ body.style.backgroundColor = palette.surface_0;
+ body.style.color = palette.content_main;
+
+ const s = body.style;
+ for (const [key, value] of Object.entries(palette)) {
+ s.setProperty(`--rt-${key.replace(/_/g, '-')}`, value);
+ }
+ };
+} )();
--- /dev/null
+/*
+ Theme: Golden Wheat (Light) - "Spanish Gold Edition"
+ File: style/theme-light-gold.js
+ Standard: Theme 1.0
+ Description: Light Parchment background with Oxblood Red ink.
+*/
+( function(){
+ const RT = window.StyleRT = window.StyleRT || {};
+
+ RT.theme = function(){
+ RT.config = RT.config || {};
+
+ RT.config.theme = {
+ meta_is_dark: false
+ ,meta_name: "Golden Wheat (Yellow)"
+
+ // --- SURFACES (Light Parchment) ---
+ // Shifted lightness up to 94% for a "whiter" feel that still holds the yellow tint.
+ ,surface_0: "hsl(48, 50%, 94%)" // Main Page: Fine Parchment
+ ,surface_1: "hsl(48, 40%, 90%)" // Panels: Slightly darker
+ ,surface_2: "hsl(48, 30%, 97%)" // Cards: Very light
+ ,surface_3: "hsl(0, 0%, 100%)" // Popups
+ ,surface_input: "hsl(48, 20%, 96%)"
+ ,surface_code: "hsl(48, 25%, 88%)" // Distinct Code BG
+ ,surface_select: "hsl(10, 70%, 85%)" // Red Highlight
+
+ // --- CONTENT (Deep Ink) ---
+ ,content_main: "hsl(10, 25%, 7%)" // Deep Warm Black (Ink)
+ ,content_muted: "hsl(10, 15%, 35%)" // Dark Grey-Red
+ ,content_subtle: "hsl(10, 10%, 55%)"
+ ,content_inverse: "hsl(48, 50%, 90%)"
+
+ // --- BRAND & ACTION (The Red Spectrum) ---
+ ,brand_primary: "hsl(12, 85%, 30%)" // H1 (Deep Oxblood)
+ ,brand_secondary: "hsl(10, 80%, 35%)" // H2 (Garnet)
+ ,brand_tertiary: "hsl(8, 70%, 40%)" // H3 (Brick)
+ ,brand_link: "hsl(12, 90%, 35%)" // Link
+
+ // --- BORDERS ---
+ ,border_faint: "hsl(45, 30%, 80%)"
+ ,border_default: "hsl(45, 30%, 70%)" // Pencil Grey
+ ,border_strong: "hsl(12, 50%, 40%)"
+
+ // --- STATE ---
+ ,state_success: "hsl(120, 40%, 30%)"
+ ,state_warning: "hsl(25, 90%, 45%)"
+ ,state_error: "hsl(0, 75%, 35%)"
+ ,state_info: "hsl(210, 60%, 40%)"
+
+ // --- SYNTAX ---
+ ,syntax_keyword: "hsl(0, 75%, 35%)"
+ ,syntax_string: "hsl(100, 35%, 25%)"
+ ,syntax_func: "hsl(15, 85%, 35%)"
+ ,syntax_comment: "hsl(45, 20%, 50%)"
+ };
+
+ // --- APPLY THEME ---
+ const palette = RT.config.theme;
+ const body = document.body;
+ const html = document.documentElement;
+
+ html.style.backgroundColor = palette.surface_0;
+ body.style.backgroundColor = palette.surface_0;
+ body.style.color = palette.content_main;
+
+ const s = body.style;
+ for (const [key, value] of Object.entries(palette)) {
+ s.setProperty(`--rt-${key.replace(/_/g, '-')}`, value);
+ }
+
+ // Global overrides
+ const style_id = 'rt-global-overrides';
+ if (!document.getElementById(style_id)) {
+ const style = document.createElement('style');
+ style.id = style_id;
+ style.textContent = `
+ ::selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
+ ::-moz-selection { background: var(--rt-surface-select); color: var(--rt-brand-primary); }
+
+ ::-webkit-scrollbar { width: 12px; }
+ ::-webkit-scrollbar-track { background: var(--rt-surface-0); }
+ ::-webkit-scrollbar-thumb {
+ background: var(--rt-border-default);
+ border: 2px solid var(--rt-surface-0);
+ border-radius: 8px;
+ }
+ ::-webkit-scrollbar-thumb:hover { background: var(--rt-brand-secondary); }
+
+ rt-article p, rt-article li {
+ text-shadow: 0px 0px 0.5px rgba(0,0,0, 0.2);
+ }
+
+ .MathJax, .MathJax_Display, .mjx-chtml {
+ color: var(--rt-content-main) !important;
+ fill: var(--rt-content-main) !important;
+ stroke: var(--rt-content-main) !important;
+ }
+ `;
+ document.head.appendChild(style);
+ }
+ };
+
+} )();
--- /dev/null
+/*
+ General utilities for the StyleRT library.
+*/
+
+window.StyleRT = window.StyleRT || {};
+
+// --- DEBUG SYSTEM ---
+window.StyleRT.debug = {
+
+ // all debug messages enabled
+/*
+ active_tokens: new Set([
+ 'style', 'layout', 'pagination'
+ ,'selector', 'config', 'error'
+ ,'term'
+ ]),
+*/
+ active_tokens: new Set([
+ 'term'
+ ]),
+
+ log: function(token, message) {
+ if (this.active_tokens.has(token)) {
+ console.log(`[StyleRT:${token}]`, message);
+ }
+ },
+
+ warn: function(token, message) {
+ if (this.active_tokens.has(token)) {
+ console.warn(`[StyleRT:${token}]`, message);
+ }
+ },
+
+ // New: Always log errors regardless of token, but tag them
+ error: function(token, message) {
+ console.error(`[StyleRT:${token}] CRITICAL:`, message);
+ },
+
+ enable: function(token) { this.active_tokens.add(token); console.log(`Enabled: ${token}`); },
+ disable: function(token) { this.active_tokens.delete(token); console.log(`Disabled: ${token}`); }
+};
+
+// --- UTILITIES ---
+window.StyleRT.utility = {
+ // --- FONT PHYSICS ---
+ measure_ink_ratio: function(target_font, ref_font = null) {
+ const debug = window.StyleRT.debug;
+ debug.log('layout', `Measuring ink ratio for ${target_font}`);
+
+ const canvas = document.createElement('canvas');
+ const ctx = canvas.getContext('2d');
+
+ if (!ref_font) {
+ const bodyStyle = window.getComputedStyle(document.body);
+ ref_font = bodyStyle.fontFamily;
+ }
+
+ const get_metrics = (font) => {
+ ctx.font = '100px ' + font;
+ const metrics = ctx.measureText('M');
+ return {
+ ascent: metrics.actualBoundingBoxAscent,
+ descent: metrics.actualBoundingBoxDescent
+ };
+ };
+
+ const ref_m = get_metrics(ref_font);
+ const target_m = get_metrics(target_font);
+
+ const ratio = ref_m.ascent / target_m.ascent;
+ // debug.log('layout', `Ink Ratio calculated: ${ratio.toFixed(3)}`);
+
+ return {
+ ratio: ratio,
+ baseline_diff: ref_m.descent - target_m.descent
+ };
+ },
+
+ // --- COLOR PHYSICS ---
+ is_color_light: function(color_string) {
+ const debug = window.StyleRT.debug;
+
+ // 1. HSL Check
+ if (color_string.startsWith('hsl')) {
+ const numbers = color_string.match(/\d+/g);
+ if (numbers && numbers.length >= 3) {
+ const lightness = parseInt(numbers[2]);
+ return lightness > 50;
+ }
+ }
+
+ // 2. RGB Check
+ const rgb = color_string.match(/\d+/g);
+ if (!rgb) {
+ // debug.warn('color_layout', `Failed to parse color: "${color_string}". Defaulting to Light.`);
+ return true;
+ }
+
+ const r = parseInt(rgb[0]);
+ const g = parseInt(rgb[1]);
+ const b = parseInt(rgb[2]);
+ const luma = (r * 299 + g * 587 + b * 114) / 1000;
+ return luma > 128;
+ },
+
+ is_block_content: function(element) {
+ return element.textContent.trim().includes('\n');
+ }
+};
--- /dev/null
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8">
+ <title>RT Style System: Reference Manual</title>
+
+ <script src="style/body_visibility_hidden.js"></script>
+ <script> window.StyleRT.body_visibility_hidden(); </script>
+
+ <script src="style/utility.js"></script>
+
+ <script src="style/theme_dark_gold.js"></script>
+
+ <script src="style/article_tech_ref.js"></script>
+
+ <script src="style/RT_math.js"></script>
+ <script src="style/RT_code.js"></script>
+ <script src="style/RT_term.js"></script>
+ <script src="style/RT_TOC.js"></script>
+
+</head>
+<body>
+
+ <RT-article>
+ <RT-title author="Gemini" date="2026-01-14" title="RT Style System: Reference Manual"></RT-title>
+
+ <RT-TOC level="1"></RT-TOC>
+
+ <h1>Architecture Overview</h1>
+ <p>
+ The <RT-term>RT Style System</RT-term> is a client-side, JavaScript-driven publishing framework designed to turn raw HTML into high-readability technical documentation. Unlike standard CSS frameworks, RT uses JavaScript to handle complex layout tasks like <RT-neologism>ink-ratio balancing</RT-neologism> and dynamic pagination.
+ </p>
+
+ <h2>The Orchestrator</h2>
+ <p>
+ The core of the system is <RT-code>style_orchestrator.js</RT-code>. It is placed at the bottom of the HTML <RT-code><body></RT-code>. Its job is to:
+ </p>
+ <ol>
+ <li>Detect which modules are already loaded.</li>
+ <li>Load missing modules (defaulting to Dark Theme if none is specified).</li>
+ <li>Execute the <strong>Semantics Phase</strong> (styling tags).</li>
+ <li>Wait for MathJax (if present).</li>
+ <li>Execute the <strong>Layout Phase</strong> (pagination, page rendering).</li>
+ <li>Reveal the document.</li>
+ </ol>
+
+ <h1>Semantic Tags</h1>
+ <p>
+ The system relies on a specific set of custom tags in the <RT-code>RT-</RT-code> namespace to separate structure from presentation.
+ </p>
+
+ <h2>Terminology</h2>
+
+ <h3>Conventional Terms</h3>
+ <p>
+ Use <RT-code><RT-term></RT-code> for standard, industry accepted technical terms. The system decorates only the first occurrence of each unique term so that the first appearance functions as a definition point, and later appearances do not overload the page with styling.
+ </p>
+
+ <RT-code>
+The <RT-term>Singleton Pattern</RT-term> restricts instantiation...
+ </RT-code>
+
+ <p>
+ <em>Renders as:</em> The <RT-term>Singleton Pattern</RT-term> restricts instantiation...
+ </p>
+
+ <h3>Neologisms</h3>
+ <p>
+ Use <RT-code><RT-neologism></RT-code> for terms invented specifically for the current document or project. Neologisms are styled more strongly than conventional terms, visually distinguishing "jargon you should know" from "jargon we just made up."
+ </p>
+
+ <RT-code>
+We define the <RT-neologism>Hyper Tape</RT-neologism> as a construct...
+ </RT-code>
+
+ <p>
+ <em>Renders as:</em> We define the <RT-neologism>Hyper Tape</RT-neologism> as a construct...
+ </p>
+
+ <h3>First Occurrence Rule</h3>
+ <p>
+ The term system is intentionally conservative. For the tags <RT-code><RT-term></RT-code> and <RT-code><RT-neologism></RT-code>, only the first occurrence of a unique term is decorated. Subsequent mentions are rendered as normal prose.
+ </p>
+
+ <p>
+ Uniqueness is tracked by normalizing the term text (trimmed, then lowercased). This means that <RT-code>Symbol</RT-code> and <RT-code>symbol</RT-code> count as the same term.
+ </p>
+
+ <h3>Forced Emphasis Variants</h3>
+ <p>
+ Sometimes a later mention of a term should be emphasized again. For that purpose, the system provides explicit emphasis tags:
+ </p>
+
+ <ul>
+ <li><RT-code><RT-term-em></RT-code></li>
+ <li><RT-code><RT-neologism-em></RT-code></li>
+ </ul>
+
+ <p>
+ These variants are always decorated, even if the term appeared earlier.
+ </p>
+
+ <h3>Automatic Definition Anchors</h3>
+ <p>
+ For first occurrences, the term module automatically assigns an <RT-code>id</RT-code> attribute if one does not already exist. This creates stable anchors for future indexing and linking.
+ </p>
+
+ <RT-code>
+We define a <RT-term>Symbol</RT-term> as...
+ </RT-code>
+
+ <p>
+ The first occurrence will be given an id similar to <RT-code>def-symbol</RT-code>. For neologisms, an additional marker is used, for example <RT-code>def-neo-hyper-tape</RT-code>.
+ </p>
+
+ <h2>Technical Content</h2>
+
+ <h3>Code</h3>
+ <p>
+ Use <RT-code><RT-code></RT-code>. If placed inline, it acts like a span. If placed as a block (with newlines), it acts like a pre formatted block with a theme aware border.
+ </p>
+
+ <RT-code>
+# Block Code Example
+def hello():
+ return "World"
+ </RT-code>
+
+ <h3>Mathematics</h3>
+ <p>
+ Use <RT-code><RT-math></RT-code>. The system auto detects if it is a block equation or inline variable and wraps it in MathJax delimiters.
+ </p>
+ <p>
+ Inline: Let <RT-math>x</RT-math> be the input.
+ </p>
+ <p>
+ Block:
+ </p>
+ <RT-math>
+ f(x) = \sum_{i=0}^{n} x_i
+ </RT-math>
+
+ <h1>Navigation & Layout</h1>
+
+ <h2>Automatic Table of Contents</h2>
+ <p>
+ Use <RT-code><RT-TOC></RT-code> to insert a generated table of contents. The tag scans the document <em>forward</em> from its current position to collect headings.
+ </p>
+
+ <h3>Explicit Mode</h3>
+ <p>
+ Use the <RT-code>level="N"</RT-code> attribute to target a specific heading depth.
+ </p>
+ <ul>
+ <li><RT-code><RT-TOC level="1"></RT-code>: Collects all <RT-code><h1></RT-code> elements until the end of the document. Best for the main document index.</li>
+ <li><RT-code><RT-TOC level="2"></RT-code>: Collects all <RT-code><h2></RT-code> elements until it encounters the next <RT-code><h1></RT-code>. Best for chapter summaries.</li>
+ </ul>
+
+ <h3>Implicit Mode</h3>
+ <p>
+ If no level is specified, the TOC scans backwards to find the nearest heading (for example H1) and assumes you want to collect children one level deeper (for example H2).
+ </p>
+ <p>
+ <em>Note: Implicit mode can fail if placed before the first heading of a section. Use explicit levels for robust results.</em>
+ </p>
+
+ <h2>The Title Block</h2>
+ <p>
+ Use <RT-code><RT-title></RT-code> as the first element in your <RT-code><body></RT-code> (before the article container). This tag generates a standardized, styled header block with the document title and metadata.
+ </p>
+
+ <h3>Attributes</h3>
+ <ul>
+ <li><RT-code>title</RT-code> (Required): The main heading of the document.</li>
+ <li><RT-code>author</RT-code> (Optional): The author's name. Renders in a bold accent color.</li>
+ <li><RT-code>date</RT-code> (Optional): The publication or revision date.</li>
+ </ul>
+
+ <h3>Example</h3>
+ <RT-code>
+ <RT-title
+ title="RT Style System: Reference Manual"
+ author="Gemini"
+ date="2026-01-14">
+ </RT-title>
+ </RT-code>
+
+ <p>
+ <em>Renders as:</em> A centered, high contrast H1 followed by a serif styled metadata row containing the author and date.
+ </p>
+
+ <h2>The Article Container</h2>
+ <p>
+ The root element must be <RT-code><RT-article></RT-code>. This is the boundary for the pagination logic.
+ </p>
+
+ <h2>Pagination</h2>
+ <p>
+ The script <RT-code>paginate_by_element.js</RT-code> scans the article. It calculates the height of every element (including margins) and bundles them into <RT-code><RT-page></RT-code> elements.
+ </p>
+ <p>
+ <RT-neologism>Soft Limit Pagination</RT-neologism>: The system attempts to keep headers with their following paragraphs. It will break a page early rather than stranding a header at the bottom.
+ </p>
+
+ <h1>Debugging</h1>
+
+ <h2>Debug Tokens</h2>
+ <p>
+ RT provides a lightweight debug logging system in <RT-code>utility.js</RT-code>. Logging is controlled by a set of active debug tokens. Each log message is assigned a token, and the message prints only if that token is enabled.
+ </p>
+
+ <p>
+ Examples of common tokens include <RT-code>style</RT-code>, <RT-code>layout</RT-code>, <RT-code>pagination</RT-code>, <RT-code>selector</RT-code>, <RT-code>config</RT-code>, and <RT-code>term</RT-code>.
+ </p>
+
+ <h2>How Logging is Gated</h2>
+ <p>
+ Normal log and warning output are gated. The methods <RT-code>debug.log(token,message)</RT-code> and <RT-code>debug.warn(token,message)</RT-code> will print only when the token exists in <RT-code>debug.active_tokens</RT-code>.
+ </p>
+
+ <p>
+ This prevents the console from being flooded during normal use, while still allowing deep visibility during development.
+ </p>
+
+ <h2>Errors are Always Printed</h2>
+ <p>
+ Errors are treated differently. The method <RT-code>debug.error(token,message)</RT-code> always prints, regardless of token state. These messages represent failures that require attention.
+ </p>
+
+ <h2>Enabling and Disabling Tokens</h2>
+ <p>
+ Tokens may be enabled or disabled in two ways: by editing the <RT-code>active_tokens</RT-code> set in <RT-code>utility.js</RT-code>, or at runtime by calling:
+ </p>
+
+ <RT-code>
+window.StyleRT.debug.enable('term')
+window.StyleRT.debug.disable('term')
+ </RT-code>
+
+ <p>
+ For example, the term system (<RT-code>RT_term.js</RT-code>) uses the <RT-code>term</RT-code> token. When that token is enabled, the module will print messages describing how terms were detected and which term definitions were assigned IDs.
+ </p>
+
+ <h1>Themes</h1>
+ <p>
+ The system supports hot swapping themes by changing the script import in the head.
+ </p>
+ <ul>
+ <li><strong>Dark:</strong> <RT-code>style/theme_dark_gold.js</RT-code> (Default)</li>
+ <li><strong>Light:</strong> <RT-code>style/theme_light_gold.js</RT-code></li>
+ </ul>
+
+ <h1>Manifest</h1>
+ <RT-code>
+1. style_orchestrator.js (Example/default footer script)
+2. utility.js (Math/Color physics)
+3. article_tech_ref.js (Typography and CSS injection)
+4. RT_code.js (Code block logic)
+5. RT_math.js (MathJax wrapper)
+6. RT_term.js (Term styling)
+7. RT_TOC.js (Navigation generator)
+8. paginate_by_element.js (Page splitter)
+9. page_fixed_glow.js (Visual page container)
+ </RT-code>
+
+ <script src="style/style_orchestrator.js"></script>
+ <script>
+ window.StyleRT.style_orchestrator();
+ </script>
+ </RT-article>
+</body>
+</html>
--- /dev/null
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8">
+ <title>Test File</title>
+ <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+JP&display=swap" rel="stylesheet">
+
+ <script src="style/body_visibility_hidden.js"></script>
+ <script>
+ window.StyleRT.body_visibility_hidden();
+ </script>
+</head>
+<body>
+
+ <p> text before the first heading </p>
+
+ <h1>Given</h1>
+ <p>The English language is a given, apparently.</p>
+ <p>
+ This discussion happens to appear in the context of a Python implementation.
+ </p>
+
+ <h1>Symbol</h1>
+ <h2>Definition</h2>
+ <p>x
+ We have a symbol instance factory. Each time the <RT-code>make</RT-code>
+ method is called, we get a unique identity <RT-math>i</RT-math>.
+
+ A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ </p>
+ <RT-code>
+x = y
+# y is a variable holding a symbol instance
+ </RT-code>
+
+ <p>
+ 1. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 2. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 3. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 4. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 5. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 6. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 7. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 8. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 11. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 12. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 13. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 14. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 15. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 16. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 17. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ 18. A symbol instance may be copied as though it were an integer.
+ Thus, a common method for making a copy is assignment:
+ </p>
+
+
+ <h1>Path</h1>
+ <h2>Discrete Function</h2>
+ <p>Topologically it gives us a satisfying feeling that a given 'way' never leads to different destinations.</p>
+
+ <p>A common notation for a function is:</p>
+ <RT-math>
+ destination = f(way)
+ </RT-math>
+
+ <p>
+ Because the same way always leads to the given destination,
+ we can represent the mapping as follows:
+ </p>
+ <RT-code>
+ def resolve_path(way):
+ return hypergraph.lookup(way)
+ </RT-code>
+
+ <script src="style/style_orchestrator.js"></script>
+ <script>
+ window.StyleRT.style_orchestrator();
+ </script>
+
+</body>
+</html>
projects / Epimetheus / .git / commitdiff