@mk-kit/ui 0.48.0 → 0.50.0

package/types/mk-kit-ui-data.d.ts

@@ -3,7 +3,9 @@ import { TemplateRef, ElementRef } from '@angular/core';
 import * as _mk_kit_ui_core from '@mk-kit/ui/core';
 import { MkTone, MkSize, MkCodeLanguage } from '@mk-kit/ui/core';
 import { ControlValueAccessor } from '@angular/forms';
-import * as _mk_kit_ui_data from '@mk-kit/ui/data';
+import * as _mk_kit_core from '@mk-kit/core';
+import { MkDiffRow } from '@mk-kit/core';
+export { MkAnsiSpan, MkDiffOp, MkDiffOptions, MkDiffRow, MkDiffSegment, MkDiffStats, MkMarkdownAlign, MkMarkdownBlock, MkMarkdownInline, MkMarkdownList, MkMarkdownListItem, MkMarkdownParseOptions, MkMarkdownRenderOptions, mkComputeDiff, mkDiffStats, mkParseAnsi, mkParseMarkdown, mkRenderMarkdown, mkStripAnsi } from '@mk-kit/core';
 import { MkDropEvent } from '@mk-kit/ui/dnd';
 
 /** Surface treatment for a {@link MkCard}. */
@@ -2396,53 +2398,6 @@ declare class MkCarousel {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkCarousel, "mk-carousel", never, { "index": { "alias": "index"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "showDots": { "alias": "showDots"; "required": false; "isSignal": true; }; "showArrows": { "alias": "showArrows"; "required": false; "isSignal": true; }; "autoplay": { "alias": "autoplay"; "required": false; "isSignal": true; }; "interval": { "alias": "interval"; "required": false; "isSignal": true; }; "userPaused": { "alias": "userPaused"; "required": false; "isSignal": true; }; }, { "index": "indexChange"; "userPaused": "userPausedChange"; }, ["slides"], ["*"], true, never>;
 }
 
-/**
- * Dependency-free text diff for {@link MkDiff} — an LCS line diff with optional
- * intra-line word highlighting. Pure and SSR-safe (no DOM). Suited to revision
- * comparison ("what changed between save N and N+1").
- */
-/** The kind of change for a diff row/segment. */
-type MkDiffOp = 'equal' | 'insert' | 'delete';
-/** A word-level segment within a changed line. */
-interface MkDiffSegment {
-    text: string;
-    /** True when this word differs from the paired line. */
-    changed: boolean;
-}
-/** One line of a computed diff. */
-interface MkDiffRow {
-    op: MkDiffOp;
-    text: string;
-    /** 1-based line number in the "before" text (null for inserts). */
-    beforeNo: number | null;
-    /** 1-based line number in the "after" text (null for deletes). */
-    afterNo: number | null;
-    /** Word segments for changed lines (present when word highlighting runs). */
-    segments?: MkDiffSegment[];
-}
-/** Summary counts for a diff. */
-interface MkDiffStats {
-    added: number;
-    removed: number;
-    unchanged: number;
-}
-/** Options for {@link mkComputeDiff}. */
-interface MkDiffOptions {
-    /** Highlight the specific words that changed within paired lines. */
-    wordHighlight?: boolean;
-    /** Treat trailing whitespace as insignificant when comparing lines. */
-    ignoreTrailingWhitespace?: boolean;
-}
-/**
- * Compute a line diff between `before` and `after`. Returns one {@link MkDiffRow}
- * per line in document order, with `equal` / `insert` / `delete` ops and 1-based
- * before/after line numbers. With `wordHighlight` (default true) changed lines
- * also carry word-level `segments`.
- */
-declare function mkComputeDiff(before: string, after: string, options?: MkDiffOptions): MkDiffRow[];
-/** Summary counts (added / removed / unchanged lines) for a diff. */
-declare function mkDiffStats(rows: MkDiffRow[]): MkDiffStats;
-
 /** How {@link MkDiff} lays out the comparison. */
 type MkDiffMode = 'unified' | 'split';
 interface SplitRow {
@@ -2479,7 +2434,7 @@ declare class MkDiff {
     readonly beforeLabel: _angular_core.InputSignal<string>;
     readonly afterLabel: _angular_core.InputSignal<string>;
     protected readonly rows: _angular_core.Signal<MkDiffRow[]>;
-    protected readonly stats: _angular_core.Signal<_mk_kit_ui_data.MkDiffStats>;
+    protected readonly stats: _angular_core.Signal<_mk_kit_core.MkDiffStats>;
     /** Rows paired into two columns for the split view. */
     protected readonly splitRows: _angular_core.Signal<SplitRow[]>;
     protected marker(op: MkDiffRow['op']): string;
@@ -2728,39 +2683,6 @@ declare class MkJsonViewer {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkJsonViewer, "mk-json-viewer", ["mkJsonViewer"], { "data": { "alias": "data"; "required": true; "isSignal": true; }; "expandDepth": { "alias": "expandDepth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/**
- * Minimal ANSI SGR parser for {@link MkLogViewer}.
- *
- * Understands the SGR (`ESC[…m`) subset that matters for log output — reset
- * (0), bold (1), italic (3), underline (4), the 22/23/24 "off" codes, the 8
- * standard + 8 bright foreground colours (30–37 / 90–97, 39 reset) and the
- * matching backgrounds (40–47 / 100–107, 49 reset). Extended-colour
- * introducers (38/48;5;… and 38/48;2;r;g;b) are consumed so their arguments
- * are never misread as other codes, but map to "no colour" (the theme has no
- * 256-colour palette). Every other escape sequence — cursor movement, erase,
- * OSC titles, single-character escapes — is stripped rather than rendered as
- * garbage.
- *
- * Colours are emitted as CSS class names (`mk-ansi--fg-red`,
- * `mk-ansi--bg-bright-blue`, `mk-ansi--bold`, …) themed in
- * `log-viewer.scss`, not as raw terminal colours.
- */
-/** One styled run of text within a parsed line. */
-interface MkAnsiSpan {
-    /** The plain text of the run (escape sequences removed). */
-    text: string;
-    /** `mk-ansi--*` class names styling the run; empty for plain text. */
-    classes: readonly string[];
-}
-/**
- * Parse one log line into styled spans. Pure — same input, same output.
- * Adjacent runs with identical styling are merged, so a plain line yields a
- * single span (or none when empty).
- */
-declare function mkParseAnsi(line: string): MkAnsiSpan[];
-/** Remove every ANSI escape sequence from a line (for copy / search). */
-declare function mkStripAnsi(line: string): string;
-
 /** One render token of a log line: a styled run, optionally a search match. */
 interface MkLogToken {
     text: string;
@@ -2889,94 +2811,5 @@ declare class MkMarkdown {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkMarkdown, "mk-markdown", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "autolink": { "alias": "autolink"; "required": false; "isSignal": true; }; "linkTarget": { "alias": "linkTarget"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/** Column alignment of a table, from the delimiter row's colons. */
-type MkMarkdownAlign = 'left' | 'center' | 'right' | null;
-/** Inline (phrasing) node of the markdown AST. */
-type MkMarkdownInline = {
-    kind: 'text';
-    text: string;
-} | {
-    kind: 'softbreak';
-} | {
-    kind: 'break';
-} | {
-    kind: 'code';
-    code: string;
-} | {
-    kind: 'strong';
-    children: MkMarkdownInline[];
-} | {
-    kind: 'em';
-    children: MkMarkdownInline[];
-} | {
-    kind: 'del';
-    children: MkMarkdownInline[];
-} | {
-    kind: 'link';
-    href: string;
-    children: MkMarkdownInline[];
-} | {
-    kind: 'image';
-    src: string;
-    alt: string;
-};
-/** One `<li>`: tight inline content plus an optional nested list. */
-interface MkMarkdownListItem {
-    children: MkMarkdownInline[];
-    sublist: MkMarkdownList | null;
-}
-/** An ordered or unordered (tight) list block. */
-interface MkMarkdownList {
-    kind: 'list';
-    ordered: boolean;
-    /** First ordinal of an ordered list (`3.` starts at 3). Always 1 for bullets. */
-    start: number;
-    items: MkMarkdownListItem[];
-}
-/** Block-level node of the markdown AST. */
-type MkMarkdownBlock = {
-    kind: 'heading';
-    level: 1 | 2 | 3 | 4 | 5 | 6;
-    children: MkMarkdownInline[];
-} | {
-    kind: 'paragraph';
-    children: MkMarkdownInline[];
-} | {
-    kind: 'code';
-    language: string;
-    code: string;
-} | {
-    kind: 'blockquote';
-    children: MkMarkdownBlock[];
-} | {
-    kind: 'hr';
-} | MkMarkdownList | {
-    kind: 'table';
-    align: MkMarkdownAlign[];
-    header: MkMarkdownInline[][];
-    rows: MkMarkdownInline[][][];
-};
-interface MkMarkdownParseOptions {
-    /** Turn bare `http(s)://…` URLs into links. Off by default. */
-    autolink?: boolean;
-}
-interface MkMarkdownRenderOptions {
-    /** `'_blank'` renders `target="_blank" rel="noopener noreferrer"` on links. */
-    linkTarget?: '' | '_blank';
-}
-/**
- * Parse markdown source into a typed AST. Pure and dependency-free — safe to
- * run on a server. Unsafe link/image URLs are already dropped at this stage,
- * so the AST never carries a `javascript:` (or other non-allow-listed) URL.
- */
-declare function mkParseMarkdown(src: string, options?: MkMarkdownParseOptions): MkMarkdownBlock[];
-/**
- * Render a parsed AST to an HTML string. The output contains only tags this
- * renderer generates (all source text is escaped), so it is safe to bind to
- * `[innerHTML]` — Angular's sanitizer keeps every element/attribute used here.
- * Fenced code is highlighted via `mkHighlight` for its known languages.
- */
-declare function mkRenderMarkdown(blocks: MkMarkdownBlock[], options?: MkMarkdownRenderOptions): string;
-
-export { MK_CHART_PALETTE_SIZE, MK_HEATMAP_MIN_CONTRAST, MkAvatar, MkAvatarGroup, MkBadge, MkBadgeOverlay, MkBarChart, MkCalendarHeatmap, MkCard, MkCardFooter, MkCardHeader, MkCardTitle, MkCarousel, MkCarouselSlide, MkCode, MkCountdown, MkDescItem, MkDescriptionList, MkDiff, MkDivider, MkDonutChart, MkEmptyState, MkFunnelChart, MkGauge, MkHeatmap, MkInlineEdit, MkJsonViewer, MkKanban, MkLineChart, MkList, MkListItem, MkLogViewer, MkMarkdown, MkOrgChart, MkOrgChartNodeDef, MkProfileActions, MkProfileCard, MkProfileMeta, MkProgressBar, MkProgressRing, MkQrCode, MkRadarChart, MkScatterChart, MkSkeleton, MkSkeletonPreset, MkSparkline, MkSpinner, MkStatCard, MkTag, MkTimeline, MkTimelineItem, MkTreemap, MkVirtualScroll, mkArcPath, mkAreaPath, mkBuildJsonTree, mkChartColor, mkComputeDiff, mkContrastRatio, mkDiffStats, mkEncodeQr, mkFormatCompact, mkHeatmapCellColors, mkLinePath, mkLinearScale, mkMixRgb, mkNiceTicks, mkOrgChartFromFlat, mkParseAnsi, mkParseMarkdown, mkParseRgb, mkRelativeLuminance, mkRenderMarkdown, mkSplitDuration, mkSquarify, mkStripAnsi };
-export type { MkAnsiSpan, MkAvatarShape, MkAvatarStatus, MkBadgeOverlayPosition, MkBadgeVariant, MkBarOrientation, MkCalendarHeatmapCell, MkCalendarHeatmapEntry, MkCardPadding, MkCardVariant, MkChartSeries, MkChartSlice, MkDescriptionLayout, MkDiffMode, MkDiffOp, MkDiffOptions, MkDiffRow, MkDiffSegment, MkDiffStats, MkDividerOrientation, MkDurationParts, MkFunnelSegment, MkHeatmapCellColors, MkHeatmapPalette, MkJsonNode, MkKanbanCard, MkKanbanCardMovedEvent, MkKanbanColumn, MkLogToken, MkMarkdownAlign, MkMarkdownBlock, MkMarkdownInline, MkMarkdownList, MkMarkdownListItem, MkMarkdownParseOptions, MkMarkdownRenderOptions, MkOrgChartFlatNode, MkOrgChartNode, MkOrgChartNodeContext, MkOrgChartOrientation, MkOrgChartTemplateData, MkOrgChartToggleEvent, MkPoint, MkProfileCardOrientation, MkQrEcc, MkRgb, MkScatterPoint, MkScatterSeries, MkSkeletonPresetKind, MkSkeletonShape, MkSparklineType, MkStatTrend, MkTagVariant, MkTreemapItem, MkTreemapRect };
+export { MK_CHART_PALETTE_SIZE, MK_HEATMAP_MIN_CONTRAST, MkAvatar, MkAvatarGroup, MkBadge, MkBadgeOverlay, MkBarChart, MkCalendarHeatmap, MkCard, MkCardFooter, MkCardHeader, MkCardTitle, MkCarousel, MkCarouselSlide, MkCode, MkCountdown, MkDescItem, MkDescriptionList, MkDiff, MkDivider, MkDonutChart, MkEmptyState, MkFunnelChart, MkGauge, MkHeatmap, MkInlineEdit, MkJsonViewer, MkKanban, MkLineChart, MkList, MkListItem, MkLogViewer, MkMarkdown, MkOrgChart, MkOrgChartNodeDef, MkProfileActions, MkProfileCard, MkProfileMeta, MkProgressBar, MkProgressRing, MkQrCode, MkRadarChart, MkScatterChart, MkSkeleton, MkSkeletonPreset, MkSparkline, MkSpinner, MkStatCard, MkTag, MkTimeline, MkTimelineItem, MkTreemap, MkVirtualScroll, mkArcPath, mkAreaPath, mkBuildJsonTree, mkChartColor, mkContrastRatio, mkEncodeQr, mkFormatCompact, mkHeatmapCellColors, mkLinePath, mkLinearScale, mkMixRgb, mkNiceTicks, mkOrgChartFromFlat, mkParseRgb, mkRelativeLuminance, mkSplitDuration, mkSquarify };
+export type { MkAvatarShape, MkAvatarStatus, MkBadgeOverlayPosition, MkBadgeVariant, MkBarOrientation, MkCalendarHeatmapCell, MkCalendarHeatmapEntry, MkCardPadding, MkCardVariant, MkChartSeries, MkChartSlice, MkDescriptionLayout, MkDiffMode, MkDividerOrientation, MkDurationParts, MkFunnelSegment, MkHeatmapCellColors, MkHeatmapPalette, MkJsonNode, MkKanbanCard, MkKanbanCardMovedEvent, MkKanbanColumn, MkLogToken, MkOrgChartFlatNode, MkOrgChartNode, MkOrgChartNodeContext, MkOrgChartOrientation, MkOrgChartTemplateData, MkOrgChartToggleEvent, MkPoint, MkProfileCardOrientation, MkQrEcc, MkRgb, MkScatterPoint, MkScatterSeries, MkSkeletonPresetKind, MkSkeletonShape, MkSparklineType, MkStatTrend, MkTagVariant, MkTreemapItem, MkTreemapRect };

package/types/mk-kit-ui-datetime.d.ts

@@ -1,82 +1,10 @@
-import * as _mk_kit_ui_core from '@mk-kit/ui/core';
-import { MkDateNames, MkSize } from '@mk-kit/ui/core';
+export { MkWeekday, addDays, addMonths, buildMonthMatrix, clampDate, endOfMonth, endOfWeek, formatDate, formatISODate, getISOWeek, getMonthNames, getWeekdayFullName, getWeekdayNames, isAfter, isBefore, isSameDay, isSameMonth, parseISODate, startOfDay, startOfMonth, startOfWeek } from '@mk-kit/core';
 import * as _angular_core from '@angular/core';
 import { OnDestroy } from '@angular/core';
+import * as _mk_kit_ui_core from '@mk-kit/ui/core';
+import { MkSize } from '@mk-kit/ui/core';
 import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 
-/**
- * Dependency-free date helpers shared by the mk-kit DATE & TIME components.
- * All functions are pure and operate on native `Date`. Name-producing helpers
- * default to English but accept an optional {@link MkDateNames} table (from
- * `MK_I18N`) for localisation. Dates are treated in the local time zone.
- */
-
-/** Day-of-week index 0 (Sunday) … 6 (Saturday). */
-type MkWeekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
-/** True when both dates fall on the same calendar day (local time). */
-declare function isSameDay(a: Date, b: Date): boolean;
-/** True when both dates fall in the same calendar month of the same year. */
-declare function isSameMonth(a: Date, b: Date): boolean;
-/** Midnight (00:00:00.000) on the first day of `date`'s month. */
-declare function startOfMonth(date: Date): Date;
-/** Midnight on the last day of `date`'s month. */
-declare function endOfMonth(date: Date): Date;
-/** A new date `count` months after `date` (negative to subtract). Clamps the
- * day of month so e.g. Jan 31 + 1 month = Feb 28/29, not Mar 3. */
-declare function addMonths(date: Date, count: number): Date;
-/** A new date `count` days after `date` (negative to subtract). */
-declare function addDays(date: Date, count: number): Date;
-/** Midnight (00:00:00.000) on `date`'s calendar day. */
-declare function startOfDay(date: Date): Date;
-/**
- * The first day of the week containing `date`, at midnight. `firstDayOfWeek`
- * is the week's starting weekday (0 = Sunday … 6 = Saturday).
- */
-declare function startOfWeek(date: Date, firstDayOfWeek?: number): Date;
-/** The last day of the week containing `date`, at midnight. */
-declare function endOfWeek(date: Date, firstDayOfWeek?: number): Date;
-/**
- * ISO-8601 week number (1–53) of `date`. Weeks start on Monday and week 1 is
- * the week containing the first Thursday of the year.
- */
-declare function getISOWeek(date: Date): number;
-/** True when `a` is strictly before `b` (full timestamp comparison). */
-declare function isBefore(a: Date, b: Date): boolean;
-/** True when `a` is strictly after `b` (full timestamp comparison). */
-declare function isAfter(a: Date, b: Date): boolean;
-/** Clamp `date` into the inclusive `[min, max]` range (either bound optional). */
-declare function clampDate(date: Date, min?: Date | null, max?: Date | null): Date;
-/** Format `date` as an ISO calendar date `YYYY-MM-DD` (local time). */
-declare function formatISODate(date: Date): string;
-/** Parse a `YYYY-MM-DD` string into a local-time `Date`, or `null` if invalid. */
-declare function parseISODate(value: string | null | undefined): Date | null;
-/**
- * Format `date` using a small pattern set. Supported tokens:
- * `yyyy` (4-digit year), `MMMM` (full month), `MMM` (short month),
- * `MM` (2-digit month), `dd` (2-digit day), `d` (day), `ddd` (short weekday),
- * `HH` / `H` (24-hour, padded / bare), `hh` / `h` (12-hour, padded / bare),
- * `mm` (2-digit minutes) and `a` (`AM` / `PM`). Longer tokens are matched
- * first so `MMMM` wins over `MM`. Month/weekday names come from `names` when
- * given, else English.
- */
-declare function formatDate(date: Date, pattern: string, names?: MkDateNames): string;
-/**
- * Build a fixed 6×7 matrix of `Date` cells for `viewDate`'s month, including
- * the leading days from the previous month and trailing days from the next so
- * every row is full. `firstDayOfWeek` is 0 (Sunday) … 6 (Saturday).
- */
-declare function buildMonthMatrix(viewDate: Date, firstDayOfWeek?: number): Date[][];
-/** Full month names, index 0 = January (from `names`, else English). */
-declare function getMonthNames(names?: MkDateNames): readonly string[];
-/**
- * Weekday header labels ordered to start at `firstDayOfWeek`.
- * `format` selects `'short'` (e.g. `Mon`) or `'narrow'` (e.g. `M`).
- * Labels come from `names` when given, else English.
- */
-declare function getWeekdayNames(firstDayOfWeek?: number, format?: 'short' | 'narrow', names?: MkDateNames): string[];
-/** Full weekday name for `date` (for screen-reader labels). */
-declare function getWeekdayFullName(date: Date, names?: MkDateNames): string;
-
 /** Weekday header descriptor (short label + full name for `abbr[title]`). */
 interface MkWeekdayHeader$1 {
     short: string;
@@ -1352,5 +1280,5 @@ declare class MkMiniDate implements ControlValueAccessor, Validator {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkMiniDate, "mk-mini-date", ["mkMiniDate"], { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "order": { "alias": "order"; "required": false; "isSignal": true; }; "yearMin": { "alias": "yearMin"; "required": false; "isSignal": true; }; "yearMax": { "alias": "yearMax"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
-export { MkCalendar, MkDatePicker, MkDateRangePicker, MkDateTimePicker, MkEventCalendar, MkMiniDate, MkMonthPicker, MkTimePicker, MkWeekPicker, addDays, addMonths, buildMonthMatrix, clampDate, endOfMonth, endOfWeek, formatDate, formatISODate, getISOWeek, getMonthNames, getWeekdayFullName, getWeekdayNames, isAfter, isBefore, isSameDay, isSameMonth, parseISODate, startOfDay, startOfMonth, startOfWeek };
-export type { MkCalendarEvent, MkCalendarEventEdit, MkCalendarView, MkDateRange, MkMiniDateOrder, MkMonthPickerMode, MkWeek, MkWeekday };
+export { MkCalendar, MkDatePicker, MkDateRangePicker, MkDateTimePicker, MkEventCalendar, MkMiniDate, MkMonthPicker, MkTimePicker, MkWeekPicker };
+export type { MkCalendarEvent, MkCalendarEventEdit, MkCalendarView, MkDateRange, MkMiniDateOrder, MkMonthPickerMode, MkWeek };

package/types/mk-kit-ui-embed.d.ts

@@ -25,6 +25,20 @@ interface MkEmbedInit {
      * any number of instances), `<style>` elements otherwise.
      */
     styles?: string | readonly string[];
+    /**
+     * Stylesheet URLs loaded as `<link rel="stylesheet">` into every shadow
+     * root (and the overlay host) — an alternative to inlining `styles` when
+     * the theme lives on a CDN. Loaded per shadow root by the browser's cache,
+     * so the network cost is paid once.
+     */
+    styleUrls?: readonly string[];
+    /**
+     * CSP nonce applied to every style and link element this app creates —
+     * including Angular's own component styles (provided as `CSP_NONCE`) and
+     * the `<style>` fallback when constructable stylesheets are unavailable.
+     * For host pages with a `style-src` policy that forbids `'unsafe-inline'`.
+     */
+    nonce?: string;
     /**
      * Extra providers for the shared application — `provideMkI18n(…)`,
      * `provideMkExtendedIcons()`, `provideHttpClient()`, your services.
@@ -111,12 +125,15 @@ declare class MkEmbedApp {
 }
 /**
  * The embed styles, parsed once and shared: constructable stylesheets where
- * supported, cloned `<style>` elements otherwise.
+ * supported, cloned `<style>` elements otherwise, plus `<link>` elements for
+ * `styleUrls`. The nonce lands on every element this class creates.
  */
 declare class MkEmbedStyles {
     private readonly css;
+    private readonly urls;
+    private readonly nonce?;
     private sheets;
-    constructor(css: readonly string[]);
+    constructor(css: readonly string[], urls: readonly string[], nonce?: string | undefined);
     adopt(root: ShadowRoot): void;
 }