@vyaz/core 0.0.6 → 0.0.7

package/dist/compile/DocumentCompiler.d.ts

@@ -5,6 +5,9 @@
  * inline-box: text → \uFFFC, dimensions in metadata.inlineWidget.
  * super/sub: fontSize *= 0.65, baselineOffset in metadata.
  *
+ * splitParagraphByHardBreaks() — zero phase: splits a Paragraph into
+ * virtual Paragraph[] on \n boundaries (for pre, pre-line, pre-wrap).
+ *
  * Simple JSON-serialisable format — does not depend on pretext directly.
  */
 import type { Paragraph, TextRun } from '../types/Document.js';
@@ -30,10 +33,50 @@ export interface PreparedRichInlineItem {
         inlineWidget?: TextRun['inlineWidget'];
     };
 }
+/**
+ * Collapse consecutive collapsible whitespace → single space.
+ * Trim leading/trailing. CSS Text §4.1.1.
+ *
+ * Uses native regex (C++ in V8) instead of a manual JS loop.
+ */
+export declare function collapseSegmentWhitespace(segment: string): string;
+/**
+ * Split text on \n, collapse whitespace per segment (pre-line).
+ * Empty segments preserved (for \n\n → empty line).
+ *
+ * Three native calls: replace → split → map (trim).
+ * CSS Text §4.1.1 (pre-line): collapsing + segment break transformation.
+ */
+export declare function splitAndCollapseByHardBreaks(text: string): string[];
 /**
  * Compile a paragraph into PreparedRichInlineItem[].
  */
 export declare function compileParagraph(paragraph: Paragraph): PreparedRichInlineItem[];
+/**
+ * Zero phase: split a Paragraph into virtual Paragraph[] on \n boundaries.
+ *
+ * For `pre-line`: whitespace is collapsed per segment.
+ * For `pre`/`pre-wrap`: whitespace is preserved.
+ * For `normal`/`nowrap`/`undefined`: returns [paragraph] unchanged.
+ *
+ * Each \n produces an empty Paragraph (children: []) which the layout engine
+ * can fast-path as a hard-break line.
+ *
+ * Supports multi-run: when a run contains \n, the text after \n starts
+ * a new virtual paragraph. Runs after the split run belong to the new
+ * paragraph.
+ *
+ * @example
+ *   "Hello\nWorld" (pre-line)
+ *     → [{ children: [{ text: "Hello" }] }, { children: [{ text: "World" }] }]
+ *
+ *   "Hello\n\nWorld" (pre-line)
+ *     → [{ children: [{ text: "Hello" }] }, { children: [] }, { children: [{ text: "World" }] }]
+ *
+ *   ["Hello Bold", "\n", "World"] (pre)
+ *     → [{ children: [{ text: "Hello Bold" }] }, { children: [] }, { children: [{ text: "World" }] }]
+ */
+export declare function splitParagraphByHardBreaks(paragraph: Paragraph): Paragraph[];
 /**
  * Get the full text of a paragraph (for INDEX_CONSIST checks).
  */

package/dist/index.d.ts

@@ -20,7 +20,7 @@ export { groupLinesByParagraph } from './utils/groupLinesByParagraph.js';
 export type { ParagraphGroup } from './utils/groupLinesByParagraph.js';
 export { transformText } from './utils/textTransform.js';
 export { formatListNumber, defaultBulletChar, BULLET_CHARACTERS } from './utils/list.js';
-export { compileParagraph, getParagraphText, makeFontToken } from './compile/DocumentCompiler.js';
+export { compileParagraph, getParagraphText, makeFontToken, splitParagraphByHardBreaks, collapseSegmentWhitespace } from './compile/DocumentCompiler.js';
 export type { PreparedRichInlineItem } from './compile/DocumentCompiler.js';
 export type { FontFace } from './measure/FontEngine.js';
 export { createFontFace, getGlyphAdvance, computePixelMetrics, isFontEngineAvailable } from './measure/FontEngine.js';

package/dist/index.js

@@ -2,6 +2,7 @@
 export {
   transformText,
   systemFontRegistry,
+  splitParagraphByHardBreaks,
   positionLines,
   paragraphLayoutEngine,
   makeFontToken,
@@ -19,6 +20,7 @@ export {
   createFontFace,
   computePixelMetrics,
   compileParagraph,
+  collapseSegmentWhitespace,
   assertLineInvariants,
   applyScale,
   SystemFontRegistry,

package/dist/types/Document.d.ts

@@ -121,10 +121,15 @@ export type ScriptType = 'normal' | 'sub' | 'super';
  * CSS `white-space` equivalent.
  *
  * Controls how whitespace and line breaks are handled inside a paragraph.
+ * - `'normal'`: collapse whitespace, auto-wrap.
+ * - `'nowrap'`: collapse whitespace, no wrap.
+ * - `'pre'`: preserve whitespace, wrap on newline only.
+ * - `'pre-line'`: collapse whitespace, wrap on newline and auto-wrap.
+ * - `'pre-wrap'`: preserve whitespace, wrap on newline and auto-wrap.
  *
  * @see {@link https://www.w3.org/TR/css-text-3/#white-space-property | CSS Text: white-space}
  */
-export type WhiteSpace = 'normal' | 'nowrap' | 'pre';
+export type WhiteSpace = 'normal' | 'nowrap' | 'pre' | 'pre-line' | 'pre-wrap';
 /**
  * Type of list marker.
  *
@@ -409,6 +414,7 @@ export interface ParagraphStyle {
      * - `'normal'`: collapse whitespace, auto-wrap.
      * - `'nowrap'`: collapse whitespace, no wrap.
      * - `'pre'`: preserve whitespace, wrap on newline only.
+     * - `'pre-line'`: collapse whitespace, wrap on newline and auto-wrap.
      */
     whiteSpace?: WhiteSpace;
     /**

package/dist/types/LayoutTypes.d.ts

@@ -94,6 +94,15 @@ export interface Line {
     alignment?: TextAlignment;
     /** Column index (0-based) when frame has multi-column layout. */
     columnIndex?: number;
+    /**
+     * True when this line was created by a forced hard break (\n),
+     * as opposed to a soft wrap from line width exceeding maxWidth.
+     *
+     * Used by the editor to distinguish user-inserted line breaks
+     * from automatic wrapping (affects Home/End, arrow up/down,
+     * Backspace merging behaviour).
+     */
+    isHardBreak?: boolean;
     spans: Span[];
 }
 export interface ParagraphLayoutResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vyaz/core",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",