Theme Forge Stellar Loom (TFSL)
Starlight theme-builder backend, library, and CLI.
Python installation
This Python distribution packages the frozen Theme Forge Node CLI. It requires Python 3.9 or later and an independently installed Node.js 22 or later on PATH; it does not install Node or install or invoke npm, npx, or corepack.
When this version is available from the Python package index:
python3 -m pip install "theme-forge-stellar-loom==0.5.0"
For a locally built wheel or source distribution without an index lookup:
python3 -m pip install --no-index --no-deps --find-links ./dist "theme-forge-stellar-loom==0.5.0"
Console entry points: tfsl, tfsl-batch. For example:
tfsl --help
tfsl --version
The selected wheel target tuples are darwin-arm64, linux-arm64-gnu and
linux-x64-gnu; use an artifact matching the host. Native compatibility depends
on that artifact's platform requirements, not just the Node major version.
The Python package exposes console launchers, not Python implementations of
the upstream JavaScript theme/compiler APIs. Relative documentation links below
describe upstream source layout rather than additional installed Python files.
See GitHub releases for upstream version history.
The 0.5.0 source retains reading layout presets (--reading-layout), distribution-safe TypeScript emission (--language typescript), Expressive Code syntax styling derivation, and book-chrome navigation.
Theme v2 and catalog
tfsl.theme-v2 is a separate closed domain. Historical tfsl.theme-v1 validation,
canonical bytes, generated packages and strict exchange compatibility remain supported.
Use loom-black-core, loom-flexoki-core, and loom-celestia-core in examples
as first-party capability fixtures, not reproductions of upstream designs.
The ordinary library compileTheme, CLI validate/compile/generate, and batch
compile/validate discriminate by schemaVersion. V2 compilation returns an
ordered styles map and a v2 descriptor; css (batch compiledCss) is its ordered
concatenation for display. It is not a structural browser preview. CLI compile
writes the fixed five stylesheet files and descriptor to an absent or empty
directory. V2 does not support --overwrite.
tfsl validate examples/loom-black-core.theme.json
tfsl compile examples/loom-black-core.theme.json --out compiled
tfsl generate examples/loom-black-core.theme.json --package metadata.json --out theme-package
Use --accent <declared-id> to select another complete light/dark variant.
The stylesheet order is styles/layers.css, styles/tokens.css,
styles/base.css, styles/accent.css, styles/overrides.css. The declaration
places starlight before tfsl, then orders Loom's tokens, base, accent and
overrides sublayers. Unlayered consumer custom CSS follows defaults and wins
under ordinary CSS cascade rules. Documented override selectors include :root,
.sl-markdown-content a:focus-visible, and ::selection.
The catalog supports finite Hero, PageTitle, Pagination and Sidebar choices,
responsive navigation, and bounded syntax/frame/diff presentation. Consumer
components and supported Expressive Code values retain precedence. Catalog
specifications include a closed catalog object; use the catalog examples for
these capabilities. Core specifications without that object retain their
separate, smaller contract. Unknown structures fail closed.
Header/PageFrame replacements, generated code tabs, virtual data modules and font-provider conversion remain deferred. Public Starlight search, theme, language and supporting controls retain their normal behavior.
Font records use logical IDs, face metadata, a SHA-256 and license/notice
identities. The spec has no paths or URLs. Explicitly materialize local resources
with materializeFontResources(root, declarations, selectedIds) and pass the
returned map as fontResources to generateThemePackageV2. The existing CLI
uses --font-root <selected-directory> --font-ids <comma-separated-ids>.
Only fixed <id>.woff or <id>.woff2 leaves are read: at most eight resources,
4 MiB each and 16 MiB total, rejecting symlinks, traversal and digest mismatches.
Generated font filenames are fixed ordinals. Core byte-pipeline fixtures are
explicitly non-rendering original bytes; actual font rendering and third-party
font licensing require catalog qualification. System fonts make no promise of
pixel-identical cross-OS rendering.
The legacy v1 exchange verifier requires the exact producer version: compiler
0.2.0 rejects briefs pinned to compilerVersion: "0.1.0" or the historical
0.1.1 development compiler. Theme v1 compilation remains supported.
V2 semantic compatibility is independent of package SemVer. Producer package version is provenance, not a compatibility gate. Exchange v2 recompiles locally and requires exact bound output/inventory equality; a producer patch version cannot conceal changed output. Explicit v1 import creates a fresh unadopted v2 candidate linked to the historical packet; it never changes historical bytes.
For offline installation of this Python distribution, use the local wheel/source-distribution pip command above. Upstream generated theme packages and JavaScript imports remain a separate Node ecosystem interface.
Repository · Issues · License.
The installed Python console launchers tfsl and tfsl-batch need no source
checkout. Public JavaScript imports belong to the separately installed upstream
Node package; the Python distribution does not expose a Python library API.
Generated plugin compatibility is demonstrated with Astro 7.3.1 and Starlight
0.42.0. Ordinary generated packages remain private by default.
Theme Forge Stellar Loom compiles typed, versioned theme specifications into canonical, deterministic CSS custom properties and theme descriptors for Starlight documentation sites.
This source describes version 0.5.0.
Overview
- Versioned Theme Schemas:
tfsl.theme-v1andtfsl.theme-v2 - Adapter:
starlight-v0.42 - Zero-Dependency Core: Compiles without runtime dependencies (
node:crypto,node:fs/promises,node:pathonly). - Deterministic: Produces byte-identical CSS and SHA-256 digests across environments.
- Deterministic Contrast Diagnostics: WCAG 2.2 AA luminance and contrast ratio calculations for body text, links, and inline code across light and dark modes.
- Safety First: Strict validation prevents CSS injection; refuses symlink destination roots and dangling intermediate symlinks (resolving safe existing intermediate parent directories), requires empty or absent destination directories for package generation (no in-place overwrite), requires
--overwritefor existing compilation outputs, protects manually edited CSS by verifying existing descriptor output digests, and detects input/output collisions.
Installation and upstream source prerequisites
The Python wheel carries the compiled Node CLI and requires no TypeScript build
at installation or first launch. Node.js 22+ must already be installed. The upstream
standalone JavaScript source package separately requires its locked development
packages, TypeScript build, typecheck and tests before packing: bin/tfsl.js imports
../dist/cli.js. These source-development requirements do not run in the Python
launcher or replace the packaged executable identity evidence.
CLI Usage
Use the installed Python console launchers with your own input files; paths under
examples/ below refer to upstream examples obtained separately.
# Validate a theme specification and inspect contrast diagnostics
tfsl validate ./examples/stellar-cyan.theme.json
# Fail validation if contrast warnings exist
tfsl validate ./examples/stellar-cyan.theme.json --strict-contrast
# Compile to custom CSS and descriptor
tfsl compile ./examples/stellar-cyan.theme.json --out ./dist/theme
# Generate an installable Starlight theme package
tfsl generate ./examples/stellar-cyan.theme.json --package ./pkg-meta.json --out ./dist/cyan-package
# Generate an installable package with the approved page-title-frame template
tfsl generate ./examples/amber-forge.theme.json --package ./pkg-meta.json --out ./dist/amber-package --template page-title-frame
# Re-compile into existing directory (verifies existing descriptor and unedited theme.css)
tfsl compile ./examples/stellar-cyan.theme.json --out ./dist/theme --overwrite
# Output parseable JSON diagnostics without progress prose
tfsl compile ./examples/stellar-cyan.theme.json --out ./dist/theme --json
# Show help
tfsl --help
# Show version
tfsl --version
# Run batch IPC runner over stdin/stdout (used by Theme Lab)
tfsl-batch
Theme Data Contract
Theme Forge Stellar Loom accepts untrusted JSON data conforming to the tfsl.theme-v1 specification. Top-level plain objects inherit strictly from standard Object.prototype or null to defend against prototype pollution (INVALID_PROTOTYPE).
Fields & Version Grammar
schemaVersion: Must be exactly"tfsl.theme-v1".adapter: Must be exactly"starlight-v0.42".name: Alphanumeric identifier (^[a-zA-Z0-9_-]{1,64}$).version: Strict SemVer 2.0.0 without leading zeroes in major/minor/patch segments (e.g.0.1.0), matching^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-...)?$.$schema(optional): Non-executing editor tooling metadata string; excluded from canonical semantic hashing and never dereferenced.colors: Object containingdarkandlightpalettes. Each palette must specify:accent:base,low,high(all 7-character#rrggbbhex colors).neutrals:bg,bgNav,bgSidebar,bgInlineCode,bgAccent,text,textAccent,textInvert,hairline,hairlineLight,hairlineShade(all#rrggbb).grays:gray1throughgray7(all#rrggbb).
typography:bodyFont:"system-sans"|"system-serif"|"system-mono".codeFont:"system-mono"|"system-code".baseFontSize(optional): Bounded dimension string (see bounds below).lineHeight(optional): Bounded unitless number between 1.0 and 3.0.
layout:contentWidth: Bounded dimension string.sidebarWidth: Bounded dimension string.
Per-Unit Dimension Bounds
All dimension values are strictly validated against positive finite bounds by unit:
| Role | px |
rem |
em |
ch |
|---|---|---|---|---|
layout.contentWidth |
[320, 3840] | [20, 240] | [20, 240] | [30, 200] |
layout.sidebarWidth |
[160, 600] | [10, 40] | [10, 40] | [15, 60] |
typography.baseFontSize |
[10, 36] | [0.625, 2.25] | [0.625, 2.25] | [1, 4] |
Spelling is canonically normalized within each unit (e.g., 048.00rem -> 48rem, 019.0px -> 19px). Units are not conflated; unit spelling is normalized, but unit conversions are preserved for rendering context.
Exit Codes & CLI Behavior
| Code | Category | Meaning & Edge Triggers |
|---|---|---|
0 |
Success | Command completed successfully (validate, compile, --help, --version). |
1 |
Theme Specification Error | Schema validation failure, missing or unreadable input file, or contrast threshold failure under --strict-contrast. |
2 |
Syntax / Invocation Error | Unknown options, missing option arguments, duplicate options, surplus operands, specifying --overwrite on generate (which is compile-only), or --out with a leading hyphen. (--help and --version are handled immediately before duplicate validation). |
3 |
Filesystem Safety or I/O Failure | Non-empty target directory without --overwrite (for compile), non-empty target directory (for generate), symlink target or traversal refusal, non-regular target (FIFO/socket), unmanaged manual edits to theme.css without matching descriptor, input/output collision, or temporary staging/publication write failure. |
Upstream JavaScript library API
The examples below describe the upstream Node library; installing this Python CLI adapter does not create a Python theme-compilation API.
import {
validateTheme, // Alias to validateThemeSpecification
validateThemeSpecification,
ValidationError,
compileTheme,
canonicalizeTheme, // Alias to canonicalizeSpecification
canonicalizeSpecification,
generateThemeDescriptor,
computeSha256,
analyzeThemeContrast,
calculateContrastRatio,
calculateRelativeLuminance,
ContrastError,
} from "@knowledge-forge-ai/theme-forge-stellar-loom";
// 1. Validate specification (throws ValidationError on invalid input)
const spec = validateTheme(inputJson);
// 2. Canonicalize specification (returns canonical object, JSON, and SHA-256 digest; excludes $schema from digest)
const { canonicalObject, canonicalJson, inputDigest } = canonicalizeTheme(spec);
// 3. Analyze contrast
const diagnostics = analyzeThemeContrast(canonicalObject);
// 4. Compile to CSS, descriptor, and diagnostics
const { css, descriptor, outputDigest, diagnostics: compDiagnostics } = compileTheme(spec, {
strictContrast: false, // Set true to throw ContrastError on contrast warnings
});
// 5. Generate complete installable Starlight plugin package (pure in-memory)
import { generateThemePackage, writeThemePackage } from "@knowledge-forge-ai/theme-forge-stellar-loom";
const packageResult = generateThemePackage({
themeSpec: spec,
metadata: {
name: "starlight-theme-stellar-cyan",
version: "0.1.0",
description: "Stellar Cyan Starlight theme plugin",
template: "page-title-frame", // Optional approved override template
},
strictContrast: false,
});
// 6. Write package files to disk safely (requires empty or absent directory)
const writeResult = await writeThemePackage(packageResult, "./dist/my-theme-package");
Upstream JavaScript package exports
These imports are provided by the upstream Node package, not by the Python console-launcher distribution. Theme Forge Stellar Loom provides explicit subpath exports:
.(@knowledge-forge-ai/theme-forge-stellar-loom): Core compiler, validator, generator, design exchange, and contrast diagnostics../batch(@knowledge-forge-ai/theme-forge-stellar-loom/batch): Batch IPC runner (runBatch,processBatchRequest)../cli(@knowledge-forge-ai/theme-forge-stellar-loom/cli): Programmatic CLI invocation (runCli,CLI_HELP)../protocol/*: JSON schemas, inventory, and canonical protocol example packets.
Protocol & Schemas
Theme Forge Stellar Loom defines and ships the portable theme evidence protocol v1 under protocol/tfsl-theme-evidence-v1/:
brief.schema.json: Schema fortfsl.theme-brief(version 1)candidate.schema.json: Schema fortfsl.theme-candidate(version 1)review.schema.json: Schema fortfsl.theme-review(version 1)visual-evidence.schema.json: Schema fortfsl.theme-visual-evidence(version 1)inventory.json: Protocol inventory manifestnegative-corpus.json: Closed negative test corpusexamples/: Integrity-bound canonical packet examples (brief,candidate-a,candidate-b,review)
Generated Starlight Plugin Contract
Each emitted theme package is a small, standalone Starlight plugin conforming to the pinned @astrojs/starlight@0.42.0 specification.
Integration
In consumer astro.config.mjs:
import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";
import themePlugin from "starlight-theme-stellar-cyan";
export default defineConfig({
integrations: [
starlight({
title: "Docs",
plugins: [themePlugin()],
// Consumer customCss automatically takes precedence over theme defaults:
customCss: ["./src/styles/custom.css"],
}),
],
});
Cascade Precedence & Component Overrides
- CSS Cascade: The plugin injects
${packageName}/styles/theme.cssbefore any existing entries inconfig.customCss. This cascade order guarantees that consumer CSS rules take precedence over theme defaults. - Idempotence: Repeated hook invocations do not duplicate stylesheet registrations.
- Component Overrides: If the package includes the opt-in
page-title-frametemplate, it registerscomponents.PageTitleonly if the consumer has not already configured a customPageTitlecomponent, strictly preserving consumer overrides.
Code Presentation & Syntax Palette Integration
Stellar Loom v0.2.0 introduces code presentation configuration and full syntax palette catalog support:
Syntax Palette Model & Schema
The syntaxPalette specification allows pairing custom syntax highlighting tokens with Expressive Code chrome:
syntax: Light and dark hex color mappings for 11 syntax roles (keyword,string,number,constant,function,type,variable,comment,punctuation,tag,attribute).chrome: Light and dark role mappings for frame surfaces:background: Editor frame code background.foreground: Default text / copy button foreground.border: Editor frame and inactive tab border.focus: Copy button focus outline and active element highlight.tabBarBackground: Starlight tablist / header strip background.activeTabBackground: Active tab background surface.activeTabIndicator: Active tab bottom accent line (--sl-tab-color-border).copyButtonForeground: Copy button text/icon color.
tabs: Tabbed presentation settings (e.g.activeIndicator: "bottom").frame: Frame style:"editor","terminal", or"plain".
Starlight Tabs Presentation
When syntaxPalette is supplied to generateThemePackageCatalog:
styles/tabs.css: Emitted as part of the theme package and automatically included incustomCss.- Visual Differentiation: Active tab bottom border (
--sl-tab-color-border) maps tochrome[mode].activeTabIndicator, while inactive tabs usechrome[mode].border, ensuring distinct, accessible visual state. - Tablist Bottom Border: Distinct 2px border separating the tab strip from tab content panels.
STTN TypeScript Authoring & Distribution Build Closure
Theme packages can be emitted in either JavaScript (default) or TypeScript:
- CLI: Pass
--language typescripttotfsl generate. - Catalog API: Set
language: "typescript"ingenerateThemePackageCatalog({ ... }). - Authoring Workflow:
- Emits typed source files (
src/index.ts,src/navigation.ts,src/middleware.ts) alongsidetsconfig.json. - Configures
build: "tsc"andprepare: "tsc"package scripts. - Package exports map strictly to compiled
./dist/artifacts (./dist/index.js,./dist/index.d.ts,./dist/navigation.js,./dist/navigation.d.ts). - Isolated distribution build closure ensures downstream consumers run standard type-checked JavaScript without requiring TypeScript runtime compilation.
- Emits typed source files (
- Parity Guarantee: TypeScript packages match JavaScript package browser rendering and CSS output byte-for-byte in consumer builds, verified via automated CI test suites (
test/ci/terminal-nova-rc.test.ts).
Book Chrome Layouts
Stellar Loom supports an integrated "Book Chrome" reading layout designed for dense technical documentation, long-form manuals, and book-style guides:
- Configuration: Set
bookChrome: true,bookChrome: false, or provide a granularBookChromeConfig:interface BookChromeConfig { chapterNavigation?: boolean; // Sequential next/previous chapter badges (default: true) chapterProgress?: boolean; // Reading progress indicator and sidebar chapter markers (default: true) keyboardShortcuts?: boolean; // ArrowLeft / ArrowRight navigation shortcuts (default: true) }
- Granular Markup Control:
chapterNavigation: Controls emission of next/previous chapter links and side navigation arrows (.tfsl-book-nav-arrow) incomponents/Pagination.astro. Arrows are hidden on compact viewports and display on viewports>= 80rem.chapterProgress: Emits reading progress badges incomponents/Pagination.astroand active chapter markers (chapterActiveFontWeight: "600") incomponents/Sidebar.astroandcomponents/SidebarTree.astro.keyboardShortcuts: Emits client-side arrow key navigation listeners incomponents/Pagination.astro.
- Keyboard & A11y Collision Safety:
Keyboard shortcuts respect user focus and assistive workflows. Event listeners immediately bail out when:
- An event was already handled (
e.defaultPrevented). - Active element is an editable input (
<input>,<select>,<textarea>, orisContentEditable). - Focus resides inside interactive controls: tabs/roving tablists (
[role="tab"],[role="tablist"]), code blocks (.expressive-code,<pre>,<code>), open<dialog>elements, or horizontally scrollable containers.
- An event was already handled (
- Layered Styling & Zero
!important: All book chrome rules are scoped under@layer tfsl.overridesand.tfsl-book-chrome, guaranteeing zero!importantdeclarations and complete respect for consumer unlayered custom CSS. - Deterministic Provenance:
Granular and boolean
BookChromeConfigsettings are normalized into an effective configuration object inprovenance.bookChrome, ensuring semantically equivalent options (such asbookChrome: trueandbookChrome: {}) yield identical package inventory digests, while distinct effective configurations yield distinct digests.
Flexoki Paired Profile Cross-Framework Proof
Stellar Loom and Solar Sail share a unified design profile model (packages/solar-sail/examples/flexoki.profile.json) conforming to tf-paired-profile-v1:
- Dual-Engine Compilation: A single JSON design profile independently compiles into:
- A Tailwind v4 + shadcn/ui application theme (via Solar Sail).
- An Astro / Starlight documentation theme (via Stellar Loom).
- Digest Equality & Determinism: Both compilers compute identical canonical SHA-256 profile digests, guaranteeing provenance alignment across disparate component architectures.
- Change Propagation & Target Overrides:
- Shared profile updates (e.g. primary/accent colors) propagate symmetrically to both targets.
- Target-specific overrides (
targetOverrides.solarSailvstargetOverrides.loom) modify only the selected framework's generated output while leaving the sibling engine's output digest unchanged.
- Paired Browser Smoke Qualification:
Headless browser qualification (
node packages/stellar-loom/tools/smoke-code.mjs) verifies both engines simultaneously:- Tests mobile (390px), desktop (1280px), and wide (1440px) viewports with zero horizontal overflow.
- Asserts computed token styles across light and dark modes: teal primary (
#24837blight,#3aa99fdark), surface backgrounds, elevated card styling, active chapter badges, and nested sidebar group hierarchies.
Consumer Override Precedence & Negative Controls
Emitted themes strictly adhere to consumer sovereignty:
- Leaf Options: Consumer Expressive Code options (e.g.
styleOverrides.frames.editorBackground) deep-merge over theme defaults. - Array Replacement: Consumer array properties (e.g.
themes: ["github-light"]) replace theme defaults rather than concatenating. - Unlayered Custom CSS: Consumer
customCssstylesheets load after theme stylesheets and reside in unlayered space, overriding@layer tfslrules under standard CSS cascade semantics. - PageTitle Component Precedence: Consumer-configured
components.PageTitlecompletely bypasses theme frame wrappers. - False Expressive Code Control: Setting
expressiveCode: falsecompletely disables Expressive Code rendering, gracefully falling back to standard Markdown<pre><code>.
Expressive Code Contrast Normalization
Expressive Code enforces a default minimum syntax contrast ratio of 5.5:1 (minSyntaxHighlightingColorContrast: 5.5).
- When a requested syntax token already achieves >= 5.5:1 contrast against
codeBackground, Expressive Code renders the exact specified hex color. - When a requested token has < 5.5:1 raw contrast (such as teal
#24837bon light cream#fffcf0, ~4.1:1), Expressive Code dynamically adjusts luminance (darkening on light backgrounds or lightening on dark backgrounds) to reach at least 5.5:1. - Both requested intent and normalized observed colors are tracked and validated in qualification receipts.
Provenance Architecture & Output Digest Boundaries
Theme Forge distinguishes between CSS compilation output and package-level runtime configuration:
cssOutputDigest: Represents the compilation digest of purely CSS-derived theme output (styles/tokens.css,styles/base.css,styles/layers.css,styles/accent.css,styles/overrides.css, andstyles/tabs.css). BecausecompileSyntaxPalettedigests the CSS compilation output, changing only JavaScript/runtime chrome roles (such asframes.inlineButtonForegroundoreditorTabBarBackgroundinecDefaults.styleOverrides) does not altercssOutputDigest.provenance.inventoryDigest: Covers the comprehensive file tree of the generated theme package, includingindex.js(orsrc/index.ts), component templates, and style assets. When any runtime chrome role insyntaxPalette.chromechanges,ecDefaults.styleOverrideschanges inindex.js/src/index.ts, modifyingprovenance.inventoryDigestwhile preservingcssOutputDigest.- Paired Role Fail-Closed Invariant: Expressive Code requires tuples
[dark, light]for style overrides. Every chrome role must be defined symmetrically in both dark and light modes; defining a role in only one mode throws a[SYNTAX_PALETTE_VALIDATION_ERROR]rather than silently dropping the specification.
Upstream browser qualification
Upstream source qualification includes a hermetic portable-container matrix and a separate developer-local browser consumer smoke. The latter packs fresh JavaScript artifacts, builds disposable Astro consumers and checks live DOM/CSSOM behavior, retaining test receipts and evidence. Those workflows are separate from installing or running this Python CLI adapter. The core adapter qualification limits below remain applicable; a successful CLI installation is not browser, print-layout or generated-site qualification.
Licensing
Licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) with separate commercial licensing available. See LICENSE and COMMERCIAL-LICENSE.md.
Core adapter qualification limits
Core browser evidence covers screen media on sidebar-bearing documentation pages. Starlight 0.42.0 has unlayered sidebar-less content-width and print rules which can win over Loom layers. Sidebar-less content sizing and a coherent print palette are not qualified here; a later adapter/catalog decision must address them.
The catalog pins output-determining source files through repository tests. Installed packages validate catalog/template data and recompile bound exchange output; they do not read TypeScript source or provide tamper detection. Font stacks and responsive content caps come directly from catalog data; sidebar width remains the explicit surface value. Token-to-selector mappings live in the pinned compiler expression.
Historical v1 import is explicitly lossy: its new candidate rationale records the
original layout and fresh core defaults. Candidate IDs are freshly derived and old
unsigned provenance claims are not inherited. Fresh verification and adoption remain
required. V2 CLI output is structured JSON, including when --json is omitted.
Upstream source qualification runs its locked build/typecheck/test workflow and
node tools/build-catalog-evidence.mjs. The catalog build command emits the
executable identity required by exchange verification and packaged consumers; the
Python launcher consumes the packaged result and does not manufacture that evidence.
Paired Profile v2 checkpoint
The upstream paired protocol defines neutral semantic groups and separately named target adapters. Existing paired v1 functions and historical identities remain maintained. V2 requires explicit version migration, source-byte binding and capability reports; it is not a silent replacement for v1. Unsupported intent remains visible.
Loom pixel geometry does not imply rem/em conversion, and font families require explicit font-ID bindings. Code/syntax mapping is part of the report. Solar component/sidebar/chart vocabulary stays in target-only overrides. Complete invocations additionally bind base inputs, final configuration, generation options and compiler identity. Report or profile equality alone is insufficient.
See the B2 evaluation for qualification and limitations. Current Studio ingestion/adoption is not qualified for v2. No release or adoption authorization is implied.
V2 application requires an explicit complete base catalog, token-set key, primary and secondary families, default accent, and any family-to-font-ID bindings. The mapper returns both catalog and syntax; pass both to the existing catalog generator and bind reading, book-chrome, language and package options separately. Relative lengths and alpha colors remain visible unsupported effects; no root-size or alpha-compositing conversion is inferred. Native validators remain authoritative. Font declarations are generation inputs; resource bytes and license readback are separate execution evidence. No Loom compiler vocabulary or package API changes are needed for this adapter.
Current Python distribution and upstream packaging
The current Python distribution uses the versioned pip commands and three target tuples listed above. Its native consumer qualification remains a separate gate.
The maintained public source composition separately includes DISTRIBUTION.md,
release-layout.json, a locked first-party flake and an installed-package probe.
Use that public source for sibling-free builds. See
the public distribution guide in composed releases; in the
upstream development source tree the source is docs/operations/loom-solar-distribution.md.
The three required systems are Apple Silicon macOS, Linux ARM64 and Linux AMD64.
Declared packaging coverage and qualified native execution remain separate gates.
Metadata
Release files for theme-forge-stellar-loom 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| theme_forge_stellar_loom-0.5.0.tar.gz | 573.5 kB | With provenance | Details for theme_forge_stellar_loom-0.5.0.tar.gz |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details for theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_x86_64.whl |
| theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details for theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_aarch64.whl |
| theme_forge_stellar_loom-0.5.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for theme_forge_stellar_loom-0.5.0-py3-none-macosx_11_0_arm64.whl |
Total release size: 5.3 MB
Release files / theme_forge_stellar_loom-0.5.0.tar.gz
| Download URL | theme_forge_stellar_loom-0.5.0.tar.gz |
|---|---|
| Size | 573.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8b17127ea7d95432c6a628b42769b82aa45b47f417e6023a5592e7fd3119d236
|
|
BLAKE2b-256 checksum How to use checksums |
3f574c47a94f91774d1da12819b71633c3ebbafff17234c5a5174edee29d8013
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.
Transparency logRelease files / theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_x86_64.whl
| Download URL | theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
cc92dabdc7eb8ab34461e2114bcd956be2a0b1a4997948330e62fe6c07aa48e7
|
|
BLAKE2b-256 checksum How to use checksums |
7b5bb8c5f48ca553249dd69c91a04d95a4a7c2d5587b57068fd061f0e61da769
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.
Transparency logRelease files / theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_aarch64.whl
| Download URL | theme_forge_stellar_loom-0.5.0-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
8f76436c7f99008c82bd34101a2f12182040e42bd363520c909775418ec3f76d
|
|
BLAKE2b-256 checksum How to use checksums |
da954ebf67f9da27b131d59a8efefae7b109df21cd40cd997b2f408b11903e94
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.
Transparency logRelease files / theme_forge_stellar_loom-0.5.0-py3-none-macosx_11_0_arm64.whl
| Download URL | theme_forge_stellar_loom-0.5.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
faf99433ec5c823b5faa97f56ee6b1a654135aa21076f336e44a48bd7c647b38
|
|
BLAKE2b-256 checksum How to use checksums |
05b7b561f820e275a3711e878d0259de77a0b8dbd40623a10861595db9d929d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.
Transparency logSecurity for theme-forge-stellar-loom 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 4 files in this release have been uploaded with provenance metadata.
Attestation for theme_forge_stellar_loom-0.5.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.