@sutrata/editor 0.1.1 → 0.2.0

package/src/styles/script-ranges.ts

@@ -1,17 +0,0 @@
-/** 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

@@ -1,104 +0,0 @@
-/** 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

@@ -1,114 +0,0 @@
-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

@@ -1,194 +0,0 @@
-/**
- * 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'] ?? ''
-}