Universal UX Invariants & Ergonomic Contracts v0.2.0

Standards for the 20+ ArtCraft Creative Suite

Authoritative specifications governing multi-tool button cycling, timeline scrubs, AccessKit accessibility trees, full shell BiDi mirroring, universal command taxonomy, and autonomous AI agent governance across all ArtCraft applications.

28
Active Standards
100% Executable Specs
20+
Governed Apps
PhotoCraft, CADCraft, FilmCraft...
100%
CI Verification
Zero AST Drift Guarantee
v0.2.0
AutoCraft MCP
Universal Stdio Gateway

Specifications Catalog

Showing 28 specifications
STD-A11Y-001 accessibility

AccessKit Node Tagging and Automated CI Accessibility Audit

# STD-A11Y-001: AccessKit Node Tagging and Automated CI Accessibility Audit

## 1. Abstract
Assistive technologies (screen readers, speech input, screen magnifiers) rely on accessibility trees generated by AccessKit. Custom widgets in egui that are allocated via `ui.interact` or `allocate_exact_size` produce empty, unnamed nodes unless explicitly annotated. This standard specifies mandatory accessibility tagging and automated CI testing.
STD-A11Y-002 accessibility

Keyboard Focus Rings, Contrast Ratios, and Reduced Motion

# STD-A11Y-002: Keyboard Focus Rings, Contrast Ratios, and Reduced Motion

## 1. Abstract
Specifies visual accessibility standards including focus indicators, contrast minimums, and system preference responsiveness.
STD-CLIP-001 shell

Cross-Application Drag-and-Drop, Clipboard Data Interchange, and External File Ingestion

# STD-CLIP-001: Cross-Application Drag-and-Drop, Clipboard Data Interchange, and External File Ingestion

