@sutrata/editor 0.1.0

package/src/styles/script-ranges.ts

@@ -0,0 +1,17 @@
+/** Unicode block ranges for the complex scripts Sutrata recognizes, keyed by the same
+ *  lang codes used throughout (docx-exporter.ts's SCRIPT_FONT_BY_LANG, types.ts's
+ *  COMPLEX_SCRIPT_CODES, complexScriptFontOverrides / italicScripts). Shared so
+ *  docx-exporter.ts (font override) and workflow-reports.ts (forced-italic wrapping in the
+ *  print/PDF HTML) test the same ranges rather than maintaining two copies that could drift. */
+export const SCRIPT_UNICODE_RANGES: Record<string, RegExp> = {
+  hi: /[ऀ-ॿ]/,
+  ta: /[஀-௿]/,
+  te: /[ఀ-౿]/,
+  kn: /[ಀ-೿]/,
+  ml: /[ഀ-ൿ]/,
+  bn: /[ঀ-৿]/,
+  gu: /[઀-૿]/,
+  pa: /[਀-੿]/,
+  or: /[଀-୿]/,
+  si: /[඀-෿]/,
+}

package/src/styles/types.ts

@@ -0,0 +1,104 @@
+/** Screenplay body elements that carry a visual style — one entry per docx-exporter.ts
+ *  paragraph style / screenplay.css class. Excludes structural/chrome things
+ *  (scene metadata, page breaks, parenthetical parens) that aren't stylistic choices. */
+export const BODY_ELEMENT_KEYS = [
+  'sceneHeading', 'action', 'character', 'parenthetical', 'dialogue',
+  'transition', 'centered', 'lyrics', 'section', 'note', 'comment',
+] as const
+export type BodyElementKey = typeof BODY_ELEMENT_KEYS[number]
+
+/** Cover-page elements. Export-only (DOCX/PDF) — there is no live editor
+ *  preview of the cover page today, so these never produce editor CSS vars. */
+export const COVER_ELEMENT_KEYS = ['title', 'author', 'logline'] as const
+export type CoverElementKey = typeof COVER_ELEMENT_KEYS[number]
+
+export interface ElementStyle {
+  fontSizePt: number
+  bold?: boolean
+  italic?: boolean
+  underline?: boolean
+  /** 6 hex digits, no leading '#' (docx-native shape; CSS adapter adds the '#'). */
+  color?: string
+  /** Percentage of the printable content width. */
+  marginLeftPct?: number
+  marginRightPct?: number
+  align?: 'left' | 'center' | 'right'
+  /** Space before/after the paragraph, in points. DOCX-only: the live editor
+   *  only ever applies `spaceBeforePt` (as margin-top); adjacent elements in
+   *  the editor create their gap from the *following* element's margin-top,
+   *  not from a margin-bottom on the preceding one, so `spaceAfterPt` has no
+   *  editor-CSS effect — see css-adapter.ts. */
+  spaceBeforePt?: number
+  spaceAfterPt?: number
+}
+
+export type ScreenplayElements =
+  Record<BodyElementKey, ElementStyle> & Record<CoverElementKey, ElementStyle>
+
+/** How the exported cover page arranges its blocks (DOCX + PDF; there is no editor
+ *  preview of the cover). 'centered' stacks everything down the middle of the page;
+ *  'corners' puts title / "by <author>" / logline flush top-left and date + contact
+ *  down in the bottom-right, the arrangement Tamil shooting scripts print. Per-element
+ *  font/size/color still come from `elements.title|author|logline` either way — this
+ *  chooses the *placement* those elements are laid out in, nothing else. */
+export type CoverLayout = 'centered' | 'corners'
+export const COVER_LAYOUTS: readonly CoverLayout[] = ['centered', 'corners']
+export const DEFAULT_COVER_LAYOUT: CoverLayout = 'centered'
+
+export interface ScreenplayStyleDefinition {
+  /** Stable slug: persisted in frontmatter's `style:` field and as the IndexedDB key. */
+  id: string
+  name: string
+  description?: string
+  /** Latin body font. For the live editor and PDF/print export this is just the
+   *  first entry in a CSS font stack (screenplay.css / print-adapter.ts put
+   *  'Noto Sans'/script-specific Noto Sans fonts after it), so the browser's own
+   *  per-glyph fallback transparently covers any script this font doesn't have —
+   *  no per-style CSS plumbing needed. DOCX has no such per-glyph fallback
+   *  (a `w:rFonts` run property names exactly one font), so a style whose body
+   *  font *does* cover a non-Latin script it cares about (e.g. Traditional's
+   *  Vijaya for Tamil) must say so explicitly via `complexScriptFontOverrides`. */
+  fontFamily: string
+  /** Per-script font override, keyed by the same lang codes docx-exporter.ts's
+   *  getComplexFont switches on ('ta', 'hi', 'te', ...). Omit a script and it keeps
+   *  using the shared default (e.g. 'Noto Sans Tamil') — this is an opt-in exception,
+   *  not a requirement to theme every script. Consumed by all three renderers:
+   *  DOCX (docx-exporter.ts, where it's required — a `w:rFonts` run property names
+   *  exactly one font, so there's no per-glyph fallback to lean on), the live editor
+   *  (css-adapter.ts turns each entry into a `--cs-lang-<code>-font-family` CSS var
+   *  that screenplay.css's `.cs-lang-<code>` rules prefer over the generic Noto Sans
+   *  fallback), and PDF/print (print-adapter.ts folds the values into the body font
+   *  stack ahead of the generic Indic fallbacks). */
+  complexScriptFontOverrides?: Record<string, string>
+  /** Lang codes (same set as above) whose *default* presentation is italic under this
+   *  style — not "emphasized text happens to be italic", but "upright is not this
+   *  script's normal look here" (e.g. Traditional's Tamil, styled after Noto Serif
+   *  Tamil Italic to approximate Vijaya's slant). Forces italic even where the
+   *  element itself isn't (bold scene headings included) — confirmed as the intended
+   *  behavior, not layered underneath per-element italic. DOCX applies this
+   *  unconditionally per run; the editor applies it via a `.cs-force-italic-<code>`
+   *  class (see EditorView.tsx/css-adapter.ts) rather than a plain CSS var, because a
+   *  var would unconditionally set `font-style` and stomp elements that are
+   *  legitimately italic for their own reasons (lyrics, comments) on styles that
+   *  don't list the script here. PDF/print has no per-span language tagging, so this
+   *  has no effect there — a known, documented gap, not an oversight. */
+  italicScripts?: string[]
+  /** Defaults to DEFAULT_COVER_LAYOUT when a style (or an imported one) omits it. */
+  coverLayout?: CoverLayout
+  page: {
+    marginTopIn: number
+    marginBottomIn: number
+    marginLeftIn: number
+    marginRightIn: number
+  }
+  elements: ScreenplayElements
+}
+
+export const DEFAULT_STYLE_ID = 'classic'
+
+/** Lang codes docx-exporter.ts's getComplexFont / SCRIPT_RANGES recognize — the full
+ *  key space for `complexScriptFontOverrides` / `italicScripts`. Iterated by
+ *  css-adapter.ts to clear a previous style's per-script vars/classes when switching
+ *  to a style that doesn't set them (so nothing lingers). */
+export const COMPLEX_SCRIPT_CODES = ['hi', 'ta', 'te', 'kn', 'ml', 'bn', 'gu', 'pa', 'or', 'si'] as const
+export type ComplexScriptCode = typeof COMPLEX_SCRIPT_CODES[number]

