commspliant-html-editor 0.0.24 → 0.1.1

package/README.md

@@ -172,6 +172,8 @@ Give the editor a parent with a definite height (`height: 100%` on a sized ances
 | `menuVisible` | `boolean` | `true` | Show the dropdown menu bar. Set `false` to hide it |
 | `toolbarVisible` | `boolean` | `true` | Show the icon toolbar. Set `false` to hide it |
 | `allowedChrome` | `AllowedChrome` | — | Host allowlist of menus and icon-toolbar buttons. Omit to show everything. See [Allowed chrome](#allowed-chrome) |
+| `renderingCapabilities` | `RenderingCapabilities` | — | Contract-driven chrome hiding and HTML validation. Omit for full editor behavior. See [Rendering capabilities](#rendering-capabilities) |
+| `onCapabilitiesValidation` | `(result: CapabilityValidationResult) => void` | — | Fired after debounced validation when `renderingCapabilities` is set |
 | `toolbarPosition` | `'top' \| 'left' \| 'right' \| 'bottom'` | `'top'` | Initial icon-toolbar dock when nothing is persisted. See [Toolbar position](#toolbar-position) |
 | `toolbarPositionPersistence` | `ToolbarPositionPersistence` | — | Host load/save for the icon-toolbar dock. Omit to persist in `localStorage`. See [Toolbar position](#toolbar-position) |
 | `customActions` | `CustomAction[]` | — | Host-defined menu items and/or toolbar buttons. See [Custom actions](#custom-actions) |
@@ -334,6 +336,49 @@ import { Editor } from 'commspliant-html-editor'
 <Editor />
 ```
 
+### Rendering capabilities
+
+Pass `renderingCapabilities` with a versioned contract JSON object (allowed tags, disallowed tags, CSS rules, global rules). The editor **derives** chrome visibility and validation from that object at runtime — there is no built-in “email mode” flag. When the contract changes, chrome and validation update automatically.
+
+- Incompatible toolbar items, menu entries, and context-menu commands are **hidden** (not merely disabled).
+- Paragraph style and font-family pickers filter to contract-allowed options.
+- Properties dialog tabs that expose disallowed CSS are hidden.
+- Document HTML is validated on a **debounced** schedule (~750ms after edits) and when View → Compatibility opens.
+- Validation is advisory; editing is not blocked.
+
+Omit `renderingCapabilities` for the default full editor with no compatibility UI.
+
+`validateHtmlAgainstCapabilities(html, contract)` is also exported for host-side checks outside the editor.
+
+`allowedChrome` and `renderingCapabilities` compose: both filters apply.
+
+```tsx
+import {
+  Editor,
+  validateHtmlAgainstCapabilities,
+  type RenderingCapabilities,
+  type CapabilityValidationResult,
+} from 'commspliant-html-editor'
+
+const emailContract: RenderingCapabilities = {
+  version: '1.0.0',
+  global_rules: { strip_unknown_tags: true },
+  html_elements: {
+    allowed_tags: [{ tag: 'p', allowed_attributes: ['style'] }],
+    disallowed_tags: ['video', 'audio'],
+  },
+}
+
+<Editor
+  renderingCapabilities={emailContract}
+  onCapabilitiesValidation={(result: CapabilityValidationResult) => {
+    console.log(result.valid, result.errorCount)
+  }}
+/>
+
+const report = validateHtmlAgainstCapabilities(html, emailContract)
+```
+
 ### Toolbar position
 
 View → Toolbar → Position docks the **icon toolbar** (Top, Left, Right, or Bottom). The dropdown menu bar stays at the top.
@@ -602,7 +647,7 @@ When multi-page mode is off (default), behavior is unchanged.
 - Host `onSave`, `onOpen`, and `onAutoSave` receive **all pages** as a `string[]` when `enableMultiPages` is true.
 - Use `onPagesChange` for controlled multi-page state. Export helpers: `splitPagesFromHtml`, `joinPagesToHtml`, and `PAGE_SEPARATOR` from the package.
 
-**Rulers:** When a page defines a **page size** (`@page` size preset such as A4, letter, or legal, or custom width and height), horizontal and vertical rulers appear for that page in visual mode. Orientation alone does not enable rulers. **View → Ruler** toggles them. The horizontal ruler stays pinned at the top of the document well while scrolling (like the toolbar stays above the scrollport). In multi-page mode, rulers follow the selected page (or page 1 before any page is selected). Each page row shows a vertical ruler only when that page has a size; unsized pages fill the workspace at 100% width and height. Drag margin splitters to change `@page` margins; the on-screen margin preview updates live while dragging and commits on release. Drag indent markers to set paragraph `text-indent` and `margin-left` / `margin-right` on the selection. Set `defaultRulerVisible={false}` to start hidden, and `rulerUnit` to change tick units (`in`, `cm`, `mm`, `pt`). Page zoom (View → Zoom) scales the page canvas; ruler band thickness stays 24px on screen.
+**Rulers:** When a page defines a **page size** (`@page` size preset such as A4, letter, or legal, or custom width and height), horizontal and vertical rulers appear for that page in visual mode. Orientation alone does not enable rulers. **View → Ruler** toggles them. The horizontal ruler stays pinned at the top of the document well while scrolling (like the toolbar stays above the scrollport). In multi-page mode, rulers follow the selected page (or page 1 before any page is selected). Each page row shows a vertical ruler only when that page has a size; unsized pages fill the workspace at 100% width and at least the well height, and grow with content. Drag margin splitters to change `@page` margins; the on-screen margin preview updates live while dragging and commits on release. Drag indent markers to set paragraph `text-indent` and `margin-left` / `margin-right` on the selection. Set `defaultRulerVisible={false}` to start hidden, and `rulerUnit` to change tick units (`in`, `cm`, `mm`, `pt`). Page zoom (View → Zoom) scales the page canvas; ruler band thickness stays 24px on screen.
 
 ```tsx
 import { useState } from 'react'

package/dist/capabilities/CapabilitiesContext.d.ts

@@ -0,0 +1,13 @@
+import { CapabilityValidationResult, EditorCapabilityProfile } from './types';
+export type CapabilitiesContextValue = {
+    profile: EditorCapabilityProfile | undefined;
+    validation: CapabilityValidationResult | null;
+    refreshValidation: () => void;
+};
+export declare function CapabilitiesProvider({ value, children, }: {
+    value: CapabilitiesContextValue;
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+export declare function useCapabilitiesContext(): CapabilitiesContextValue;
+export declare function useCapabilitiesProfile(): EditorCapabilityProfile | undefined;
+//# sourceMappingURL=CapabilitiesContext.d.ts.map

package/dist/capabilities/CapabilitiesContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilitiesContext.d.ts","sourceRoot":"","sources":["../../src/capabilities/CapabilitiesContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAElF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAA;IAC5C,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAA;IAC7C,iBAAiB,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAQD,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,wBAAwB,CAAA;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,+BAEA;AAED,wBAAgB,sBAAsB,IAAI,wBAAwB,CAEjE;AAED,wBAAgB,sBAAsB,IAAI,uBAAuB,GAAG,SAAS,CAE5E"}

package/dist/capabilities/capabilitiesChrome.d.ts

@@ -0,0 +1,5 @@
+import { ToolbarLayout } from '../toolbar/types';
+import { EditorCapabilityProfile } from './types';
+export declare function filterCapabilitiesLayout(layout: ToolbarLayout, profile: EditorCapabilityProfile | undefined): ToolbarLayout;
+export declare function isToolbarItemAllowedByCapabilities(itemId: string, profile: EditorCapabilityProfile | undefined): boolean;
+//# sourceMappingURL=capabilitiesChrome.d.ts.map

package/dist/capabilities/capabilitiesChrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilitiesChrome.d.ts","sourceRoot":"","sources":["../../src/capabilities/capabilitiesChrome.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,aAAa,EAAyB,MAAM,kBAAkB,CAAA;AAC3G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAmCtD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,uBAAuB,GAAG,SAAS,GAC3C,aAAa,CAmBf;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,GAAG,SAAS,GAC3C,OAAO,CAGT"}

package/dist/capabilities/featureFootprint.d.ts

@@ -0,0 +1,16 @@
+export type FeatureFootprint = {
+    tags?: string[];
+    cssProperties?: string[];
+    attributes?: {
+        tag: string;
+        names: string[];
+    }[];
+    dialogTabs?: {
+        dialog: 'paragraph' | 'page';
+        tabs: string[];
+    }[];
+};
+export declare const EDITOR_FEATURE_FOOTPRINTS: Record<string, FeatureFootprint>;
+export declare const DIALOG_TAB_FOOTPRINTS: Record<'paragraph' | 'page', Record<string, FeatureFootprint>>;
+export declare const CONTEXT_MENU_COMMAND_FOOTPRINTS: Record<string, FeatureFootprint>;
+//# sourceMappingURL=featureFootprint.d.ts.map

package/dist/capabilities/featureFootprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureFootprint.d.ts","sourceRoot":"","sources":["../../src/capabilities/featureFootprint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;IAC/C,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CAChE,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA6CtE,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,WAAW,GAAG,MAAM,EACpB,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAkBjC,CAAA;AAED,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAI5E,CAAA"}

package/dist/capabilities/formatViolation.d.ts

@@ -0,0 +1,6 @@
+import { Locale } from '../i18n/types';
+import { CapabilityViolation } from './types';
+export declare function interpolateMessageParams(template: string, params: Record<string, string>): string;
+export declare function formatCapabilityViolationMessage(violation: CapabilityViolation, locale?: Locale): string;
+export declare function formatCapabilityViolationLocation(violation: CapabilityViolation, locale?: Locale): string;
+//# sourceMappingURL=formatViolation.d.ts.map

package/dist/capabilities/formatViolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatViolation.d.ts","sourceRoot":"","sources":["../../src/capabilities/formatViolation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAIlD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,mBAAmB,EAC9B,MAAM,GAAE,MAAa,GACpB,MAAM,CAIR;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,mBAAmB,EAC9B,MAAM,GAAE,MAAa,GACpB,MAAM,CAYR"}

package/dist/capabilities/index.d.ts

@@ -0,0 +1,10 @@
+export type { CapabilityValidationResult, CapabilityViolation, CapabilityViolationSeverity, EditorCapabilityProfile, NormalizedContract, RenderingCapabilities, TagRule, } from './types';
+export { normalizeContract } from './normalizeContract';
+export { resolveEditorCapabilities } from './resolveEditorCapabilities';
+export { filterCapabilitiesLayout, isToolbarItemAllowedByCapabilities, } from './capabilitiesChrome';
+export { validateHtmlAgainstCapabilities, validatePagesAgainstCapabilities, } from './validateHtml';
+export { formatCapabilityViolationLocation, formatCapabilityViolationMessage, interpolateMessageParams, } from './formatViolation';
+export { isFeatureAllowed } from './isFeatureAllowed';
+export { isPageLayoutAllowed } from './isPageLayoutAllowed';
+export { EDITOR_FEATURE_FOOTPRINTS, DIALOG_TAB_FOOTPRINTS } from './featureFootprint';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,OAAO,GACR,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EACL,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/capabilities/inlineStyle.d.ts

@@ -0,0 +1,6 @@
+export declare function parseInlineStyle(style: string): Map<string, string>;
+export declare function serializeInlineStyle(styles: Map<string, string>): string;
+export declare function normalizeCssPropertyName(property: string): string;
+export declare function cssValueUsesFormat(value: string, format: string): boolean;
+export declare function parseAllowedOnTagsFromRestrictions(restrictions?: string): string[] | null;
+//# sourceMappingURL=inlineStyle.d.ts.map

package/dist/capabilities/inlineStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineStyle.d.ts","sourceRoot":"","sources":["../../src/capabilities/inlineStyle.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYnE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAExE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAgCzE;AAED,wBAAgB,kCAAkC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAKzF"}

package/dist/capabilities/isFeatureAllowed.d.ts

@@ -0,0 +1,5 @@
+import { FeatureFootprint } from './featureFootprint';
+import { NormalizedContract } from './types';
+export declare function isFeatureAllowed(footprint: FeatureFootprint | undefined, rules: NormalizedContract): boolean;
+export declare function isDialogTabAllowed(_dialog: 'paragraph' | 'page', tab: string, rules: NormalizedContract, tabFootprints: Record<string, FeatureFootprint>): boolean;
+//# sourceMappingURL=isFeatureAllowed.d.ts.map

package/dist/capabilities/isFeatureAllowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isFeatureAllowed.d.ts","sourceRoot":"","sources":["../../src/capabilities/isFeatureAllowed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAkDjD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CA2BT;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,GAAG,MAAM,EAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,EACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC9C,OAAO,CAIT"}

package/dist/capabilities/isPageLayoutAllowed.d.ts

@@ -0,0 +1,3 @@
+import { RenderingCapabilities } from './types';
+export declare function isPageLayoutAllowed(contract: RenderingCapabilities): boolean;
+//# sourceMappingURL=isPageLayoutAllowed.d.ts.map

package/dist/capabilities/isPageLayoutAllowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPageLayoutAllowed.d.ts","sourceRoot":"","sources":["../../src/capabilities/isPageLayoutAllowed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAexE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAI5E"}

package/dist/capabilities/normalizeContract.d.ts

@@ -0,0 +1,3 @@
+import { NormalizedContract, RenderingCapabilities } from './types';
+export declare function normalizeContract(contract: RenderingCapabilities): NormalizedContract;
+//# sourceMappingURL=normalizeContract.d.ts.map

package/dist/capabilities/normalizeContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeContract.d.ts","sourceRoot":"","sources":["../../src/capabilities/normalizeContract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,kBAAkB,EAElB,qBAAqB,EAEtB,MAAM,SAAS,CAAA;AAmChB,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,kBAAkB,CAoCrF"}

package/dist/capabilities/resolveEditorCapabilities.d.ts

@@ -0,0 +1,3 @@
+import { EditorCapabilityProfile, RenderingCapabilities } from './types';
+export declare function resolveEditorCapabilities(contract: RenderingCapabilities): EditorCapabilityProfile;
+//# sourceMappingURL=resolveEditorCapabilities.d.ts.map

package/dist/capabilities/resolveEditorCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEditorCapabilities.d.ts","sourceRoot":"","sources":["../../src/capabilities/resolveEditorCapabilities.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAyD7E,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,qBAAqB,GAC9B,uBAAuB,CAYzB"}

package/dist/capabilities/testContracts.d.ts

@@ -0,0 +1,4 @@
+import { RenderingCapabilities } from './types';
+export declare const COMMSPLIANT_EMAIL_CONTRACT: RenderingCapabilities;
+export declare const PERMISSIVE_WEB_CONTRACT: RenderingCapabilities;
+//# sourceMappingURL=testContracts.d.ts.map

package/dist/capabilities/testContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testContracts.d.ts","sourceRoot":"","sources":["../../src/capabilities/testContracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEpD,eAAO,MAAM,0BAA0B,EAAE,qBA8IxC,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,qBA+CrC,CAAA"}

package/dist/capabilities/types.d.ts

@@ -0,0 +1,103 @@
+export type CssPropertyStatus = 'allowed' | 'restricted' | 'disallowed' | 'allowed_with_degradation';
+export type AllowedTagRule = {
+    tag: string;
+    required_attributes?: Record<string, string>;
+    allowed_attributes?: string[];
+    disallowed_css?: string[];
+    forced_css?: Record<string, string>;
+    default_attributes?: Record<string, string>;
+    recommended_css?: string[];
+    status?: 'restricted';
+    notes?: string;
+};
+export type CssPropertyRuleSource = {
+    property: string;
+    status: CssPropertyStatus;
+    support?: Record<string, string>;
+    allowed_values?: string[];
+    disallowed_values?: string[];
+    allowed_on_tags?: string[];
+    restrictions?: string;
+    fallback?: string | null;
+    fallback_required?: string;
+    transformation?: string;
+};
+export type RenderingCapabilities = {
+    $schema?: string;
+    title?: string;
+    version?: string;
+    description?: string;
+    global_rules?: {
+        layout_mode?: string;
+        require_inlining?: boolean;
+        max_container_width_px?: number;
+        strip_unknown_tags?: boolean;
+        strip_unknown_attributes?: boolean;
+    };
+    html_elements?: {
+        allowed_tags?: AllowedTagRule[];
+        disallowed_tags?: string[];
+    };
+    css_properties?: CssPropertyRuleSource[];
+};
+export type TagRule = {
+    tag: string;
+    requiredAttributes: Record<string, string>;
+    allowedAttributes: string[] | null;
+    disallowedCss: string[];
+    forcedCss: Record<string, string>;
+    defaultAttributes: Record<string, string>;
+    status?: 'restricted';
+    notes?: string;
+};
+export type NormalizedCssPropertyRule = {
+    property: string;
+    status: CssPropertyStatus;
+    allowedValues: string[] | null;
+    disallowedValues: string[] | null;
+    allowedOnTags: string[] | null;
+    restrictions?: string;
+    fallback?: string | null;
+};
+export type NormalizedContract = {
+    allowedTagSet: Set<string> | null;
+    disallowedTagSet: Set<string>;
+    tagRules: Map<string, TagRule>;
+    cssPropertyRules: Map<string, NormalizedCssPropertyRule>;
+    globalRules: {
+        layoutMode?: string;
+        requireInlining?: boolean;
+        maxContainerWidthPx?: number;
+        stripUnknownTags: boolean;
+        stripUnknownAttributes: boolean;
+    };
+};
+export type CapabilityViolationSeverity = 'error' | 'warning';
+export type CapabilityViolation = {
+    code: string;
+    severity: CapabilityViolationSeverity;
+    messageKey: string;
+    messageParams: Record<string, string>;
+    selector?: string;
+    tag?: string;
+    attribute?: string;
+    cssProperty?: string;
+    pageIndex?: number;
+};
+export type CapabilityValidationResult = {
+    valid: boolean;
+    errorCount: number;
+    warningCount: number;
+    violations: CapabilityViolation[];
+};
+export type EditorCapabilityProfile = {
+    normalized: NormalizedContract;
+    hiddenToolbarItemIds: ReadonlySet<string>;
+    hiddenContextMenuCommands: ReadonlySet<string>;
+    allowedParagraphTags: readonly string[];
+    allowedFontFamilies: string[] | null;
+    hiddenDialogTabs: Partial<Record<'paragraph' | 'page', readonly string[]>>;
+    maxContainerWidthPx?: number;
+    pageLayoutAllowed: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/types.d.ts.map

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

package/dist/capabilities/validateHtml.d.ts

@@ -0,0 +1,6 @@
+import { CapabilityValidationResult, RenderingCapabilities } from './types';
+export declare function validateHtmlAgainstCapabilities(html: string, contract: RenderingCapabilities, options?: {
+    pageIndex?: number;
+}): CapabilityValidationResult;
+export declare function validatePagesAgainstCapabilities(pages: string[], contract: RenderingCapabilities): CapabilityValidationResult;
+//# sourceMappingURL=validateHtml.d.ts.map

package/dist/capabilities/validateHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateHtml.d.ts","sourceRoot":"","sources":["../../src/capabilities/validateHtml.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,0BAA0B,EAG1B,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAiVhB,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,0BAA0B,CAY5B;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,qBAAqB,GAC9B,0BAA0B,CAO5B"}