@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 2.1.0

package/src/writing/writingStyle.ts

@@ -1,217 +1,217 @@
-/**
- * Writing-style guidance for book generation and in-editor drafting.
- *
- * There are no built-in generic presets. Every style is authored and named by
- * the user. A style carries:
- *  - SOURCES: the author's own writing samples, mirrored for VOICE only and
- *    never lifted as content.
- *  - NOTES: free-text guidance the author writes themselves (their own rules).
- *  - SKILL: a compact, distilled style guide generated from the sources+notes
- *    (see condenseWritingStyleWithAgent). It is editable and, when enabled, is
- *    sent to the agent instead of the raw sources+notes to save tokens.
- *
- * Styles are saved app-wide (book app settings) and reused across book creation
- * and the editor drafter. Which styles apply is chosen per book / per draft.
- */
-
-export interface StyleSource {
-  id: string
-  label: string
-  text: string
-}
-
-export interface WritingStyle {
-  id: string
-  name: string
-  sources: StyleSource[]
-  notes: string
-  /** Words/phrases to prefer (whitelist). Free text — comma or newline separated. */
-  include: string
-  /** Words/phrases to avoid (blacklist). Free text — comma or newline separated. */
-  exclude: string
-  /** Distilled compact style guide; editable. Empty until distilled. */
-  skill: string
-  /** When true and a skill exists, the skill is used instead of raw sources. */
-  skillEnabled: boolean
-}
-
-export interface BookWritingStyle {
-  styles: WritingStyle[]
-}
-
-export const EMPTY_WRITING_STYLE: BookWritingStyle = { styles: [] }
-
-function randomId(prefix: string): string {
-  return `${prefix}-${Math.random().toString(36).slice(2)}-${Date.now()}`
-}
-
-export function createWritingStyle(name = 'New style'): WritingStyle {
-  return {
-    id: randomId('style'),
-    name,
-    sources: [],
-    notes: '',
-    include: '',
-    exclude: '',
-    skill: '',
-    skillEnabled: false,
-  }
-}
-
-export function createStyleSource(label = 'Sample'): StyleSource {
-  return { id: randomId('src'), label, text: '' }
-}
-
-function coerceSource(item: unknown): StyleSource | null {
-  if (!item || typeof item !== 'object') return null
-  const entry = item as Record<string, unknown>
-  const text = typeof entry.text === 'string' ? entry.text : ''
-  return {
-    id: typeof entry.id === 'string' && entry.id ? entry.id : randomId('src'),
-    label:
-      typeof entry.label === 'string' && entry.label.trim()
-        ? entry.label.trim()
-        : 'Sample',
-    text,
-  }
-}
-
-function coerceStyle(item: unknown): WritingStyle | null {
-  if (!item || typeof item !== 'object') return null
-  const entry = item as Record<string, unknown>
-
-  // Current shape: a style with its own sources.
-  let sources = Array.isArray(entry.sources)
-    ? entry.sources
-        .map(coerceSource)
-        .filter((source): source is StyleSource => source !== null)
-    : []
-
-  // Legacy migration: a flat StyleExample { label, text } becomes one source.
-  if (sources.length === 0 && typeof entry.text === 'string' && entry.text.trim()) {
-    sources = [
-      {
-        id: typeof entry.id === 'string' && entry.id ? entry.id : randomId('src'),
-        label:
-          typeof entry.label === 'string' && entry.label.trim()
-            ? entry.label.trim()
-            : 'Sample',
-        text: entry.text,
-      },
-    ]
-  }
-
-  const name =
-    typeof entry.name === 'string' && entry.name.trim()
-      ? entry.name.trim()
-      : typeof entry.label === 'string' && entry.label.trim()
-        ? entry.label.trim()
-        : 'Untitled style'
-  const notes = typeof entry.notes === 'string' ? entry.notes : ''
-  const include = typeof entry.include === 'string' ? entry.include : ''
-  const exclude = typeof entry.exclude === 'string' ? entry.exclude : ''
-  const skill = typeof entry.skill === 'string' ? entry.skill : ''
-
-  // Keep a style only if it has something to say.
-  if (
-    sources.length === 0 &&
-    !notes.trim() &&
-    !include.trim() &&
-    !exclude.trim() &&
-    !skill.trim()
-  ) {
-    return null
-  }
-
-  return {
-    id: typeof entry.id === 'string' && entry.id ? entry.id : randomId('style'),
-    name,
-    sources,
-    notes,
-    include,
-    exclude,
-    skill,
-    skillEnabled: entry.skillEnabled === true && skill.trim().length > 0,
-  }
-}
-
-export function normalizeWritingStyle(value: unknown): BookWritingStyle {
-  const record =
-    value && typeof value === 'object' ? (value as Record<string, unknown>) : {}
-  // Current shape: { styles }. Legacy shape: { presets, examples }.
-  const source = Array.isArray(record.styles)
-    ? record.styles
-    : Array.isArray(record.examples)
-      ? record.examples
-      : []
-  const styles = source
-    .map(coerceStyle)
-    .filter((style): style is WritingStyle => style !== null)
-  return { styles }
-}
-
-/**
- * Raw guidance for ONE style: the author's notes plus their voice samples,
- * explicitly marked voice-only. Used both as the distillation input and as the
- * applied guidance when no skill is enabled.
- */
-export function styleRawGuidance(style: WritingStyle): string {
-  const lines: string[] = []
-  if (style.notes.trim()) lines.push(`Guidance: ${style.notes.trim()}`)
-  if (style.include.trim()) {
-    lines.push(
-      `Prefer these words and phrases where they fit naturally: ${normalizeWordList(style.include)}.`,
-    )
-  }
-  if (style.exclude.trim()) {
-    lines.push(`Avoid these words and phrases entirely: ${normalizeWordList(style.exclude)}.`)
-  }
-  const samples = style.sources
-    .map(source => source.text.trim())
-    .filter(Boolean)
-  if (samples.length > 0) {
-    lines.push(
-      'Match the VOICE of these writing samples — sentence rhythm, tone, and word choice only. Do NOT reuse their wording, facts, or subject matter as content:',
-    )
-    samples.forEach((text, index) => {
-      lines.push(`Sample ${index + 1}: """${text.slice(0, 1200)}"""`)
-    })
-  }
-  return lines.join('\n')
-}
-
-/** Flatten a comma/newline-separated word list into a single comma-separated line. */
-function normalizeWordList(value: string): string {
-  return value
-    .split(/[\n,]/)
-    .map(word => word.trim())
-    .filter(Boolean)
-    .join(', ')
-}
-
-/** True when a style contributes anything to the prompt. */
-export function styleHasContent(style: WritingStyle): boolean {
-  return (
-    style.skill.trim().length > 0 ||
-    style.notes.trim().length > 0 ||
-    style.include.trim().length > 0 ||
-    style.exclude.trim().length > 0 ||
-    style.sources.some(source => source.text.trim().length > 0)
-  )
-}
-
-/**
- * Build the style-guidance prompt block from the SELECTED styles. For each
- * style, prefer its distilled skill when enabled; otherwise fall back to the
- * raw notes + voice samples.
- */
-export function buildStyleGuidance(styles: WritingStyle[]): string | undefined {
-  const blocks: string[] = []
-  styles.forEach(style => {
-    const useSkill = style.skillEnabled && style.skill.trim().length > 0
-    const body = useSkill ? style.skill.trim() : styleRawGuidance(style)
-    if (body.trim()) blocks.push(`Style — ${style.name}:\n${body.trim()}`)
-  })
-  if (blocks.length === 0) return undefined
-  return ['Writing style guidance:', ...blocks].join('\n\n')
-}
+/**
+ * Writing-style guidance for book generation and in-editor drafting.
+ *
+ * There are no built-in generic presets. Every style is authored and named by
+ * the user. A style carries:
+ *  - SOURCES: the author's own writing samples, mirrored for VOICE only and
+ *    never lifted as content.
+ *  - NOTES: free-text guidance the author writes themselves (their own rules).
+ *  - SKILL: a compact, distilled style guide generated from the sources+notes
+ *    (see condenseWritingStyleWithAgent). It is editable and, when enabled, is
+ *    sent to the agent instead of the raw sources+notes to save tokens.
+ *
+ * Styles are saved app-wide (book app settings) and reused across book creation
+ * and the editor drafter. Which styles apply is chosen per book / per draft.
+ */
+
+export interface StyleSource {
+  id: string
+  label: string
+  text: string
+}
+
+export interface WritingStyle {
+  id: string
+  name: string
+  sources: StyleSource[]
+  notes: string
+  /** Words/phrases to prefer (whitelist). Free text — comma or newline separated. */
+  include: string
+  /** Words/phrases to avoid (blacklist). Free text — comma or newline separated. */
+  exclude: string
+  /** Distilled compact style guide; editable. Empty until distilled. */
+  skill: string
+  /** When true and a skill exists, the skill is used instead of raw sources. */
+  skillEnabled: boolean
+}
+
+export interface BookWritingStyle {
+  styles: WritingStyle[]
+}
+
+export const EMPTY_WRITING_STYLE: BookWritingStyle = { styles: [] }
+
+function randomId(prefix: string): string {
+  return `${prefix}-${Math.random().toString(36).slice(2)}-${Date.now()}`
+}
+
+export function createWritingStyle(name = 'New style'): WritingStyle {
+  return {
+    id: randomId('style'),
+    name,
+    sources: [],
+    notes: '',
+    include: '',
+    exclude: '',
+    skill: '',
+    skillEnabled: false,
+  }
+}
+
+export function createStyleSource(label = 'Sample'): StyleSource {
+  return { id: randomId('src'), label, text: '' }
+}
+
+function coerceSource(item: unknown): StyleSource | null {
+  if (!item || typeof item !== 'object') return null
+  const entry = item as Record<string, unknown>
+  const text = typeof entry.text === 'string' ? entry.text : ''
+  return {
+    id: typeof entry.id === 'string' && entry.id ? entry.id : randomId('src'),
+    label:
+      typeof entry.label === 'string' && entry.label.trim()
+        ? entry.label.trim()
+        : 'Sample',
+    text,
+  }
+}
+
+function coerceStyle(item: unknown): WritingStyle | null {
+  if (!item || typeof item !== 'object') return null
+  const entry = item as Record<string, unknown>
+
+  // Current shape: a style with its own sources.
+  let sources = Array.isArray(entry.sources)
+    ? entry.sources
+        .map(coerceSource)
+        .filter((source): source is StyleSource => source !== null)
+    : []
+
+  // Legacy migration: a flat StyleExample { label, text } becomes one source.
+  if (sources.length === 0 && typeof entry.text === 'string' && entry.text.trim()) {
+    sources = [
+      {
+        id: typeof entry.id === 'string' && entry.id ? entry.id : randomId('src'),
+        label:
+          typeof entry.label === 'string' && entry.label.trim()
+            ? entry.label.trim()
+            : 'Sample',
+        text: entry.text,
+      },
+    ]
+  }
+
+  const name =
+    typeof entry.name === 'string' && entry.name.trim()
+      ? entry.name.trim()
+      : typeof entry.label === 'string' && entry.label.trim()
+        ? entry.label.trim()
+        : 'Untitled style'
+  const notes = typeof entry.notes === 'string' ? entry.notes : ''
+  const include = typeof entry.include === 'string' ? entry.include : ''
+  const exclude = typeof entry.exclude === 'string' ? entry.exclude : ''
+  const skill = typeof entry.skill === 'string' ? entry.skill : ''
+
+  // Keep a style only if it has something to say.
+  if (
+    sources.length === 0 &&
+    !notes.trim() &&
+    !include.trim() &&
+    !exclude.trim() &&
+    !skill.trim()
+  ) {
+    return null
+  }
+
+  return {
+    id: typeof entry.id === 'string' && entry.id ? entry.id : randomId('style'),
+    name,
+    sources,
+    notes,
+    include,
+    exclude,
+    skill,
+    skillEnabled: entry.skillEnabled === true && skill.trim().length > 0,
+  }
+}
+
+export function normalizeWritingStyle(value: unknown): BookWritingStyle {
+  const record =
+    value && typeof value === 'object' ? (value as Record<string, unknown>) : {}
+  // Current shape: { styles }. Legacy shape: { presets, examples }.
+  const source = Array.isArray(record.styles)
+    ? record.styles
+    : Array.isArray(record.examples)
+      ? record.examples
+      : []
+  const styles = source
+    .map(coerceStyle)
+    .filter((style): style is WritingStyle => style !== null)
+  return { styles }
+}
+
+/**
+ * Raw guidance for ONE style: the author's notes plus their voice samples,
+ * explicitly marked voice-only. Used both as the distillation input and as the
+ * applied guidance when no skill is enabled.
+ */
+export function styleRawGuidance(style: WritingStyle): string {
+  const lines: string[] = []
+  if (style.notes.trim()) lines.push(`Guidance: ${style.notes.trim()}`)
+  if (style.include.trim()) {
+    lines.push(
+      `Prefer these words and phrases where they fit naturally: ${normalizeWordList(style.include)}.`,
+    )
+  }
+  if (style.exclude.trim()) {
+    lines.push(`Avoid these words and phrases entirely: ${normalizeWordList(style.exclude)}.`)
+  }
+  const samples = style.sources
+    .map(source => source.text.trim())
+    .filter(Boolean)
+  if (samples.length > 0) {
+    lines.push(
+      'Match the VOICE of these writing samples — sentence rhythm, tone, and word choice only. Do NOT reuse their wording, facts, or subject matter as content:',
+    )
+    samples.forEach((text, index) => {
+      lines.push(`Sample ${index + 1}: """${text.slice(0, 1200)}"""`)
+    })
+  }
+  return lines.join('\n')
+}
+
+/** Flatten a comma/newline-separated word list into a single comma-separated line. */
+function normalizeWordList(value: string): string {
+  return value
+    .split(/[\n,]/)
+    .map(word => word.trim())
+    .filter(Boolean)
+    .join(', ')
+}
+
+/** True when a style contributes anything to the prompt. */
+export function styleHasContent(style: WritingStyle): boolean {
+  return (
+    style.skill.trim().length > 0 ||
+    style.notes.trim().length > 0 ||
+    style.include.trim().length > 0 ||
+    style.exclude.trim().length > 0 ||
+    style.sources.some(source => source.text.trim().length > 0)
+  )
+}
+
+/**
+ * Build the style-guidance prompt block from the SELECTED styles. For each
+ * style, prefer its distilled skill when enabled; otherwise fall back to the
+ * raw notes + voice samples.
+ */
+export function buildStyleGuidance(styles: WritingStyle[]): string | undefined {
+  const blocks: string[] = []
+  styles.forEach(style => {
+    const useSkill = style.skillEnabled && style.skill.trim().length > 0
+    const body = useSkill ? style.skill.trim() : styleRawGuidance(style)
+    if (body.trim()) blocks.push(`Style — ${style.name}:\n${body.trim()}`)
+  })
+  if (blocks.length === 0) return undefined
+  return ['Writing style guidance:', ...blocks].join('\n\n')
+}