package/src/styles/validate.ts

@@ -0,0 +1,114 @@
+import { BODY_ELEMENT_KEYS, COVER_ELEMENT_KEYS, COVER_LAYOUTS } from './types.js'
+import type { ScreenplayStyleDefinition } from './types.js'
+
+export type ValidationResult =
+  | { ok: true; style: ScreenplayStyleDefinition }
+  | { ok: false; errors: string[] }
+
+const ALIGNS = new Set(['left', 'center', 'right'])
+const COLOR_RE = /^[0-9a-fA-F]{6}$/
+
+function isFiniteNumber(v: unknown): v is number {
+  return typeof v === 'number' && Number.isFinite(v)
+}
+
+function validateElement(path: string, data: unknown, errors: string[]): void {
+  if (typeof data !== 'object' || data === null) {
+    errors.push(`${path}: expected an object`)
+    return
+  }
+  const el = data as Record<string, unknown>
+  if (!isFiniteNumber(el['fontSizePt']) || el['fontSizePt'] <= 0) {
+    errors.push(`${path}.fontSizePt: expected a positive number`)
+  }
+  for (const flag of ['bold', 'italic', 'underline'] as const) {
+    if (el[flag] !== undefined && typeof el[flag] !== 'boolean') {
+      errors.push(`${path}.${flag}: expected a boolean`)
+    }
+  }
+  if (el['color'] !== undefined && (typeof el['color'] !== 'string' || !COLOR_RE.test(el['color']))) {
+    errors.push(`${path}.color: expected 6 hex digits with no '#' (e.g. "0A5C6A")`)
+  }
+  for (const marginKey of ['marginLeftPct', 'marginRightPct'] as const) {
+    const v = el[marginKey]
+    if (v !== undefined && (!isFiniteNumber(v) || v < 0 || v > 100)) {
+      errors.push(`${path}.${marginKey}: expected a number between 0 and 100`)
+    }
+  }
+  if (el['align'] !== undefined && (typeof el['align'] !== 'string' || !ALIGNS.has(el['align']))) {
+    errors.push(`${path}.align: expected "left", "center", or "right"`)
+  }
+  for (const spaceKey of ['spaceBeforePt', 'spaceAfterPt'] as const) {
+    const v = el[spaceKey]
+    if (v !== undefined && !isFiniteNumber(v)) {
+      errors.push(`${path}.${spaceKey}: expected a number`)
+    }
+  }
+}
+
+/** Hand-rolled structural validation for a style imported from a .json file — no schema
+ *  library dependency, matching the codebase's other hand-rolled parsers (frontmatter.ts).
+ *  Collects every error found rather than failing on the first, for a useful import message. */
+export function validateStyleJson(data: unknown): ValidationResult {
+  const errors: string[] = []
+  if (typeof data !== 'object' || data === null) {
+    return { ok: false, errors: ['Expected a JSON object'] }
+  }
+  const obj = data as Record<string, unknown>
+
+  for (const key of ['id', 'name', 'fontFamily'] as const) {
+    if (typeof obj[key] !== 'string' || obj[key] === '') {
+      errors.push(`${key}: expected a non-empty string`)
+    }
+  }
+  if (obj['description'] !== undefined && typeof obj['description'] !== 'string') {
+    errors.push('description: expected a string')
+  }
+  if (obj['complexScriptFontOverrides'] !== undefined) {
+    const overrides = obj['complexScriptFontOverrides']
+    if (typeof overrides !== 'object' || overrides === null) {
+      errors.push('complexScriptFontOverrides: expected an object')
+    } else if (Object.values(overrides).some(v => typeof v !== 'string' || v === '')) {
+      errors.push('complexScriptFontOverrides: expected every value to be a non-empty string')
+    }
+  }
+  if (obj['italicScripts'] !== undefined) {
+    const scripts = obj['italicScripts']
+    if (!Array.isArray(scripts) || scripts.some(v => typeof v !== 'string' || v === '')) {
+      errors.push('italicScripts: expected an array of non-empty strings')
+    }
+  }
+
+  if (obj['coverLayout'] !== undefined && !COVER_LAYOUTS.includes(obj['coverLayout'] as never)) {
+    errors.push(`coverLayout: expected ${COVER_LAYOUTS.map(l => `"${l}"`).join(' or ')}`)
+  }
+
+  const page = obj['page']
+  if (typeof page !== 'object' || page === null) {
+    errors.push('page: expected an object')
+  } else {
+    const p = page as Record<string, unknown>
+    for (const key of ['marginTopIn', 'marginBottomIn', 'marginLeftIn', 'marginRightIn'] as const) {
+      if (!isFiniteNumber(p[key]) || p[key] < 0) {
+        errors.push(`page.${key}: expected a non-negative number`)
+      }
+    }
+  }
+
+  const elements = obj['elements']
+  if (typeof elements !== 'object' || elements === null) {
+    errors.push('elements: expected an object')
+  } else {
+    const el = elements as Record<string, unknown>
+    for (const key of [...BODY_ELEMENT_KEYS, ...COVER_ELEMENT_KEYS]) {
+      if (!(key in el)) {
+        errors.push(`elements.${key}: missing`)
+      } else {
+        validateElement(`elements.${key}`, el[key], errors)
+      }
+    }
+  }
+
+  if (errors.length > 0) return { ok: false, errors }
+  return { ok: true, style: obj as unknown as ScreenplayStyleDefinition }
+}

