@verbb/plugin-kit-web 2.0.0

package/dist/plugin-kit.css

@@ -0,0 +1,583 @@
+/* @verbb/plugin-kit-web/plugin-kit.css — tokens + FOUCE + overlay chrome (flattened for bundlers) */
+/**
+ * Design tokens for Plugin Kit web components.
+ *
+ * Color palette mirrors plugin-kit-react `src/css/core.css` — hard-coded to match
+ * Craft CP and prevent drift. Loaded on :root; custom properties inherit into shadow trees.
+ *
+ * @see https://github.com/verbb/plugin-kit/blob/main/plugin-kit-react/src/css/core.css
+ */
+:root {
+    /* ── Base ─────────────────────────────────────────────────────────────── */
+    --pk-color-white: #fff;
+    --pk-color-black: #000;
+
+    /* Craft CP --link-color (runtime); link buttons prefer var(--link-color) when present. */
+    --pk-color-link: #2563eb;
+    --pk-color-error: #d81f23;
+    --pk-color-success: var(--pk-color-teal-700);
+    --pk-color-warning: var(--pk-color-amber-700);
+
+    /* ── Gray ─────────────────────────────────────────────────────────────── */
+    --pk-color-gray-50: hsl(212, 60%, 97%);
+    --pk-color-gray-100: hsl(212, 50%, 93%);
+    --pk-color-gray-150: hsl(212, 40%, 89%);
+    --pk-color-gray-200: hsl(212, 30%, 85%);
+    --pk-color-gray-250: hsl(211, 20%, 75%);
+    --pk-color-gray-300: hsl(211, 13%, 65%);
+    --pk-color-gray-350: hsl(211, 11%, 59%);
+    --pk-color-gray-400: hsl(210, 10%, 53%);
+    --pk-color-gray-500: hsl(211, 12%, 43%);
+    --pk-color-gray-550: hsl(210, 13%, 40%);
+    --pk-color-gray-600: hsl(209, 14%, 37%);
+    --pk-color-gray-700: hsl(209, 18%, 30%);
+    --pk-color-gray-800: hsl(209, 20%, 25%);
+    --pk-color-gray-900: hsl(210, 24%, 16%);
+    --pk-color-gray-1000: hsl(210, 24%, 10%);
+
+    /* ── Slate (Craft CP blue-gray overlays) ──────────────────────────────── */
+    --pk-color-slate-50: rgba(96, 125, 159, 0.05);
+    --pk-color-slate-100: rgba(96, 125, 159, 0.1);
+    --pk-color-slate-150: rgba(96, 125, 159, 0.15);
+    --pk-color-slate-200: rgba(96, 125, 159, 0.2);
+    --pk-color-slate-250: rgba(96, 125, 159, 0.25);
+    --pk-color-slate-300: rgba(96, 125, 159, 0.3);
+    --pk-color-slate-350: rgba(96, 125, 159, 0.35);
+    --pk-color-slate-400: rgba(96, 125, 159, 0.4);
+    --pk-color-slate-500: rgba(96, 125, 159, 0.5);
+    --pk-color-slate-550: rgba(96, 125, 159, 0.55);
+    --pk-color-slate-600: rgba(96, 125, 159, 0.6);
+    --pk-color-slate-700: rgba(96, 125, 159, 0.7);
+    --pk-color-slate-800: rgba(96, 125, 159, 0.8);
+    --pk-color-slate-900: rgba(96, 125, 159, 0.9);
+    --pk-color-slate-1000: rgba(96, 125, 159, 1);
+
+    /* ── Red ──────────────────────────────────────────────────────────────── */
+    --pk-color-red-50: #fef2f2;
+    --pk-color-red-100: #fee2e2;
+    --pk-color-red-200: #fecaca;
+    --pk-color-red-300: #fca5a5;
+    --pk-color-red-400: #f87171;
+    --pk-color-red-500: #ef4444;
+    --pk-color-red-600: #dc2626;
+    --pk-color-red-700: #b91c1c;
+    --pk-color-red-800: #991b1b;
+    --pk-color-red-900: #7f1d1d;
+    --pk-color-red-950: #450a0a;
+
+    /* ── Orange ───────────────────────────────────────────────────────────── */
+    --pk-color-orange-50: #fff7ed;
+    --pk-color-orange-100: #ffedd5;
+    --pk-color-orange-200: #fed7aa;
+    --pk-color-orange-300: #fdba74;
+    --pk-color-orange-400: #fb923c;
+    --pk-color-orange-500: #f97316;
+    --pk-color-orange-600: #ea580c;
+    --pk-color-orange-700: #c2410c;
+    --pk-color-orange-800: #9a3412;
+    --pk-color-orange-900: #7c2d12;
+    --pk-color-orange-950: #431407;
+
+    /* ── Amber ────────────────────────────────────────────────────────────── */
+    --pk-color-amber-50: #fffbeb;
+    --pk-color-amber-100: #fef3c7;
+    --pk-color-amber-200: #fde68a;
+    --pk-color-amber-300: #fcd34d;
+    --pk-color-amber-400: #fbbf24;
+    --pk-color-amber-500: #f59e0b;
+    --pk-color-amber-600: #d97706;
+    --pk-color-amber-700: #b45309;
+    --pk-color-amber-800: #92400e;
+    --pk-color-amber-900: #78350f;
+    --pk-color-amber-950: #451a03;
+
+    /* ── Yellow ───────────────────────────────────────────────────────────── */
+    --pk-color-yellow-50: #fefce8;
+    --pk-color-yellow-100: #fef9c3;
+    --pk-color-yellow-200: #fef08a;
+    --pk-color-yellow-300: #fde047;
+    --pk-color-yellow-400: #facc15;
+    --pk-color-yellow-500: #eab308;
+    --pk-color-yellow-600: #ca8a04;
+    --pk-color-yellow-700: #a16207;
+    --pk-color-yellow-750: #93580b;
+    --pk-color-yellow-800: #854d0e;
+    --pk-color-yellow-900: #713f12;
+    --pk-color-yellow-950: #422006;
+
+    /* ── Lime ─────────────────────────────────────────────────────────────── */
+    --pk-color-lime-50: #f7fee7;
+    --pk-color-lime-100: #ecfccb;
+    --pk-color-lime-200: #d9f99d;
+    --pk-color-lime-300: #bef264;
+    --pk-color-lime-400: #a3e635;
+    --pk-color-lime-500: #84cc16;
+    --pk-color-lime-600: #65a30d;
+    --pk-color-lime-700: #4d7c0f;
+    --pk-color-lime-800: #3f6212;
+    --pk-color-lime-900: #365314;
+    --pk-color-lime-950: #1a2e05;
+
+    /* ── Green ────────────────────────────────────────────────────────────── */
+    --pk-color-green-050: #f0fdf4;
+    --pk-color-green-100: #dcfce7;
+    --pk-color-green-200: #bbf7d0;
+    --pk-color-green-300: #86efac;
+    --pk-color-green-400: #4ade80;
+    --pk-color-green-500: #22c55e;
+    --pk-color-green-600: #16a34a;
+    --pk-color-green-700: #15803d;
+    --pk-color-green-800: #166534;
+    --pk-color-green-900: #14532d;
+    --pk-color-green-950: #052e16;
+
+    /* ── Emerald ──────────────────────────────────────────────────────────── */
+    --pk-color-emerald-50: #ecfdf5;
+    --pk-color-emerald-100: #d1fae5;
+    --pk-color-emerald-200: #a7f3d0;
+    --pk-color-emerald-300: #6ee7b7;
+    --pk-color-emerald-400: #34d399;
+    --pk-color-emerald-500: #10b981;
+    --pk-color-emerald-600: #059669;
+    --pk-color-emerald-700: #047857;
+    --pk-color-emerald-800: #065f46;
+    --pk-color-emerald-900: #064e3b;
+    --pk-color-emerald-950: #022c22;
+
+    /* ── Teal ─────────────────────────────────────────────────────────────── */
+    --pk-color-teal-50: #f0fdfa;
+    --pk-color-teal-100: #ccfbf1;
+    --pk-color-teal-200: #99f6e4;
+    --pk-color-teal-300: #5eead4;
+    --pk-color-teal-400: #2dd4bf;
+    --pk-color-teal-500: #14b8a6;
+    --pk-color-teal-550: #11a697;
+    --pk-color-teal-600: #0d9488;
+    --pk-color-teal-700: #0f766e;
+    --pk-color-teal-800: #115e59;
+    --pk-color-teal-900: #134e4a;
+    --pk-color-teal-950: #042f2e;
+    /* Lightswitch checked inset border — hard-coded in React Lightswitch.tsx */
+    --pk-color-teal-550-border: #008779;
+
+    /* ── Cyan ─────────────────────────────────────────────────────────────── */
+    --pk-color-cyan-50: #ecfeff;
+    --pk-color-cyan-100: #cffafe;
+    --pk-color-cyan-200: #a5f3fc;
+    --pk-color-cyan-300: #67e8f9;
+    --pk-color-cyan-400: #22d3ee;
+    --pk-color-cyan-500: #06b6d4;
+    --pk-color-cyan-600: #0891b2;
+    --pk-color-cyan-700: #0e7490;
+    --pk-color-cyan-800: #155e75;
+    --pk-color-cyan-900: #164e63;
+    --pk-color-cyan-950: #083344;
+
+    /* ── Sky ──────────────────────────────────────────────────────────────── */
+    --pk-color-sky-50: #f0f9ff;
+    --pk-color-sky-100: #e0f2fe;
+    --pk-color-sky-200: #bae6fd;
+    --pk-color-sky-300: #7dd3fc;
+    --pk-color-sky-400: #38bdf8;
+    --pk-color-sky-500: #0ea5e9;
+    --pk-color-sky-600: #0284c7;
+    --pk-color-sky-700: #0369a1;
+    --pk-color-sky-800: #075985;
+    --pk-color-sky-900: #0c4a6e;
+    --pk-color-sky-950: #082f49;
+
+    /* ── Blue ─────────────────────────────────────────────────────────────── */
+    --pk-color-blue-50: #eff6ff;
+    --pk-color-blue-100: #dbeafe;
+    --pk-color-blue-200: #bfdbfe;
+    --pk-color-blue-300: #93c5fd;
+    --pk-color-blue-400: #60a5fa;
+    --pk-color-blue-500: #3b82f6;
+    --pk-color-blue-600: #2563eb;
+    --pk-color-blue-700: #1d4ed8;
+    --pk-color-blue-800: #1e40af;
+    --pk-color-blue-900: #1e3a8a;
+    --pk-color-blue-950: #172554;
+
+    /* ── Indigo ───────────────────────────────────────────────────────────── */
+    --pk-color-indigo-50: #eef2ff;
+    --pk-color-indigo-100: #e0e7ff;
+    --pk-color-indigo-200: #c7d2fe;
+    --pk-color-indigo-300: #a5b4fc;
+    --pk-color-indigo-400: #818cf8;
+    --pk-color-indigo-500: #6366f1;
+    --pk-color-indigo-600: #4f46e5;
+    --pk-color-indigo-700: #4338ca;
+    --pk-color-indigo-800: #3730a3;
+    --pk-color-indigo-900: #312e81;
+    --pk-color-indigo-950: #1e1b4b;
+
+    /* ── Violet ───────────────────────────────────────────────────────────── */
+    --pk-color-violet-50: #f5f3ff;
+    --pk-color-violet-100: #ede9fe;
+    --pk-color-violet-200: #ddd6fe;
+    --pk-color-violet-300: #c4b5fd;
+    --pk-color-violet-400: #a78bfa;
+    --pk-color-violet-500: #8b5cf6;
+    --pk-color-violet-600: #7c3aed;
+    --pk-color-violet-700: #6d28d9;
+    --pk-color-violet-800: #5b21b6;
+    --pk-color-violet-900: #4c1d95;
+    --pk-color-violet-950: #2e1065;
+
+    /* ── Purple ───────────────────────────────────────────────────────────── */
+    --pk-color-purple-50: #faf5ff;
+    --pk-color-purple-100: #f3e8ff;
+    --pk-color-purple-200: #e9d5ff;
+    --pk-color-purple-300: #d8b4fe;
+    --pk-color-purple-400: #c084fc;
+    --pk-color-purple-500: #a855f7;
+    --pk-color-purple-600: #9333ea;
+    --pk-color-purple-700: #7e22ce;
+    --pk-color-purple-800: #6b21a8;
+    --pk-color-purple-900: #581c87;
+    --pk-color-purple-950: #3b0764;
+
+    /* ── Fuchsia ──────────────────────────────────────────────────────────── */
+    --pk-color-fuchsia-50: #fdf4ff;
+    --pk-color-fuchsia-100: #fae8ff;
+    --pk-color-fuchsia-200: #f5d0fe;
+    --pk-color-fuchsia-300: #f0abfc;
+    --pk-color-fuchsia-400: #e879f9;
+    --pk-color-fuchsia-500: #d946ef;
+    --pk-color-fuchsia-600: #c026d3;
+    --pk-color-fuchsia-700: #a21caf;
+    --pk-color-fuchsia-800: #86198f;
+    --pk-color-fuchsia-900: #701a75;
+    --pk-color-fuchsia-950: #4a044e;
+
+    /* ── Pink ─────────────────────────────────────────────────────────────── */
+    --pk-color-pink-50: #fdf2f8;
+    --pk-color-pink-100: #fce7f3;
+    --pk-color-pink-200: #fbcfe8;
+    --pk-color-pink-300: #f9a8d4;
+    --pk-color-pink-400: #f472b6;
+    --pk-color-pink-500: #ec4899;
+    --pk-color-pink-600: #db2777;
+    --pk-color-pink-700: #be185d;
+    --pk-color-pink-800: #9d174d;
+    --pk-color-pink-900: #831843;
+    --pk-color-pink-950: #500724;
+
+    /* ── Rose ─────────────────────────────────────────────────────────────── */
+    --pk-color-rose-50: #fff1f2;
+    --pk-color-rose-100: #ffe4e6;
+    --pk-color-rose-200: #fecdd3;
+    --pk-color-rose-300: #fda4af;
+    --pk-color-rose-400: #fb7185;
+    --pk-color-rose-500: #f43f5e;
+    --pk-color-rose-600: #e11d48;
+    --pk-color-rose-700: #be123c;
+    --pk-color-rose-800: #9f1239;
+    --pk-color-rose-900: #881337;
+    --pk-color-rose-950: #4c0519;
+
+    /* ── Radius ───────────────────────────────────────────────────────────── */
+    --pk-radius-xs: 2px;
+    --pk-radius-sm: 3px;
+    --pk-radius-md: 4px;
+    --pk-radius-lg: 5px;
+
+    /* ── Shadows ──────────────────────────────────────────────────────────── */
+    --pk-shadow-focus: 0 0 0 2px var(--pk-color-sky-600), 0 0 5px 1px hsl(from var(--pk-color-sky-600) h s l / 0.7);
+    --pk-shadow-focus-inset: 0 0 0 1px #fff, 0 0 0 3px var(--pk-color-sky-600), 0 0 5px 1px hsl(from var(--pk-color-sky-600) h s l / 0.7);
+    --pk-shadow-popup: 0 0 0 1px rgba(31, 41, 51, 0.1), 0 5px 20px rgba(31, 41, 51, 0.25);
+    /* Craft menu/popover elevation — hairline ring + deep soft drop. */
+    --pk-shadow-popover: 0 0 0 1px hsl(from hsl(210, 10%, 53%) h s l / 25%), 0 25px 100px hsl(from hsl(210, 24%, 16%) h s l / 50%);
+    --pk-shadow-modal: 0 0 0 1px color-mix(in oklab, var(--pk-color-gray-400) 25%, transparent), 0 25px 100px color-mix(in oklab, var(--pk-color-gray-900) 50%, transparent);
+
+    /* ── Typography ───────────────────────────────────────────────────────── */
+    --pk-font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+    /* Mono: 0.9em face + 1.5 line-height so content-box height stays stable in inputs. */
+    --pk-font-family-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+    --pk-font-size-mono: 0.9em;
+    --pk-line-height-mono: 1.5;
+    --pk-font-size-sm: 13px;
+    --pk-font-size-base: 14px;
+    --pk-line-height: 1.4;
+
+    /* ── Form controls ────────────────────────────────────────────────────── */
+    --pk-checkbox-size: 1rem;
+    --pk-radio-size: 1rem;
+    /*
+     * Reference height for tables / min-heights (aliases Craft button default).
+     * Single-line pk-input / select / combobox size from padding + --pk-input-control-line-height
+     * (v1 text-sm + py-1.5), not from this token as a fixed shell height.
+     */
+    --pk-input-height: var(--pk-btn-height-default);
+    /* v1 Tailwind text-sm line box — with 6px block padding + 1px border → 34px. */
+    --pk-input-control-line-height: 1.25rem;
+    --pk-input-border-color: var(--pk-color-slate-400);
+    --pk-input-border: 1px solid var(--pk-input-border-color);
+    --pk-input-border-radius: var(--pk-radius-sm);
+    --pk-input-bg: rgb(251, 252, 254);
+    --pk-input-placeholder-color: var(--pk-color-gray-400);
+    /* Focus ring sits outside the resting border (do not also set border-color on focus). */
+    --pk-input-focus-shadow: 0 0 0 1px var(--pk-color-sky-600), 0 0 4px 0 hsl(from var(--pk-color-sky-600) h s l / 0.7);
+    /* Invalid + focus: rose ring (kit convention; Craft CP uses sky --focus-ring even on .error). */
+    --pk-input-invalid-focus-shadow: 0 0 0 1px var(--pk-color-rose-600), 0 0 4px 0 hsl(from var(--pk-color-rose-600) h s l / 0.7);
+    --pk-input-mono-font-family: var(--pk-font-family-mono);
+    --pk-input-mono-font-size: var(--pk-font-size-mono);
+    --pk-input-mono-line-height: var(--pk-line-height-mono);
+    --pk-textarea-border-radius: var(--pk-radius-md);
+    --pk-checkbox-border-color: #c0cbd9;
+    --pk-control-label-gap: 0.35rem;
+
+    /* ── Button icons ─────────────────────────────────────────────────────── */
+    /* Icon↔label gap scales with size — small buttons stay tight, large ones breathe. */
+    --pk-btn-icon-gap-xxs: 4px;
+    --pk-btn-icon-gap-xs: 4px;
+    --pk-btn-icon-gap-sm: 5px;
+    --pk-btn-icon-gap-default: 6px;
+    --pk-btn-icon-gap-lg: 7px;
+    --pk-btn-icon-gap-xl: 8px;
+    /* Alias for non-component button surfaces. */
+    --pk-btn-icon-gap: var(--pk-btn-icon-gap-default);
+
+    /* Caret (dropdown affordance) — deliberately smaller than the start/end icon at every size. */
+    --pk-btn-caret-size-xxs: 10px;
+    --pk-btn-caret-size-xs: 11px;
+    --pk-btn-caret-size-sm: 11px;
+    --pk-btn-caret-size-default: 12px;
+    --pk-btn-caret-size-lg: 13px;
+    --pk-btn-caret-size-xl: 14px;
+
+    /* Button scale — +4px height steps; default matches Craft CP (2.125rem / 34px).
+     * Block size is fixed; vertical centering uses padding-block: 0 + padding-inline.
+     */
+    --pk-btn-height-xxs: 1.375rem;
+    --pk-btn-height-xs: 1.625rem;
+    --pk-btn-height-sm: 1.875rem;
+    --pk-btn-height-default: 2.125rem;
+    --pk-btn-height-lg: 2.375rem;
+    --pk-btn-height-xl: 2.625rem;
+
+    --pk-btn-font-xxs: 11px;
+    --pk-btn-font-xs: 12px;
+    --pk-btn-font-sm: 13px;
+    --pk-btn-font-default: var(--pk-font-size-base);
+    --pk-btn-font-lg: var(--pk-font-size-base);
+    --pk-btn-font-xl: 1rem;
+
+    --pk-btn-padding-inline-xxs: 5px;
+    --pk-btn-padding-inline-xs: 7px;
+    --pk-btn-padding-inline-sm: 8px;
+    --pk-btn-padding-inline-default: 9px;
+    --pk-btn-padding-inline-lg: 12px;
+    --pk-btn-padding-inline-xl: 15px;
+
+    --pk-btn-icon-size-xxs: 10px;
+    --pk-btn-icon-size-xs: 11px;
+    --pk-btn-icon-size-sm: 13px;
+    --pk-btn-icon-size-default: 14px;
+    --pk-btn-icon-size-lg: 14px;
+    --pk-btn-icon-size-xl: 16px;
+
+    --pk-btn-radius-xxs: var(--pk-radius-sm);
+    --pk-btn-radius-xs: var(--pk-radius-sm);
+    --pk-btn-radius-sm: var(--pk-radius-md);
+    --pk-btn-radius-default: var(--pk-radius-lg);
+    --pk-btn-radius-lg: var(--pk-radius-lg);
+    --pk-btn-radius-xl: var(--pk-radius-lg);
+
+    /* Semantic aliases — components map variant → these roles */
+    --pk-action-fill: var(--pk-color-slate-250);
+    --pk-action-fill-hover: var(--pk-color-slate-300);
+    --pk-action-fill-active: var(--pk-color-slate-400);
+    --pk-action-on: var(--pk-color-gray-700);
+
+    --pk-action-primary-fill: var(--pk-color-red-600);
+    --pk-action-primary-fill-hover: var(--pk-color-red-700);
+    --pk-action-primary-fill-active: var(--pk-color-red-800);
+    --pk-action-primary-on: var(--pk-color-white);
+}
+
+/* Scroll lock — class is a state marker; locking logic lives in a11y/scroll-lock.ts.
+ * Do NOT pad body for the scrollbar: that shifts position:fixed Craft/playground chrome.
+ * Prefer permanent stable gutter so Path A succeeds more often. */
+html {
+    scrollbar-gutter: stable;
+}
+
+html.pk-scroll-lock {
+    --pk-scroll-lock: 1;
+}
+
+@layer pk-utilities {
+    /*
+     * FOUCE (Flash of Undefined Custom Elements) prevention.
+     *
+     * GENERATED FILE — do not edit by hand.
+     * Run `npm run gen:fouce` after changing the component registry.
+     */
+
+    /* Tier 1a: reserve space for in-flow pk-* elements until they upgrade. */
+    :is(
+        pk-spinner,
+        pk-icon,
+        pk-button,
+        pk-checkbox,
+        pk-checkbox-select,
+        pk-color-input,
+        pk-code-editor,
+        pk-input,
+        pk-input-group,
+        pk-input-group-addon,
+        pk-input-group-button,
+        pk-input-group-input,
+        pk-input-group-text,
+        pk-input-group-textarea,
+        pk-textarea,
+        pk-tiptap-editor,
+        pk-tiptap-input,
+        pk-tiptap-content,
+        pk-field,
+        pk-separator,
+        pk-status,
+        pk-toggle,
+        pk-toggle-group,
+        pk-lightswitch,
+        pk-button-group,
+        pk-button-group-separator,
+        pk-button-group-text,
+        pk-dropdown-label,
+        pk-dropdown-item,
+        pk-dropdown-separator,
+        pk-radio,
+        pk-radio-group,
+        pk-tab,
+        pk-tab-heading,
+        pk-tab-panel,
+        pk-tabs,
+        pk-scroll-area,
+        pk-option,
+        pk-option-group,
+        pk-select,
+        pk-calendar,
+        pk-date-picker,
+        pk-combobox,
+        pk-time-picker,
+        pk-copy-button,
+        pk-editable-table
+    ):not(:defined) {
+        animation: 2s step-end pk-fouce;
+    }
+
+    /* Tier 1b: collapse out-of-flow overlays until they upgrade. */
+    :is(
+        pk-dialog,
+        pk-popup
+    ):not(:defined) {
+        display: none;
+    }
+
+    /*
+     * Tier 1c: trigger + overlay components. The host reserves space for the
+     * trigger (tier 1a), but the overlay panel content (default-slot children)
+     * only shows on interaction — collapse it so we don't reserve a wrong-sized
+     * box that shifts the layout on upgrade.
+     */
+    :is(
+        pk-dropdown-menu,
+        pk-popover,
+        pk-tooltip
+    ):not(:defined) > :not([slot='trigger']) {
+        display: none;
+    }
+
+    /*
+     * Tier 1d: listbox-style controls (select, combobox, …). Reserve the control
+     * host (tier 1a), but collapse the default-slot option list so it can never
+     * dump into the flow — including after the 2s reserve cap. Named-slot
+     * decorations are left alone.
+     */
+    :is(
+        pk-select,
+        pk-combobox,
+        pk-time-picker,
+        pk-checkbox-select
+    ):not(:defined) > :not([slot]) {
+        display: none;
+    }
+
+    /* Tier 2: hide a wrapper/page until all pk-* descendants upgrade. */
+    .pk-cloak:has(:not(:defined)) {
+        animation: 2s step-end pk-fouce;
+    }
+
+    @keyframes pk-fouce {
+        from {
+            visibility: hidden;
+        }
+    }
+}
+
+/**
+ * Light-DOM overlay content styles (dialog panels, etc.).
+ * Loaded in dev / CP shell — not bundled into every component shadow tree.
+ */
+.pk-dialog__header {
+    position: relative;
+    display: flex;
+    flex-shrink: 0;
+    flex-direction: column;
+    gap: 0.25rem;
+    padding: 1rem;
+    border-bottom: 1px solid var(--pk-color-gray-150);
+    border-radius: var(--pk-radius-lg) var(--pk-radius-lg) 0 0;
+    background: #f3f7fb;
+    text-align: left;
+}
+
+.pk-dialog__title {
+    margin: 0;
+    font-size: 0.9375rem;
+    font-weight: 600;
+    line-height: 1.2;
+    /* Craft CP body/title text (~gray-700), not gray-900. */
+    color: var(--pk-color-gray-700);
+}
+
+.pk-dialog__body {
+    padding: 1rem;
+    font-size: var(--pk-font-size-sm);
+    line-height: 1.5;
+    color: var(--pk-color-gray-600);
+}
+
+.pk-dialog__footer {
+    display: flex;
+    flex-direction: row;
+    justify-content: flex-end;
+    gap: 0.5rem;
+    padding: 0.625rem 1rem;
+    border-top: 1px solid var(--pk-color-gray-150);
+    border-radius: 0 0 var(--pk-radius-lg) var(--pk-radius-lg);
+    background: #e4edf6;
+}
+
+.pk-dialog__close {
+    --pk-dialog-close-focus-padding: 0.25rem;
+    position: absolute;
+    top: calc(1rem - var(--pk-dialog-close-focus-padding));
+    right: calc(1rem - var(--pk-dialog-close-focus-padding));
+    opacity: 0.7;
+    line-height: 1;
+    --pk-btn-padding-inline: var(--pk-dialog-close-focus-padding);
+    --pk-btn-height: calc(1.125rem + 2 * var(--pk-dialog-close-focus-padding));
+    --pk-btn-font: 1.125rem;
+    --pk-btn-radius: var(--pk-radius-sm);
+}
+
+.pk-dialog__close:hover {
+    opacity: 1;
+}
+
+.pk-dialog__close:focus-visible {
+    opacity: 1;
+}

