dom-docx 0.1.0

package/dist/converter/css.d.ts

@@ -0,0 +1,112 @@
+import { ShadingType, type IParagraphStylePropertiesOptions } from "docx";
+import type { Element } from "domhandler";
+import type { StyleResolver } from "./style-resolver.js";
+import type { BlockLayout, RunTypography } from "./types.js";
+export interface ParsedBorder {
+    widthPx: number;
+    color?: string;
+}
+export interface ParsedCss {
+    color?: string;
+    backgroundColor?: string;
+    display?: string;
+    flexDirection?: string;
+    gap?: number;
+    textAlign?: string;
+    /** `font-family` mapped to a Word-safe installed font (first recognized family wins). */
+    fontFamily?: string;
+    /** `border-collapse` keyword — separate (default) tables get UA border-spacing gaps. */
+    borderCollapse?: string;
+    /** `text-transform` keyword (uppercase → Word all-caps display property). */
+    textTransform?: string;
+    /** `letter-spacing` in twips (absolute units). */
+    letterSpacingTwips?: number;
+    /** `letter-spacing` in em (resolved against font size at typography build). */
+    letterSpacingEm?: number;
+    fontSize?: number;
+    fontWeight?: string;
+    fontStyle?: string;
+    listStyleType?: string;
+    marginTop?: number;
+    marginRight?: number;
+    marginBottom?: number;
+    marginLeft?: number;
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    /** Explicit CSS height in twips (px/pt/em) — used for color-bar sizing. */
+    heightTwips?: number;
+    /** Explicit CSS width: absolute in twips, or percentage of the containing block. */
+    widthTwips?: number;
+    widthPercent?: number;
+    maxWidthTwips?: number;
+    maxHeightTwips?: number;
+    visibility?: string;
+    opacity?: number;
+    overflow?: string;
+    border?: ParsedBorder;
+    /** `border-color` — color override for borders declared elsewhere (attr or shorthand). */
+    borderColor?: string;
+    borderTop?: ParsedBorder;
+    borderRight?: ParsedBorder;
+    borderBottom?: ParsedBorder;
+    borderLeft?: ParsedBorder;
+}
+export declare function pxToTwips(px: number): number;
+export declare function pxToHalfPoints(px: number): number;
+/** Flex gap in twips from px or bare number (treated as px). */
+export declare function parseGap(value: string | undefined): number | undefined;
+export declare function parseColor(value: string | undefined): string | undefined;
+export declare function parseFontSize(value: string | undefined): number | undefined;
+export declare function parseInlineStyle(style: string | undefined): ParsedCss;
+/**
+ * Element is invisible in a browser — skip it entirely. Covers `display:none`,
+ * `visibility:hidden`, `opacity:0`, and the email-preheader idiom
+ * (`max-height:0` + `overflow:hidden`).
+ */
+export declare function isHiddenCss(css: ParsedCss): boolean;
+export declare function isHiddenElement(element: Element, resolver?: StyleResolver): boolean;
+/**
+ * Legacy presentational attributes (`bgcolor`, `<font color/size/face>`,
+ * `align`, `<center>`) → their CSS equivalents. Inline `style=""` wins over
+ * attributes, matching browser precedence.
+ */
+export declare function presentationalAttributesCss(element: Element): ParsedCss;
+/** Block if tag is structural block OR display is block / inline-block. */
+export declare function isBlockElement(element: Element, resolver?: StyleResolver): boolean;
+export declare function mapTextAlign(value: string | undefined): BlockLayout["alignment"];
+export declare function pxPaddingToBorderSpace(paddingTwips: number | undefined): number;
+/** Block containers: background-color → paragraph shading only. */
+export declare function cssToBlockLayout(css: ParsedCss): BlockLayout;
+/** Block foreground typography — never carries background-color. */
+export declare function cssToBlockTypography(css: ParsedCss): RunTypography;
+/** Inline elements: background-color → TextRun shading only. */
+export declare function cssToInlineRunTypography(css: ParsedCss): RunTypography;
+export declare function layoutFromElement(element: Element, resolver?: StyleResolver): BlockLayout;
+/** Nearest `font-family` up the ancestor chain (CSS inheritance), if any. */
+export declare function inheritedFontFamily(element: Element, resolver?: StyleResolver): string | undefined;
+export declare function typographyFromBlockElement(element: Element, resolver?: StyleResolver): RunTypography;
+/** Native shaded block: keep padding fields for makeParagraph; no indent/spacing bleed. */
+export declare function layoutForNativeShadedBlock(layout: BlockLayout): BlockLayout;
+/** Normalize fill hex for consistent LO PDF rendering. */
+export declare function runShadingForFill(fill: string): {
+    type: typeof ShadingType.CLEAR;
+    fill: string;
+    color: string;
+};
+/**
+ * Vertical padding inside a shaded paragraph band.
+ * Embed all padding in one EXACT line — LO paints spacing.before outside w:shd.
+ */
+export declare function shadedBlockParagraphSpacing(layout: BlockLayout): IParagraphStylePropertiesOptions["spacing"];
+export declare function blockLayoutToParagraphProps(layout: BlockLayout): IParagraphStylePropertiesOptions;
+/** @deprecated */
+export declare function cssToBlockStyle(css: ParsedCss): BlockLayout;
+/** @deprecated */
+export declare function cssToRunTypography(_css: ParsedCss, _tag?: string): RunTypography;
+/** @deprecated */
+export declare function cssToRunStyle(css: ParsedCss, tag?: string): RunTypography;
+/** @deprecated */
+export declare function blockStyleToParagraphProps(layout: BlockLayout): IParagraphStylePropertiesOptions;
+//# sourceMappingURL=css.d.ts.map

package/dist/converter/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/converter/css.ts"],"names":[],"mappings":"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"}