narraleaf-react 0.28.0 → 0.29.0

package/dist/game/player/lib/verticalText.d.ts

@@ -5,9 +5,9 @@
  * top to bottom, and the next column starts to the left. Two things in that layout are not free,
  * and both are about text that is not Japanese:
  *
- * - A Latin word must stay whole. `word-break: break-all`, which the horizontal renderer wants so
- *   that CJK wraps anywhere, will otherwise split "Prologue" across two columns, one glyph at a
- *   time, sideways.
+ * - A Latin word must stay whole. `word-break: break-all` would split "Prologue" across two
+ *   columns, one glyph at a time, sideways. Neither writing mode needs it: `normal` already breaks
+ *   between CJK characters, which is the only place either one has to break.
  * - A short run - a two-digit number, an initialism - reads better set upright across the column
  *   than laid on its side. That is tate-chu-yoko (縦中横), and CSS spells it
  *   `text-combine-upright: all` on a wrapper around exactly that run.
@@ -43,12 +43,30 @@ export type VerticalTextSegment = {
  */
 export declare function segmentVerticalText(text: string, maxLength: number): VerticalTextSegment[];
 /**
- * How a word's own box breaks.
+ * How a word's own box breaks. The two writing modes want the same thing, which is why this takes
+ * no argument: a column of Japanese breaks by the same rules a line of it does.
  *
- * Vertical text keeps `word-break: normal`, which still breaks between CJK characters - that rule
- * has never needed `break-all` - while leaving Latin words whole.
+ * `word-break: normal` already breaks between CJK characters, which is the only thing `break-all`
+ * was ever here for, and it does not take a Latin word apart to do it. `break-all` means what it
+ * says: it cut "NarraLeaf" and "English" wherever the line ran out.
+ *
+ * `line-break: strict` asks for the rest of the kinsoku set. The prohibitions everyone knows - no
+ * line beginning with 、 。 」 ？ ！, none ending with 「 （ - are applied by the browser whatever
+ * `word-break` says, and were never the thing at fault. `strict` adds what a printed book is set
+ * to, holding back the small kana and the prolonged sound mark: over 301 container sizes, っ opened
+ * a line in 20 of them set horizontally and a column in 18 set vertically, and none at all under
+ * `strict`. It leaves the tate-chu-yoko runs below alone - a combined `12` measures the same
+ * either way.
+ *
+ * Worth knowing before deleting it: `strict` does nothing unless the document declares a language.
+ * Any `lang` will do - `en` is enough, and the shipped shell has one - but with no `lang` above the
+ * text the strict rules are not applied and this reads as dead weight.
+ *
+ * `overflow-wrap: break-word` is the last resort, for a run that fits nowhere - a URL, a long
+ * unspaced word in a narrow box - and it applies only after the line has been given its chance to
+ * break somewhere legal.
  */
-export declare function wordBreakStyleFor(vertical: boolean): React.CSSProperties;
+export declare function wordBreakStyleFor(): React.CSSProperties;
 /**
  * Renders a word's text with its short runs set upright.
  *