refactor(painter-dom): rename rtl-paragraph feature to inline-direction (SD-2779) (superdoc-dev#3307)

* refactor(painter-dom): rename rtl-paragraph feature to inline-direction (SD-2779)

The painter-dom feature module previously called `features/rtl-paragraph/`
handles two related but distinct OOXML elements: w:pPr/w:bidi
(paragraph inline direction) and w:rPr/w:rtl (run inline direction).
Both belong to the inline-direction axis. Table visual direction
(w:bidiVisual) and writing mode (w:textDirection) are separate
orthogonal axes owned elsewhere.

Rename the folder + import path + feature-registry entry to
`inline-direction` so the module name matches the axis, and add an
explicit note (registry comment + index.ts JSDoc) calling out the
two orthogonal axes the module does NOT own.

Internal file (`rtl-styles.ts`) and exported function names
(`applyRtlStyles`, `shouldUseSegmentPositioning`, `isRtlParagraph`,
`resolveTextAlign`) keep their RTL framing because they describe RTL
detection and styling specifically. Only the feature folder name
changes.

Tests: painter-dom 1070 pass. Build sweep
(`pnpm --filter @superdoc/painter-dom... build`) clean.

* docs(direction): correct OOXML spec citations on the orthogonal-axis note

§17.18.93 is ST_TextDirection (the enum values), not the element location.
w:textDirection lives at §17.3.1.41 (paragraph) and §17.4.72 (cell).

Also soften the "inline direction" framing to "paragraph/run inline bidi
handling": w:rPr/w:rtl is a run-level bidi/RTL/CS trigger, not strictly a
paragraph base-direction signal.

Comment-only; no code change.

Author: caio-pizzol

packages/layout-engine/painters/dom/src/features/feature-registry.ts

@@ -32,11 +32,14 @@ export const RENDERING_FEATURES = {
     spec: '§17.3.1.31',
   },
 
-  // ─── RTL Paragraph ─────────────────────────────────────────────
+  // ─── Inline Direction ──────────────────────────────────────────
+  // Paragraph/run inline bidi handling. NOT table visual direction
+  // (w:bidiVisual, §17.4.1), NOT writing mode (w:textDirection,
+  // §17.3.1.41 paragraph / §17.4.72 cell; values in §17.18.93).
   // @spec ECMA-376 §17.3.1.1 (bidi), §17.3.2.30 (rtl)
   'w:bidi': {
-    feature: 'rtl-paragraph',
-    module: './rtl-paragraph',
+    feature: 'inline-direction',
+    module: './inline-direction',
     handles: ['w:pPr/w:bidi', 'w:rPr/w:rtl'],
     spec: '§17.3.1.1',
   },

packages/layout-engine/painters/dom/src/features/inline-direction/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Inline Direction - rendering feature module
+ *
+ * Centralises paragraph base-direction and run-level RTL/bidi handling
+ * used by DomPainter:
+ * - Detecting whether a paragraph is RTL
+ * - Applying dir="rtl" and the correct text-align to an element
+ * - Resolving text-align for RTL vs LTR (justify -> right/left)
+ * - Deciding whether segment-based (absolute) positioning is safe
+ *
+ * Scope is paragraph/run inline bidi handling only. Table visual
+ * direction (w:bidiVisual, ECMA-376 §17.4.1) is a separate orthogonal
+ * axis owned by the painter's table rendering path. Writing mode
+ * (w:textDirection, ECMA-376 §17.3.1.41 paragraph / §17.4.72 cell;
+ * values in §17.18.93 ST_TextDirection) is another separate axis.
+ *
+ * @ooxml w:pPr/w:bidi - paragraph bidirectional flag
+ * @ooxml w:rPr/w:rtl  - run-level right-to-left flag
+ * @spec  ECMA-376 §17.3.1.1 (bidi), §17.3.2.30 (rtl)
+ */
+
+export { applyRtlStyles, shouldUseSegmentPositioning } from './rtl-styles.js';

…src/features/rtl-paragraph/rtl-styles.ts …/features/inline-direction/rtl-styles.tspackages/layout-engine/painters/dom/src/features/rtl-paragraph/rtl-styles.ts renamed to packages/layout-engine/painters/dom/src/features/inline-direction/rtl-styles.ts packages/layout-engine/painters/dom/src/features/rtl-paragraph/rtl-styles.ts renamed to packages/layout-engine/painters/dom/src/features/inline-direction/rtl-styles.ts

@@ -125,7 +125,7 @@ import {
   stampBetweenBorderDataset,
   type BetweenBorderInfo,
 } from './features/paragraph-borders/index.js';
-import { applyRtlStyles, shouldUseSegmentPositioning } from './features/rtl-paragraph/index.js';
+import { applyRtlStyles, shouldUseSegmentPositioning } from './features/inline-direction/index.js';
 import { convertOmmlToMathml } from './features/math/index.js';
 
 /**