package/dist/plugin-kit.d.ts

@@ -0,0 +1,9 @@
+export { allDefined, type AllDefinedOptions } from './utilities/defined.js';
+export { discover, DISCOVERY_COMPLETE_EVENT, FOUCE_TIMEOUT_MS, preventTurboFouce, startLoader, stopLoader, } from './utilities/autoloader.js';
+export { getBasePath, setBasePath } from './utilities/base-path.js';
+export { configurePluginKitWeb, type PluginKitWebConfig } from './utils/config.js';
+export { setPortalClassName, setPortalContainer, type PortalContainer, } from './utils/portal.js';
+export { BUNDLER_TAG_IMPORT_PATHS as componentImportPaths, type PkComponentTag } from './component-registry.js';
+export { diagnoseOverlayBlockers, recoverOverlays, type OverlayDiagnostic, type OverlayRecoveryResult, } from './utils/overlay-recovery.js';
+export { mountShadowApp, type MountShadowAppOptions, type ShadowAppMount, } from './utils/mount-shadow-app.js';
+//# sourceMappingURL=plugin-kit.d.ts.map

package/dist/plugin-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-kit.d.ts","sourceRoot":"","sources":["../src/plugin-kit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EACH,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,wBAAwB,IAAI,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAChH,OAAO,EACH,uBAAuB,EACvB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACtB,MAAM,6BAA6B,CAAC"}