Ink Story Template v1.3.0

[1.3.0] - 2025-12-13

Breaking /!\

• Saves from previous versions are not compatible with v1.3.0 due to internal save format changes. Start a new game after updating.

Added

• Accessibility:

  • Keyboard shortcuts for choice selection (1-9, A-Z) and page scrolling (arrows, Page Up/Down, Home/End)
  • Keyboard shortcut help reference panel (ctrl-h or available through settings)
  • Screen reader support: ARIA landmarks, skip link, modal focus management, live regions for notifications, and accessible choice markup
  • Loading screen and dark mode flash prevention for smoother initial page load
  • Monospace font option now in settings menu
  • Saving and loading errors now display in a modal with explicit error tracing

• Ink Tags:

  • # CHOICE_NUMBERS: tag to configure choice numbering display (auto, on, off)
  • # IMAGE: now supports alignment, width, alt text, and caption options
  • # TONE: tag enables tone indicators on choices: define markers with # TONE: tagname icon and tag choices with # tagname. Players can toggle in Settings.
  • # STATBAR: variable tag for visual progress bars with support for custom ranges, labels, opposed pairs, and optional value clamping

• External functions (callable from Ink script):

  • String functions: UPPERCASE, LOWERCASE, CAPITALIZE, TRIM, LENGTH, CONTAINS, STARTS_WITH, ENDS_WITH, REPLACE, REPLACE_ALL
  • Math functions: ROUND, CLAMP, ABS, PERCENT
  • Fairmath functions: FAIRADD, FAIRSUB
  • Time functions: NOW, SECONDS_SINCE, MINUTES_SINCE, TIME_SINCE, FORMAT_DATE, FORMAT_TIME, FORMAT_DATETIME, OFFSET_DATE

• Customization:

  • custom.js and custom.css files for author customization without modifying core files

Changed

• Audio setting in settings menu now only appears if the story contains # AUDIO or # AUDIOLOOP tags
• Optimized font loading for faster page loads (LCP improved from 16s to 0.6s)
• Monochrome color palette for better accessibility and WCAG AA contrast compliance (accent colors can be added via custom.css)
• Inline links now display with underlines for accessibility
• Save exports now use a slugified version of the story title (from # TITLE: tag) as the filename prefix, making exported saves easier to identify

Fixed

• Saves made while viewing a special page now correctly restore to the main story
• Unknown tags now warn in the console (F12) instead of silently becoming CSS classes
• Modals display in full screen on small screens, with close buttons accessible without scrolling

Technical

• Migrated to ES modules with esbuild bundling
• Reorganized repository structure: moved source files to src/ directory
• Added automated unit testing (Vitest) and end-to-end testing (Playwright)