package/src/templates/templates.ts

@@ -0,0 +1,194 @@
+/**
+ * Localized screenplay templates for each supported script.
+ * Returns a starter Sutra document in the target language.
+ */
+
+export const TEMPLATES: Record<string, string> = {
+  en: `---
+title: Untitled Screenplay
+lang: en
+---
+
+## INT. ROOM - DAY
+
+A writer sits at a desk, staring at a blank screen.
+
+@WRITER
+(to themselves)
+Where do I begin?
+
+`,
+
+  hi: `---
+title: अनाम पटकथा
+lang: hi
+---
+
+## आंत. कमरा - दिन
+
+एक लेखक मेज पर बैठा है, खाली स्क्रीन को देख रहा है।
+
+@लेखक
+(खुद से)
+मैं कहाँ से शुरू करूँ?
+
+`,
+
+  ta: `---
+title: தலைப்பற்ற திரைக்கதை
+lang: ta
+---
+
+## உள்ளே. அறை - பகல்
+
+ஒரு எழுத்தாளர் மேசையில் அமர்ந்து, வெற்று திரையை பார்க்கிறார்.
+
+@எழுத்தாளர்
+(தனக்கே)
+நான் எங்கிருந்து தொடங்குவது?
+
+`,
+
+  te: `---
+title: పేరులేని స్క్రీన్‌ప్లే
+lang: te
+---
+
+## లోపల. గది - పగలు
+
+ఒక రచయిత బల్లదగ్గర కూర్చుని, ఖాళీ స్క్రీన్‌ని చూస్తున్నారు.
+
+@రచయిత
+(తమలో తాము)
+నేను ఎక్కడ నుండి ప్రారంభించాలి?
+
+`,
+
+  kn: `---
+title: ಹೆಸರಿಲ್ಲದ ಚಲನಚಿತ್ರ ಕಥೆ
+lang: kn
+---
+
+## ಒಳಗೆ. ಕೋಣೆ - ಹಗಲು
+
+ಒಬ್ಬ ಬರಹಗಾರ ಮೇಜಿನ ಬಳಿ ಕುಳಿತು, ಖಾಲಿ ಪರದೆಯನ್ನು ನೋಡುತ್ತಿದ್ದಾರೆ.
+
+@ಬರಹಗಾರ
+(ತಮ್ಮಷ್ಟಕ್ಕೆ)
+ನಾನು ಎಲ್ಲಿಂದ ಪ್ರಾರಂಭಿಸಲಿ?
+
+`,
+
+  ml: `---
+title: പേരില്ലാത്ത തിരക്കഥ
+lang: ml
+---
+
+## അകത്ത്. മുറി - പകൽ
+
+ഒരു എഴുത്തുകാരൻ മേശയ്ക്കരുകിൽ ഇരുന്ന്, ശൂന്യമായ സ്ക്രീൻ നോക്കുന്നു.
+
+@എഴുത്തുകാരൻ
+(സ്വയം)
+ഞാൻ എവിടെ നിന്ന് തുടങ്ങണം?
+
+`,
+
+  bn: `---
+title: নামহীন চিত্রনাট্য
+lang: bn
+---
+
+## ভেতরে. ঘর - দিন
+
+একজন লেখক টেবিলের পাশে বসে, ফাঁকা পর্দার দিকে তাকিয়ে আছেন।
+
+@লেখক
+(নিজের মনে)
+আমি কোথা থেকে শুরু করব?
+
+`,
+
+  gu: `---
+title: અનામ પટકથા
+lang: gu
+---
+
+## અંદર. ઓરડો - દિવસ
+
+એક લેખક ટેબલ પર બેઠો છે, ખાલી સ્ક્રીન જોઈ રહ્યો છે.
+
+@લેખક
+(પોતાની જાતને)
+હું ક્યાંથી શરૂ કરું?
+
+`,
+
+  mr: `---
+title: अनाम पटकथा
+lang: mr
+---
+
+## आत. खोली - दिवस
+
+एक लेखक टेबलावर बसला आहे, रिकाम्या स्क्रीनकडे पाहत आहे.
+
+@लेखक
+(स्वतःशी)
+मी कुठून सुरुवात करू?
+
+`,
+
+  pa: `---
+title: ਬੇਨਾਮ ਸਕ੍ਰੀਨਪਲੇ
+lang: pa
+---
+
+## ਅੰਦਰ. ਕਮਰਾ - ਦਿਨ
+
+ਇੱਕ ਲੇਖਕ ਮੇਜ਼ ਕੋਲ ਬੈਠਾ ਹੈ, ਖਾਲੀ ਸਕ੍ਰੀਨ ਵੱਲ ਦੇਖ ਰਿਹਾ ਹੈ।
+
+@ਲੇਖਕ
+(ਆਪਣੇ ਆਪ ਨੂੰ)
+ਮੈਂ ਕਿੱਥੋਂ ਸ਼ੁਰੂ ਕਰਾਂ?
+
+`,
+
+  or: `---
+title: ଅନାମ ଚଳଚ୍ଚିତ୍ର ଲିପି
+lang: or
+---
+
+## ଭିତର. କୋଠରୀ - ଦିନ
+
+ଜଣେ ଲେଖକ ଟେବୁଲ ପାଖରେ ବସି, ଖାଲି ସ୍କ୍ରୀନ ଆଡ଼କୁ ଚାହିଁ ରହିଛନ୍ତି।
+
+@ଲେଖକ
+(ନିଜ ମନରେ)
+ମୁଁ କୁଆଡ଼ୁ ଆରମ୍ଭ କରିବି?
+
+`,
+
+  si: `---
+title: නම් නොකළ තිර රචනය
+lang: si
+---
+
+## ඇතුළත. කාමරය - දවල්
+
+ලේඛකයෙක් මේසයක් ළඟ වාඩි වී, හිස් තිරයක් දෙස බලා සිටියි.
+
+@ලේඛකයා
+(තමන්ටම)
+මම කොහෙන්ද පටන් ගන්නේ?
+
+`,
+}
+
+/**
+ * Get the starter template for a given language code.
+ * Falls back to English if no template for the requested language.
+ */
+export function getTemplate(lang: string): string {
+  return TEMPLATES[lang] ?? TEMPLATES['en'] ?? ''
+}