@hyperframes/lint 0.7.16 → 0.7.17

package/dist/browser.d.ts

@@ -0,0 +1,55 @@
+type HyperframeLintSeverity = "error" | "warning" | "info";
+type HyperframeLintFinding = {
+    code: string;
+    severity: HyperframeLintSeverity;
+    message: string;
+    file?: string;
+    selector?: string;
+    elementId?: string;
+    fixHint?: string;
+    snippet?: string;
+};
+type HyperframeLintResult = {
+    ok: boolean;
+    errorCount: number;
+    warningCount: number;
+    infoCount: number;
+    findings: HyperframeLintFinding[];
+};
+type HyperframeLinterOptions = {
+    filePath?: string;
+    isSubComposition?: boolean;
+    externalStyles?: Array<{
+        href: string;
+        content: string;
+    }>;
+    /**
+     * Set to `true` when linting compositions destined for distributed / Lambda
+     * rendering, where system-font capture (`allowSystemFontCapture`) is
+     * disabled.  When `true`, the `system_font_will_alias` rule is elevated from
+     * `"info"` to `"warning"` because the alias substitution will NOT happen at
+     * render time — the font will silently fall back to whatever the OS provides.
+     */
+    distributed?: boolean;
+};
+
+declare function lintHyperframeHtml(html: string, options?: HyperframeLinterOptions): Promise<HyperframeLintResult>;
+/**
+ * Async lint pass: HEAD-checks every remote media URL in the HTML.
+ * Returns findings for URLs that are unreachable (non-2xx status or network error).
+ *
+ * Call this after `lintHyperframeHtml()` and merge the findings.
+ *
+ * @param timeoutMs - per-request timeout (default 8000ms)
+ */
+declare function lintMediaUrls(html: string, options?: {
+    timeoutMs?: number;
+}): Promise<HyperframeLintFinding[]>;
+
+/**
+ * Pure render-gate decision — no Node.js dependencies, so it is safe to import
+ * from the browser entry alongside the rule engine.
+ */
+declare function shouldBlockRender(strictErrors: boolean, strictAll: boolean, totalErrors: number, totalWarnings: number): boolean;
+
+export { type HyperframeLintFinding, type HyperframeLintResult, type HyperframeLintSeverity, type HyperframeLinterOptions, lintHyperframeHtml, lintMediaUrls, shouldBlockRender };