## 1. Abstract
As documented on [Craft Wiki: Place linked documents](https://craft.wiki/apps/vectorcraft/place-linked-documents/), users routinely copy and drag graphical assets, type, and documents between applications (e.g. copying paths from VectorCraft into PhotoCraft as smart vectors). This standard formalizes clipboard MIME types, drop targets, and cross-suite asset exchange.
STD-CMD-001 shell

Universal Application Command Taxonomy, CLI Flags, and Headless MCP Protocol

# STD-CMD-001: Universal Application Command Taxonomy, CLI Flags, and Headless MCP Protocol

## 1. Abstract
As documented on [Craft Wiki: Connect an AI Assistant](https://craft.wiki/apps/connect-ai/overview/), every ArtCraft application provides an autonomous CLI binary (`-cli`, such as `photocraft-cli`, `vectorcraft-cli`, `wordcraft-cli`) implementing the Model Context Protocol (MCP). This standard specifies uniform CLI invocation flags, headless vs windowed execution lifecycles, and a standardized core command ID taxonomy.
STD-COLOR-001 interaction

Universal Color Picker, Hex Parsing, and Color Space Proofing Ergonomics

# STD-COLOR-001: Universal Color Picker, Hex Parsing, and Color Space Proofing Ergonomics

## 1. Abstract
As documented on [Craft Wiki: Prepare artwork for CMYK print](https://craft.wiki/apps/vectorcraft/prepare-artwork-for-cmyk-print/), color manipulation across graphics and design apps must be consistent, color-space aware, and ergonomically rapid. This standard dictates color picker interaction gestures, hex code parsing resilience, and color management soft-proofing invariants.
STD-GOV-001 governance

Clean-Room Reverse Engineering, Patent Isolation, and Dependency License Allowlist Invariants

# STD-GOV-001: Clean-Room Reverse Engineering, Patent Isolation, and Dependency License Allowlist Invariants

## 1. Abstract
STD-GOV-002 governance

Contributor Issue Claims, Single-Concern Commits, and Pull Request Invariants

# STD-GOV-002: Contributor Issue Claims, Single-Concern Commits, and Pull Request Invariants

## 1. Abstract
STD-I18N-001 internationalization

Full Shell Direction Mirroring and Unicode BiDi Text Galley Shaping

# STD-I18N-001: Full Shell Direction Mirroring and Unicode BiDi Text Galley Shaping

## 1. Abstract
As documented on [Craft Wiki: Set right-to-left and Indic type](https://craft.wiki/apps/vectorcraft/set-right-to-left-and-indic-type/), Right-to-Left (RTL) scripts (Arabic, Hebrew, Persian, Urdu) require complete layout mirroring of the desktop shell, Indic typographic panel options, and bidirectional text shaping. This standard formalizes shell mirroring, typography options, and Unicode BiDi classification.
STD-I18N-002 internationalization

Locale-Aware Numeric Formatting, Decimal Separators, and Measurement Units

# STD-I18N-002: Locale-Aware Numeric Formatting, Decimal Separators, and Measurement Units

## 1. Abstract
Specifies input parsing and display formatting for numbers, percentages, dimensions, and measurement units across international locales.
STD-INPUT-001 interaction

Multi-Tool Toolbar Slot Cycling & Gesture Ergonomics

# STD-INPUT-001: Multi-Tool Toolbar Slot Cycling & Gesture Ergonomics

## 1. Abstract
In creative applications with nested tool slots (Photoshop, Illustrator, InDesign, After Effects), toolbar buttons often represent a group of tools. This standard specifies how users interact with multi-tool slot buttons via mouse clicks, hold gestures, and modifier keys.
STD-INPUT-002 interaction

Transient and Spring-Loaded Tool Invariants

# STD-INPUT-002: Transient and Spring-Loaded Tool Invariants

## 1. Abstract
Spring-loaded (transient) tools allow users to temporarily activate a navigation or inspection tool (such as Hand or Zoom) while another creative tool is active, returning immediately to the original tool upon releasing the key.
STD-INPUT-003 interaction

Canvas Pan, Zoom Physics, and Viewport Invariants

# STD-INPUT-003: Canvas Pan, Zoom Physics, and Viewport Invariants

## 1. Abstract
Specifies mouse wheel, pointer drag, and double-click behaviors for document canvas navigation.
STD-INPUT-004 interaction

Selection and Bounding Box Transform Modifiers

# STD-INPUT-004: Selection and Bounding Box Transform Modifiers

## 1. Abstract
Defines standard modifier behaviors when selecting, transforming, or duplicating objects and pixel selections on canvas.
STD-LIB-001 unified-libs

Universal Cross-Platform Printing and Prepress Pipeline

# STD-LIB-001: Universal Cross-Platform Printing and Prepress Pipeline

## 1. Abstract
Printing across desktop operating systems involves disparate backends: Windows GDI / XPS on Windows, CUPS on Linux and FreeBSD, and CoreGraphics/NSPrintOperation on macOS. This standard dictates that all ArtCraft applications must route document output through `craft-libs::craft-print` rather than writing platform-specific print code.
STD-LIB-002 unified-libs

Keymap Architecture, Platform Chord Normalization, and Overrides

# STD-LIB-002: Keymap Architecture, Platform Chord Normalization, and Overrides

## 1. Abstract
Specifies the canonical keymap representation used across ArtCraft applications via `craft-libs::craft-keymap`.
STD-LIB-003 unified-libs

UI Widget Primitives, Design Tokens, and Docking Systems

# STD-LIB-003: UI Widget Primitives, Design Tokens, and Docking Systems

## 1. Abstract
Specifies core UI component contracts provided by `craft-libs::craft-ui`.
STD-LIB-004 unified-libs

Host Font Discovery, On-Demand Activation & Fallback Rendering

# STD-LIB-004: Host Font Discovery, On-Demand Activation & Fallback Rendering

## 1. Abstract
STD-LIB-005 unified-libs

Invariant Testing, The Keep Rule & Hostile Input Sweeps

# STD-LIB-005: Invariant Testing, The Keep Rule & Hostile Input Sweeps

## 1. Abstract
STD-LIB-006 unified-libs

Universal GPU Device Lifecycle, Shader Caches & Fallbacks

# STD-LIB-006: Universal GPU Device Lifecycle, Shader Caches & Fallbacks

## 1. Abstract
STD-META-001 governance

Standard Specification Authoring, Machine Validation, and MCP Registry Invariants

# STD-META-001: Standard Specification Authoring, Machine Validation, and MCP Registry Invariants

## 1. Abstract
STD-NAV-001 navigation

Universal Document Tab Navigation, Closure, and Lifecycle Ergonomics

# STD-NAV-001: Universal Document Tab Navigation, Closure, and Lifecycle Ergonomics

## 1. Abstract
As documented on [Craft Wiki: Work in several windows](https://craft.wiki/apps/vectorcraft/work-in-several-windows/), power users manage dozens of active documents across tab strips. This standard specifies universal tab switching shortcuts, closing mechanics (`Ctrl+W`), tab reopening (`Ctrl+Shift+T`), pointer gestures (middle-click to close), and contextual menu actions across all ArtCraft applications.
STD-NAV-002 navigation

Workspace Panel Visibility and Dock Collapsing Toggles

# STD-NAV-002: Workspace Panel Visibility and Dock Collapsing Toggles

## 1. Abstract
Specifies global hotkeys for clearing the workspace to focus on the document canvas.
STD-NAV-003 navigation

Arrow-Key Value Scrubbing and Step Multipliers

# STD-NAV-003: Arrow-Key Value Scrubbing and Step Multipliers

## 1. Abstract
Specifies keyboard scrubbing rules for numeric input fields, sliders, and timeline position indicators.
STD-SHELL-001 shell

Modal and Modeless Dialog Lifecycles, Dismissal, and Button Orders

# STD-SHELL-001: Modal and Modeless Dialog Lifecycles, Dismissal, and Button Orders

## 1. Abstract
Specifies dialog behavior, keyboard escape mechanisms, and platform-compliant button ordering.
STD-SHELL-002 shell

Document Dirty State, Unsaved Changes Prompt, and Recovery Lifecycles

# STD-SHELL-002: Document Dirty State, Unsaved Changes Prompt, and Recovery Lifecycles

## 1. Abstract
As documented on [Craft Wiki: Document Recovery](https://craft.wiki/apps/wordcraft/recovery/), ArtCraft applications protect user work against system crashes or abnormal termination through dirty tracking, safe close confirmation, and local journal snapshots.
STD-SHELL-003 shell

Confined File Access, Sandboxing & Automation Root Isolation

# STD-SHELL-003: Confined File Access, Sandboxing & Automation Root Isolation

## 1. Abstract
STD-SHELL-004 shell

Cloud Document Synchronization, Delta Journal & Conflict Lifecycles

# STD-SHELL-004: Cloud Document Synchronization, Delta Journal & Conflict Lifecycles

## 1. Abstract
STD-TIME-001 navigation

Timeline Navigation, JKL Scrubbing, and Timecode Invariants

# STD-TIME-001: Timeline Navigation, JKL Scrubbing, and Timecode Invariants

## 1. Abstract
As documented on [Craft Wiki: The Timeline](https://craft.wiki/apps/anicraft/the-timeline/), video, motion graphics, and audio suites share fundamental temporal playback conventions. This standard defines universal keyboard scrubbing chords, frame stepping, and SMPTE timecode formatting across `FilmCraft`, `EffectCraft`, `AniCraft`, and `SoundCraft`.
Suite Architectural Verification · 20 Governed Apps v0.2.0 CI

ArtCraft Suite Compliance Telemetry

Architectural contracts, invariant verification, and AST drift telemetry across all 20+ Storytold monorepo applications. Filter by domain, inspect scorecards, or pivot by standard category.

95.8%
Suite Compliance Score
115 / 120
Verified Invariants
20 Apps
Governed in Storytold Monorepo
Active CI
Zero AST Drift Guarantee
Showing 20 applications
Contributor Knowledge Base & Architecture FAQ v0.2.0 Guide

Frequently Asked Questions & Contributor Guide

Everything 6,000+ contributors, maintainers, and autonomous AI agents need to know about ArtCraft architectural invariants, AutoCraft CI integration, and multi-app monorepo conventions.

Executive Overview & Architectural Whitepaper v0.2.0 Invariants

Introduction to ArtCraft Standards

Authoritative architectural contracts, ergonomic invariants, and autonomous AI agent governance unifying the 20+ ArtCraft Creative Suite desktop applications.

20+
Governed Desktop Apps
PhotoCraft, FilmCraft, CADCraft...
28
Active Standard Contracts
100% Machine-Executable Specs
100%
Zero AST Drift Guarantee
Automated Sentinel CI Gate
v0.2.0
AutoCraft MCP Stdio Protocol
Claude Code, Cursor & AutoCraft

🎯 The Mission: End Erroneous UI Fragmentation

Storytold develops over 20 creative, CAD, video, and productivity desktop applications in Rust. With over 6,000 contributors, independent development teams naturally solve common problems in subtly divergent ways: keymaps clash, dialog dismissals invert button orders, and timeline scrubbers behave unpredictably.

ArtCraft Standards (craft-standards) establishes an authoritative, contract-enforced foundation. Every application adheres to identical ergonomic muscle memory, AccessKit accessibility trees, BiDi spatial mirroring, and sandbox invariants—enforced automatically before any code can merge.

⚖️ Monorepo Transformation: Before vs. After

Capability Legacy Disjointed Monorepo Unified ArtCraft Standards (v0.2.0)
Tool Cycling & Hotkeys Each app re-invented hotkeys; frequent collisions between PhotoCraft and CADCraft. STD-INPUT-001: Universal [V, M, B] tool slot cycling and spring modifiers across all 20 apps.
Accessibility (AccessKit) Manual ad-hoc tagging; screen readers broken in timeline and canvas views. STD-A11Y-001: Mandatory AccessKit node hierarchy and 7:1 AAA contrast enforced via headless CI audits.
BiDi & RTL Mirroring Incomplete text-only translation; toolbars and timelines misaligned in Arabic/Hebrew. STD-I18N-001: Full shell spatial inversion with directional CSS properties and egui layout galley shaping.
File I/O Sandboxing Raw std::fs calls caused path traversal vulnerabilities and broke automated agents. STD-SHELL-003: Sandboxed craft_fs::AutomationRoot restricts I/O to explicitly mounted directories.
Autonomous AI Agents Agents hallucinated non-standard APIs; maintainers spent hours manually correcting PRs. AutoCraft MCP Gateway: Claude Code, Cursor, and AutoCraft query standard rules over stdio before emitting code.

🏛️ The 7 Architectural Pillars

01 · Interaction & Gestures

Slot cycling, spring tools, canvas physics, and 14-stop gradient color proofing.

02 · Navigation & Layout

Universal document tab switching, dock collapsing, arrow-key scrubs, and JKL timecodes.

03 · Accessibility (a11y)

Automated AccessKit tree audits, 7:1 AAA contrast ratios, keyboard rings, and reduced motion.

04 · Internationalization (i18n)

Full shell BiDi mirroring, Arabic/Hebrew typography, and locale-aware numeral formatting.

05 · Shell & Sandboxing

Clipboard interchange, dialog button hierarchies, dirty state recovery, and confined file access.

06 · Unified Shared Libs

Keymap normalization, widget primitives, host font activation, GPU lifecycles, and The Keep Rule.

07 · Governance & Licensing

Clean-room reverse engineering, patent isolation, contributor issue claiming, and machine-verified RFCs.

GitHub ↗
ACTIVE

Canonical Crate:
Governed Apps: