From 93f0ca30ebfc3dc0c607c68f2f8f10663e676829 Mon Sep 17 00:00:00 2001
From: David Rios <david.rios@uipath.com>
Date: Thu, 25 Jun 2026 15:08:00 -0400
Subject: [PATCH 1/3] feat(apollo-wind): add shadow DOM CSS injection utilities
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Browsers silently ignore @property rules inside shadow DOM <style>
elements, breaking Tailwind v4 composable utilities (border, shadow,
ring, translate). Every shadow DOM consumer was reimplementing the same
inject + register dance.

New exports:
- injectTailwindIntoShadowRoot(root, css) — injects stylesheet + registers @property rules
- hasApolloWindCss(root) — two-level detection (tag check + computed-style probes)
- TAILWIND_INJECT_ATTR — sentinel attribute constant
---
 packages/apollo-wind/src/index.ts             |   6 +
 packages/apollo-wind/src/lib/index.ts         |   6 +
 .../register-shadow-dom-properties.test.ts    |  58 +++++++
 .../src/lib/register-shadow-dom-properties.ts |  44 ++++++
 .../src/lib/shadow-dom-css.test.ts            | 147 ++++++++++++++++++
 .../apollo-wind/src/lib/shadow-dom-css.ts     |  81 ++++++++++
 6 files changed, 342 insertions(+)
 create mode 100644 packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts
 create mode 100644 packages/apollo-wind/src/lib/register-shadow-dom-properties.ts
 create mode 100644 packages/apollo-wind/src/lib/shadow-dom-css.test.ts
 create mode 100644 packages/apollo-wind/src/lib/shadow-dom-css.ts

diff --git a/packages/apollo-wind/src/index.ts b/packages/apollo-wind/src/index.ts
index 12d90f7d3..40ac13157 100644
--- a/packages/apollo-wind/src/index.ts
+++ b/packages/apollo-wind/src/index.ts
@@ -6,6 +6,12 @@
 // Utilities
 // -----------------------------------------------------------------------------
 export { cn } from './lib/utils';
+export { registerCssPropertyRules } from './lib/register-shadow-dom-properties';
+export {
+  injectTailwindIntoShadowRoot,
+  hasApolloWindCss,
+  TAILWIND_INJECT_ATTR,
+} from './lib/shadow-dom-css';
 
 // -----------------------------------------------------------------------------
 // Layout Components
diff --git a/packages/apollo-wind/src/lib/index.ts b/packages/apollo-wind/src/lib/index.ts
index e85b6f5ae..6edeca08b 100644
--- a/packages/apollo-wind/src/lib/index.ts
+++ b/packages/apollo-wind/src/lib/index.ts
@@ -1 +1,7 @@
 export { cn, get, deepEqual } from './utils';
+export { registerCssPropertyRules } from './register-shadow-dom-properties';
+export {
+  injectTailwindIntoShadowRoot,
+  hasApolloWindCss,
+  TAILWIND_INJECT_ATTR,
+} from './shadow-dom-css';
diff --git a/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts b/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts
new file mode 100644
index 000000000..ce6f51b92
--- /dev/null
+++ b/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts
@@ -0,0 +1,58 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { registerCssPropertyRules } from './register-shadow-dom-properties';
+
+const SELECTOR = 'style[data-tw-property-rules]';
+
+const SAMPLE_CSS = `
+@layer base { .border { border-style: var(--tw-border-style); border-width: 1px; } }
+@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}
+@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}
+@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}
+.bg-popover { background-color: var(--popover); }
+`;
+
+beforeEach(() => {
+  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
+});
+
+afterEach(() => {
+  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
+});
+
+describe('registerCssPropertyRules', () => {
+  it('extracts @property rules from CSS and injects them into document.head', () => {
+    registerCssPropertyRules(SAMPLE_CSS);
+
+    const style = document.querySelector(SELECTOR);
+    expect(style).not.toBeNull();
+
+    const text = style?.textContent ?? '';
+    expect(text).toContain('@property --tw-border-style');
+    expect(text).toContain('@property --tw-shadow');
+    expect(text).toContain('@property --tw-translate-x');
+  });
+
+  it('does not include non-@property rules', () => {
+    registerCssPropertyRules(SAMPLE_CSS);
+
+    const text = document.querySelector(SELECTOR)?.textContent ?? '';
+    expect(text).not.toContain('.border');
+    expect(text).not.toContain('.bg-popover');
+    expect(text).not.toContain('@layer');
+  });
+
+  it('injects only one style element when called multiple times', () => {
+    registerCssPropertyRules(SAMPLE_CSS);
+    registerCssPropertyRules(SAMPLE_CSS);
+    registerCssPropertyRules(SAMPLE_CSS);
+
+    const elements = document.querySelectorAll(SELECTOR);
+    expect(elements).toHaveLength(1);
+  });
+
+  it('does nothing when CSS has no @property rules', () => {
+    registerCssPropertyRules('.flex { display: flex; }');
+
+    expect(document.querySelector(SELECTOR)).toBeNull();
+  });
+});
diff --git a/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts b/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts
new file mode 100644
index 000000000..df92bf523
--- /dev/null
+++ b/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts
@@ -0,0 +1,44 @@
+/**
+ * Extract `@property` at-rules from a CSS string and inject them into
+ * `document.head` so they register at the global scope.
+ *
+ * Browsers silently ignore `@property` rules inside shadow DOM `<style>`
+ * elements, breaking Tailwind v4 utilities that chain through `--tw-*`
+ * variables (`border`, `shadow-*`, `ring-*`, `translate-*`, etc.).
+ *
+ * This is an internal helper — consumers should use
+ * {@link injectTailwindIntoShadowRoot} which calls this automatically.
+ *
+ * @see https://github.com/tailwindlabs/tailwindcss/discussions/16772
+ * @internal
+ */
+
+const MARKER = 'data-tw-property-rules';
+const NEEDLE = '@property';
+
+function extractPropertyRules(css: string): string[] {
+  const rules: string[] = [];
+  let pos = 0;
+  while ((pos = css.indexOf(NEEDLE, pos)) !== -1) {
+    const open = css.indexOf('{', pos);
+    if (open === -1) break;
+    const close = css.indexOf('}', open);
+    if (close === -1) break;
+    rules.push(css.slice(pos, close + 1));
+    pos = close + 1;
+  }
+  return rules;
+}
+
+export function registerCssPropertyRules(css: string): void {
+  if (typeof document === 'undefined') return;
+  if (document.querySelector(`style[${MARKER}]`)) return;
+
+  const rules = extractPropertyRules(css);
+  if (rules.length === 0) return;
+
+  const style = document.createElement('style');
+  style.setAttribute(MARKER, '');
+  style.textContent = rules.join('\n');
+  document.head.appendChild(style);
+}
diff --git a/packages/apollo-wind/src/lib/shadow-dom-css.test.ts b/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
new file mode 100644
index 000000000..b36bc8825
--- /dev/null
+++ b/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
@@ -0,0 +1,147 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import {
+  hasApolloWindCss,
+  injectTailwindIntoShadowRoot,
+  TAILWIND_INJECT_ATTR,
+} from './shadow-dom-css';
+
+const SELECTOR = `style[${TAILWIND_INJECT_ATTR}]`;
+const PROPERTY_SELECTOR = 'style[data-tw-property-rules]';
+
+const SAMPLE_CSS = `
+@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}
+.flex { display: flex; }
+.grid { display: grid; }
+`;
+
+function createShadowHost(): { host: HTMLElement; root: ShadowRoot } {
+  const host = document.createElement('div');
+  document.body.appendChild(host);
+  const root = host.attachShadow({ mode: 'open' });
+  return { host, root };
+}
+
+beforeEach(() => {
+  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
+  document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => el.remove());
+});
+
+afterEach(() => {
+  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
+  document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => el.remove());
+  document
+    .querySelectorAll('div')
+    .forEach((el) => el.parentNode?.removeChild(el));
+});
+
+describe('injectTailwindIntoShadowRoot', () => {
+  it('creates a style element in the shadow root', () => {
+    const { host, root } = createShadowHost();
+
+    const style = injectTailwindIntoShadowRoot(root, SAMPLE_CSS);
+
+    expect(style).not.toBeNull();
+    expect(style?.parentNode).toBe(root);
+    expect(style?.textContent).toBe(SAMPLE_CSS);
+    expect(style?.getAttribute(TAILWIND_INJECT_ATTR)).toBe('');
+
+    host.remove();
+  });
+
+  it('prepends the style element (before existing content)', () => {
+    const { host, root } = createShadowHost();
+    const existing = document.createElement('div');
+    root.appendChild(existing);
+
+    injectTailwindIntoShadowRoot(root, SAMPLE_CSS);
+
+    expect(root.firstChild).toBeInstanceOf(HTMLStyleElement);
+
+    host.remove();
+  });
+
+  it('registers @property rules at the document level', () => {
+    const { host, root } = createShadowHost();
+
+    injectTailwindIntoShadowRoot(root, SAMPLE_CSS);
+
+    const propertyStyle = document.querySelector(PROPERTY_SELECTOR);
+    expect(propertyStyle).not.toBeNull();
+    expect(propertyStyle?.textContent).toContain('@property --tw-border-style');
+
+    host.remove();
+  });
+
+  it('returns null and skips injection when already present', () => {
+    const { host, root } = createShadowHost();
+
+    const first = injectTailwindIntoShadowRoot(root, SAMPLE_CSS);
+    const second = injectTailwindIntoShadowRoot(root, SAMPLE_CSS);
+
+    expect(first).not.toBeNull();
+    expect(second).toBeNull();
+    expect(root.querySelectorAll(SELECTOR)).toHaveLength(1);
+
+    host.remove();
+  });
+
+  it('injects into separate shadow roots independently', () => {
+    const host1 = document.createElement('div');
+    const host2 = document.createElement('div');
+    document.body.appendChild(host1);
+    document.body.appendChild(host2);
+    const root1 = host1.attachShadow({ mode: 'open' });
+    const root2 = host2.attachShadow({ mode: 'open' });
+
+    const style1 = injectTailwindIntoShadowRoot(root1, SAMPLE_CSS);
+    const style2 = injectTailwindIntoShadowRoot(root2, SAMPLE_CSS);
+
+    expect(style1).not.toBeNull();
+    expect(style2).not.toBeNull();
+
+    host1.remove();
+    host2.remove();
+  });
+});
+
+describe('hasApolloWindCss', () => {
+  it('returns true when data-tailwind-inject tag exists in document', () => {
+    const style = document.createElement('style');
+    style.setAttribute(TAILWIND_INJECT_ATTR, '');
+    document.head.appendChild(style);
+
+    expect(hasApolloWindCss(document)).toBe(true);
+
+    style.remove();
+  });
+
+  it('returns true when data-tailwind-inject tag exists in shadow root', () => {
+    const { host, root } = createShadowHost();
+
+    injectTailwindIntoShadowRoot(root, SAMPLE_CSS);
+
+    expect(hasApolloWindCss(root)).toBe(true);
+
+    host.remove();
+  });
+
+  it('returns false when no styles are present', () => {
+    // jsdom does not apply CSS rulesets, so computed-style probes fail —
+    // correct fail-closed behavior (inject redundantly rather than skip).
+    expect(hasApolloWindCss(document)).toBe(false);
+  });
+
+  it('returns false for an empty shadow root', () => {
+    const { host, root } = createShadowHost();
+
+    expect(hasApolloWindCss(root)).toBe(false);
+
+    host.remove();
+  });
+});
+
+describe('TAILWIND_INJECT_ATTR', () => {
+  it('equals data-tailwind-inject', () => {
+    expect(TAILWIND_INJECT_ATTR).toBe('data-tailwind-inject');
+  });
+});
diff --git a/packages/apollo-wind/src/lib/shadow-dom-css.ts b/packages/apollo-wind/src/lib/shadow-dom-css.ts
new file mode 100644
index 000000000..b8f64ffdc
--- /dev/null
+++ b/packages/apollo-wind/src/lib/shadow-dom-css.ts
@@ -0,0 +1,81 @@
+import { registerCssPropertyRules } from './register-shadow-dom-properties';
+
+export const TAILWIND_INJECT_ATTR = 'data-tailwind-inject';
+
+const PROBES: ReadonlyArray<{
+  className: string;
+  property: string;
+  expected: string;
+}> = [
+  { className: 'grid', property: 'display', expected: 'grid' },
+  { className: 'flex', property: 'display', expected: 'flex' },
+  { className: 'hidden', property: 'display', expected: 'none' },
+  { className: 'relative', property: 'position', expected: 'relative' },
+];
+
+/**
+ * Returns true if apollo-wind Tailwind CSS rules are in scope inside the given
+ * root (so injection would be redundant). Two checks:
+ *
+ *  1. Fast path: look for a `<style data-tailwind-inject>` tag already present.
+ *  2. Computed-style probe: apply several known apollo-wind utility classes to a
+ *     temp div and require ALL of them to produce their expected computed value.
+ *     Consensus prevents a stray single-class definition from false-positiving
+ *     into skipping a needed injection.
+ *
+ * NOTE: we deliberately do NOT probe a custom property (e.g. `--surface`).
+ * Custom properties inherit across the shadow boundary, so a host that ships
+ * apollo-wind globally in the light DOM would false-positive — the bridge
+ * variables reach the shadow root via inheritance even though the utility
+ * *rulesets* (which do NOT cross the boundary) are absent.
+ */
+export function hasApolloWindCss(root: Document | ShadowRoot): boolean {
+  if (root.querySelector(`style[${TAILWIND_INJECT_ATTR}]`)) {
+    return true;
+  }
+
+  const probeParent = root instanceof Document ? root.body : root;
+  const probe = document.createElement('div');
+  probeParent.appendChild(probe);
+
+  try {
+    const computed = getComputedStyle(probe);
+    return PROBES.every((p) => {
+      probe.className = p.className;
+      return computed.getPropertyValue(p.property) === p.expected;
+    });
+  } finally {
+    probe.remove();
+  }
+}
+
+/**
+ * Inject an apollo-wind Tailwind stylesheet into a shadow root and register
+ * `@property` rules at the document level. No-ops if a `data-tailwind-inject`
+ * style tag is already present in the root.
+ *
+ * Returns the created `<style>` element, or `null` if injection was skipped.
+ *
+ * @example
+ * ```ts
+ * import { injectTailwindIntoShadowRoot } from '@uipath/apollo-wind';
+ * import css from '@uipath/apollo-react/canvas/styles/tailwind.canvas.css?raw';
+ *
+ * // In a web component's connectedCallback:
+ * const shadow = this.attachShadow({ mode: 'open' });
+ * injectTailwindIntoShadowRoot(shadow, css);
+ * ```
+ */
+export function injectTailwindIntoShadowRoot(
+  root: ShadowRoot,
+  css: string,
+): HTMLStyleElement | null {
+  if (root.querySelector(`style[${TAILWIND_INJECT_ATTR}]`)) return null;
+
+  const style = document.createElement('style');
+  style.setAttribute(TAILWIND_INJECT_ATTR, '');
+  style.textContent = css;
+  root.prepend(style);
+  registerCssPropertyRules(css);
+  return style;
+}

From 72a6254a5a2004531b2c64d5942b0dd61736ab8c Mon Sep 17 00:00:00 2001
From: David Rios <david.rios@uipath.com>
Date: Thu, 25 Jun 2026 15:11:29 -0400
Subject: [PATCH 2/3] chore(apollo-wind): update barrels

---
 packages/apollo-wind/src/index.ts                  |  1 -
 packages/apollo-wind/src/lib/index.ts              |  1 -
 .../src/lib/register-shadow-dom-properties.test.ts |  4 ++--
 .../src/lib/register-shadow-dom-properties.ts      |  6 +++---
 .../apollo-wind/src/lib/shadow-dom-css.test.ts     | 14 ++++++--------
 5 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/packages/apollo-wind/src/index.ts b/packages/apollo-wind/src/index.ts
index 40ac13157..835859f57 100644
--- a/packages/apollo-wind/src/index.ts
+++ b/packages/apollo-wind/src/index.ts
@@ -6,7 +6,6 @@
 // Utilities
 // -----------------------------------------------------------------------------
 export { cn } from './lib/utils';
-export { registerCssPropertyRules } from './lib/register-shadow-dom-properties';
 export {
   injectTailwindIntoShadowRoot,
   hasApolloWindCss,
diff --git a/packages/apollo-wind/src/lib/index.ts b/packages/apollo-wind/src/lib/index.ts
index 6edeca08b..8b2d7d406 100644
--- a/packages/apollo-wind/src/lib/index.ts
+++ b/packages/apollo-wind/src/lib/index.ts
@@ -1,5 +1,4 @@
 export { cn, get, deepEqual } from './utils';
-export { registerCssPropertyRules } from './register-shadow-dom-properties';
 export {
   injectTailwindIntoShadowRoot,
   hasApolloWindCss,
diff --git a/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts b/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts
index ce6f51b92..67379420d 100644
--- a/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts
+++ b/packages/apollo-wind/src/lib/register-shadow-dom-properties.test.ts
@@ -12,11 +12,11 @@ const SAMPLE_CSS = `
 `;
 
 beforeEach(() => {
-  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
+  document.querySelectorAll(SELECTOR).forEach((el) => { el.remove(); });
 });
 
 afterEach(() => {
-  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
+  document.querySelectorAll(SELECTOR).forEach((el) => { el.remove(); });
 });
 
 describe('registerCssPropertyRules', () => {
diff --git a/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts b/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts
index df92bf523..79848a6d2 100644
--- a/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts
+++ b/packages/apollo-wind/src/lib/register-shadow-dom-properties.ts
@@ -18,14 +18,14 @@ const NEEDLE = '@property';
 
 function extractPropertyRules(css: string): string[] {
   const rules: string[] = [];
-  let pos = 0;
-  while ((pos = css.indexOf(NEEDLE, pos)) !== -1) {
+  let pos = css.indexOf(NEEDLE, 0);
+  while (pos !== -1) {
     const open = css.indexOf('{', pos);
     if (open === -1) break;
     const close = css.indexOf('}', open);
     if (close === -1) break;
     rules.push(css.slice(pos, close + 1));
-    pos = close + 1;
+    pos = css.indexOf(NEEDLE, close + 1);
   }
   return rules;
 }
diff --git a/packages/apollo-wind/src/lib/shadow-dom-css.test.ts b/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
index b36bc8825..2f8f7f551 100644
--- a/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
+++ b/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
@@ -1,4 +1,4 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import {
   hasApolloWindCss,
   injectTailwindIntoShadowRoot,
@@ -22,16 +22,14 @@ function createShadowHost(): { host: HTMLElement; root: ShadowRoot } {
 }
 
 beforeEach(() => {
-  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
-  document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => el.remove());
+  document.querySelectorAll(SELECTOR).forEach((el) => { el.remove(); });
+  document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => { el.remove(); });
 });
 
 afterEach(() => {
-  document.querySelectorAll(SELECTOR).forEach((el) => el.remove());
-  document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => el.remove());
-  document
-    .querySelectorAll('div')
-    .forEach((el) => el.parentNode?.removeChild(el));
+  document.querySelectorAll(SELECTOR).forEach((el) => { el.remove(); });
+  document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => { el.remove(); });
+  document.querySelectorAll('div').forEach((el) => { el.parentNode?.removeChild(el); });
 });
 
 describe('injectTailwindIntoShadowRoot', () => {

From 96d87ea1499c5b71939cbc7882d7c08500ba58c9 Mon Sep 17 00:00:00 2001
From: David Rios <david.rios@uipath.com>
Date: Thu, 25 Jun 2026 15:15:42 -0400
Subject: [PATCH 3/3] chore(apollo-wind): lint

---
 packages/apollo-wind/src/index.ts             | 558 ++++++++----------
 packages/apollo-wind/src/lib/index.ts         |   4 +-
 .../src/lib/shadow-dom-css.test.ts            |   5 +-
 3 files changed, 254 insertions(+), 313 deletions(-)

diff --git a/packages/apollo-wind/src/index.ts b/packages/apollo-wind/src/index.ts
index 835859f57..ed1367784 100644
--- a/packages/apollo-wind/src/index.ts
+++ b/packages/apollo-wind/src/index.ts
@@ -2,98 +2,105 @@
 // @uipath/apollo-wind - Public API Exports
 // =============================================================================
 
+export type {
+  AdapterRequest,
+  AdapterResponse,
+  DataAdapter,
+} from './components/forms/data-fetcher';
+export {
+  DataFetcher,
+  DataSourceBuilder,
+  DataTransformers,
+  FetchAdapter,
+} from './components/forms/data-fetcher';
+export { FormFieldRenderer } from './components/forms/field-renderer';
+export { FormDesigner } from './components/forms/form-designer';
+export {
+  analyticsPlugin,
+  auditPlugin,
+  autoSavePlugin,
+  formattingPlugin,
+  validationPlugin,
+  workflowPlugin,
+} from './components/forms/form-plugins';
+export type {
+  CustomFieldComponentProps,
+  DataSource,
+  FieldCondition,
+  FieldMetadata,
+  FieldOption,
+  FieldRule,
+  FieldType,
+  FormAction,
+  FormContext,
+  FormPlugin,
+  FormSchema,
+  FormSection,
+  FormStep,
+} from './components/forms/form-schema';
+export {
+  hasMinMaxStep,
+  hasOptions,
+  isCustomField,
+  isFileField,
+} from './components/forms/form-schema';
+export { FormStateViewer } from './components/forms/form-state-viewer';
 // -----------------------------------------------------------------------------
-// Utilities
+// Metadata Forms System
 // -----------------------------------------------------------------------------
-export { cn } from './lib/utils';
+export { MetadataForm } from './components/forms/metadata-form';
 export {
-  injectTailwindIntoShadowRoot,
-  hasApolloWindCss,
-  TAILWIND_INJECT_ATTR,
-} from './lib/shadow-dom-css';
-
+  ExpressionBuilder,
+  RuleBuilder,
+  RulesEngine,
+} from './components/forms/rules-engine';
 // -----------------------------------------------------------------------------
-// Layout Components
+// Utility Components
 // -----------------------------------------------------------------------------
-export { Row } from './components/ui/layout/row';
-export type { RowProps } from './components/ui/layout/row';
-
-export { Column } from './components/ui/layout/column';
-export type { ColumnProps } from './components/ui/layout/column';
-
-export { Grid } from './components/ui/layout/grid';
-export type { GridProps } from './components/ui/layout/grid';
-
+export {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from './components/ui/accordion';
+export { Alert, AlertDescription, AlertTitle } from './components/ui/alert';
+export {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogOverlay,
+  AlertDialogPortal,
+  AlertDialogTitle,
+  AlertDialogTrigger,
+} from './components/ui/alert-dialog';
+export { AspectRatio } from './components/ui/aspect-ratio';
+export { Avatar, AvatarFallback, AvatarImage } from './components/ui/avatar';
+export type { BadgeProps } from './components/ui/badge';
+export { Badge, badgeVariants } from './components/ui/badge';
+export {
+  Breadcrumb,
+  BreadcrumbEllipsis,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from './components/ui/breadcrumb';
+export type { ButtonProps } from './components/ui/button';
 // -----------------------------------------------------------------------------
 // Button Components
 // -----------------------------------------------------------------------------
 export { Button, buttonVariants } from './components/ui/button';
-export type { ButtonProps } from './components/ui/button';
-
 export {
   ButtonGroup,
   ButtonGroupSeparator,
   ButtonGroupText,
 } from './components/ui/button-group';
-
-export { Toggle, toggleVariants } from './components/ui/toggle';
-
-export { ToggleGroup, ToggleGroupItem } from './components/ui/toggle-group';
-
-// -----------------------------------------------------------------------------
-// Form Input Components
-// -----------------------------------------------------------------------------
-export { Input } from './components/ui/input';
-export type { InputProps } from './components/ui/input';
-
-export { Textarea } from './components/ui/textarea';
-export type { TextareaProps } from './components/ui/textarea';
-
-export { Label } from './components/ui/label';
-export type { LabelProps } from './components/ui/label';
-
-export { Checkbox } from './components/ui/checkbox';
-export type { CheckboxProps } from './components/ui/checkbox';
-
-export { RadioGroup, RadioGroupItem } from './components/ui/radio-group';
-
-export { Switch } from './components/ui/switch';
-
-export { Slider } from './components/ui/slider';
-
-export {
-  Select,
-  SelectContent,
-  SelectGroup,
-  SelectItem,
-  SelectLabel,
-  SelectScrollDownButton,
-  SelectScrollUpButton,
-  SelectSeparator,
-  SelectTrigger,
-  SelectValue,
-} from './components/ui/select';
-
-export { Combobox } from './components/ui/combobox';
-
-export { MultiSelect } from './components/ui/multi-select';
-export type { MultiSelectProps } from './components/ui/multi-select';
-
-export { Search, SearchWithSuggestions } from './components/ui/search';
-export type {
-  SearchProps,
-  SearchWithSuggestionsProps,
-} from './components/ui/search';
-
 export { Calendar } from './components/ui/calendar';
-
-export { DatePicker } from './components/ui/date-picker';
-
-export { DateTimePicker } from './components/ui/datetime-picker';
-export type { DateTimePickerProps } from './components/ui/datetime-picker';
-
-export { FileUpload } from './components/ui/file-upload';
-
 // -----------------------------------------------------------------------------
 // Data Display Components
 // -----------------------------------------------------------------------------
@@ -105,65 +112,53 @@ export {
   CardHeader,
   CardTitle,
 } from './components/ui/card';
-
-export { StatsCard } from './components/ui/stats-card';
-export type { StatsCardProps } from './components/ui/stats-card';
-
-export { Badge, badgeVariants } from './components/ui/badge';
-export type { BadgeProps } from './components/ui/badge';
-
-export { CodeBlock } from './components/ui/code-block';
+export type { CheckboxProps } from './components/ui/checkbox';
+export { Checkbox } from './components/ui/checkbox';
 export type { CodeBlockProps } from './components/ui/code-block';
-
-export { Avatar, AvatarFallback, AvatarImage } from './components/ui/avatar';
-
+export { CodeBlock } from './components/ui/code-block';
 export {
-  Table,
-  TableBody,
-  TableCaption,
-  TableCell,
-  TableFooter,
-  TableHead,
-  TableHeader,
-  TableRow,
-} from './components/ui/table';
-
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from './components/ui/collapsible';
+export { Combobox } from './components/ui/combobox';
+export {
+  Command,
+  CommandDialog,
+  CommandEmpty,
+  CommandGroup,
+  CommandInput,
+  CommandItem,
+  CommandList,
+  CommandSeparator,
+  CommandShortcut,
+} from './components/ui/command';
+export {
+  ContextMenu,
+  ContextMenuCheckboxItem,
+  ContextMenuContent,
+  ContextMenuGroup,
+  ContextMenuItem,
+  ContextMenuLabel,
+  ContextMenuPortal,
+  ContextMenuRadioGroup,
+  ContextMenuRadioItem,
+  ContextMenuSeparator,
+  ContextMenuShortcut,
+  ContextMenuSub,
+  ContextMenuSubContent,
+  ContextMenuSubTrigger,
+  ContextMenuTrigger,
+} from './components/ui/context-menu';
+export type { DataTableProps } from './components/ui/data-table';
 export {
   DataTable,
   DataTableColumnHeader,
   DataTableSelectColumn,
 } from './components/ui/data-table';
-export type { DataTableProps } from './components/ui/data-table';
-
-export {
-  EditableCell,
-  createEditableColumn,
-} from './components/ui/editable-cell';
-export type {
-  EditableCellMeta,
-  EditableCellType,
-} from './components/ui/editable-cell';
-
-export { Progress } from './components/ui/progress';
-
-export { Skeleton } from './components/ui/skeleton';
-
-export { Spinner, spinnerVariants } from './components/ui/spinner';
-export type { SpinnerProps } from './components/ui/spinner';
-
-export { EmptyState } from './components/ui/empty-state';
-export type { EmptyStateProps } from './components/ui/empty-state';
-
-export { default as TreeView } from './components/ui/tree-view';
-export type {
-  TreeViewItem,
-  TreeViewItemAction,
-  TreeViewIconMap,
-  TreeViewMenuItem,
-  TreeViewProps,
-  TreeViewSelectionMode,
-} from './components/ui/tree-view';
-
+export { DatePicker } from './components/ui/date-picker';
+export type { DateTimePickerProps } from './components/ui/datetime-picker';
+export { DateTimePicker } from './components/ui/datetime-picker';
 // -----------------------------------------------------------------------------
 // Feedback & Overlay Components
 // -----------------------------------------------------------------------------
@@ -179,87 +174,6 @@ export {
   DialogTitle,
   DialogTrigger,
 } from './components/ui/dialog';
-
-export {
-  AlertDialog,
-  AlertDialogAction,
-  AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogOverlay,
-  AlertDialogPortal,
-  AlertDialogTitle,
-  AlertDialogTrigger,
-} from './components/ui/alert-dialog';
-
-export {
-  Sheet,
-  SheetClose,
-  SheetContent,
-  SheetDescription,
-  SheetFooter,
-  SheetHeader,
-  SheetOverlay,
-  SheetPortal,
-  SheetTitle,
-  SheetTrigger,
-} from './components/ui/sheet';
-
-export {
-  Popover,
-  PopoverAnchor,
-  PopoverContent,
-  PopoverTrigger,
-} from './components/ui/popover';
-
-export {
-  Tooltip,
-  TooltipContent,
-  TooltipPortal,
-  TooltipProvider,
-  TooltipTrigger,
-} from './components/ui/tooltip';
-
-export {
-  HoverCard,
-  HoverCardContent,
-  HoverCardTrigger,
-} from './components/ui/hover-card';
-
-export { Alert, AlertDescription, AlertTitle } from './components/ui/alert';
-
-export { toast, Toaster } from './components/ui/sonner';
-
-// -----------------------------------------------------------------------------
-// Navigation Components
-// -----------------------------------------------------------------------------
-export { Tabs, TabsContent, TabsList, TabsTrigger } from './components/ui/tabs';
-
-export {
-  Breadcrumb,
-  BreadcrumbEllipsis,
-  BreadcrumbItem,
-  BreadcrumbLink,
-  BreadcrumbList,
-  BreadcrumbPage,
-  BreadcrumbSeparator,
-} from './components/ui/breadcrumb';
-
-export {
-  Pagination,
-  PaginationContent,
-  PaginationEllipsis,
-  PaginationItem,
-  PaginationLink,
-  PaginationNext,
-  PaginationPrevious,
-} from './components/ui/pagination';
-
-export { Stepper } from './components/ui/stepper';
-export type { Step, StepperProps } from './components/ui/stepper';
-
 // -----------------------------------------------------------------------------
 // Menu Components
 // -----------------------------------------------------------------------------
@@ -280,119 +194,143 @@ export {
   DropdownMenuSubTrigger,
   DropdownMenuTrigger,
 } from './components/ui/dropdown-menu';
-
+export type {
+  EditableCellMeta,
+  EditableCellType,
+} from './components/ui/editable-cell';
 export {
-  ContextMenu,
-  ContextMenuCheckboxItem,
-  ContextMenuContent,
-  ContextMenuGroup,
-  ContextMenuItem,
-  ContextMenuLabel,
-  ContextMenuPortal,
-  ContextMenuRadioGroup,
-  ContextMenuRadioItem,
-  ContextMenuSeparator,
-  ContextMenuShortcut,
-  ContextMenuSub,
-  ContextMenuSubContent,
-  ContextMenuSubTrigger,
-  ContextMenuTrigger,
-} from './components/ui/context-menu';
-
+  createEditableColumn,
+  EditableCell,
+} from './components/ui/editable-cell';
+export type { EmptyStateProps } from './components/ui/empty-state';
+export { EmptyState } from './components/ui/empty-state';
+export { FileUpload } from './components/ui/file-upload';
 export {
-  Command,
-  CommandDialog,
-  CommandEmpty,
-  CommandGroup,
-  CommandInput,
-  CommandItem,
-  CommandList,
-  CommandSeparator,
-  CommandShortcut,
-} from './components/ui/command';
-
+  HoverCard,
+  HoverCardContent,
+  HoverCardTrigger,
+} from './components/ui/hover-card';
+export type { InputProps } from './components/ui/input';
 // -----------------------------------------------------------------------------
-// Utility Components
+// Form Input Components
+// -----------------------------------------------------------------------------
+export { Input } from './components/ui/input';
+export type { LabelProps } from './components/ui/label';
+export { Label } from './components/ui/label';
+export type { ColumnProps } from './components/ui/layout/column';
+export { Column } from './components/ui/layout/column';
+export type { GridProps } from './components/ui/layout/grid';
+export { Grid } from './components/ui/layout/grid';
+export type { RowProps } from './components/ui/layout/row';
 // -----------------------------------------------------------------------------
+// Layout Components
+// -----------------------------------------------------------------------------
+export { Row } from './components/ui/layout/row';
+export type { MultiSelectProps } from './components/ui/multi-select';
+export { MultiSelect } from './components/ui/multi-select';
 export {
-  Accordion,
-  AccordionContent,
-  AccordionItem,
-  AccordionTrigger,
-} from './components/ui/accordion';
-
+  Pagination,
+  PaginationContent,
+  PaginationEllipsis,
+  PaginationItem,
+  PaginationLink,
+  PaginationNext,
+  PaginationPrevious,
+} from './components/ui/pagination';
 export {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from './components/ui/collapsible';
-
-export { ScrollArea, ScrollBar } from './components/ui/scroll-area';
-
-export { Separator } from './components/ui/separator';
-
+  Popover,
+  PopoverAnchor,
+  PopoverContent,
+  PopoverTrigger,
+} from './components/ui/popover';
+export { Progress } from './components/ui/progress';
+export { RadioGroup, RadioGroupItem } from './components/ui/radio-group';
 export {
   ResizableHandle,
   ResizablePanel,
   ResizablePanelGroup,
 } from './components/ui/resizable';
-
-export { AspectRatio } from './components/ui/aspect-ratio';
-
-// -----------------------------------------------------------------------------
-// Metadata Forms System
-// -----------------------------------------------------------------------------
-export { MetadataForm } from './components/forms/metadata-form';
-export { FormFieldRenderer } from './components/forms/field-renderer';
-export { FormDesigner } from './components/forms/form-designer';
-export { FormStateViewer } from './components/forms/form-state-viewer';
-
+export { ScrollArea, ScrollBar } from './components/ui/scroll-area';
+export type {
+  SearchProps,
+  SearchWithSuggestionsProps,
+} from './components/ui/search';
+export { Search, SearchWithSuggestions } from './components/ui/search';
 export {
-  RulesEngine,
-  RuleBuilder,
-  ExpressionBuilder,
-} from './components/forms/rules-engine';
-
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectScrollDownButton,
+  SelectScrollUpButton,
+  SelectSeparator,
+  SelectTrigger,
+  SelectValue,
+} from './components/ui/select';
+export { Separator } from './components/ui/separator';
 export {
-  DataFetcher,
-  DataSourceBuilder,
-  DataTransformers,
-  FetchAdapter,
-} from './components/forms/data-fetcher';
-export type {
-  DataAdapter,
-  AdapterRequest,
-  AdapterResponse,
-} from './components/forms/data-fetcher';
-
+  Sheet,
+  SheetClose,
+  SheetContent,
+  SheetDescription,
+  SheetFooter,
+  SheetHeader,
+  SheetOverlay,
+  SheetPortal,
+  SheetTitle,
+  SheetTrigger,
+} from './components/ui/sheet';
+export { Skeleton } from './components/ui/skeleton';
+export { Slider } from './components/ui/slider';
+export { Toaster, toast } from './components/ui/sonner';
+export type { SpinnerProps } from './components/ui/spinner';
+export { Spinner, spinnerVariants } from './components/ui/spinner';
+export type { StatsCardProps } from './components/ui/stats-card';
+export { StatsCard } from './components/ui/stats-card';
+export type { Step, StepperProps } from './components/ui/stepper';
+export { Stepper } from './components/ui/stepper';
+export { Switch } from './components/ui/switch';
 export {
-  analyticsPlugin,
-  autoSavePlugin,
-  validationPlugin,
-  workflowPlugin,
-  auditPlugin,
-  formattingPlugin,
-} from './components/forms/form-plugins';
-
+  Table,
+  TableBody,
+  TableCaption,
+  TableCell,
+  TableFooter,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from './components/ui/table';
+// -----------------------------------------------------------------------------
+// Navigation Components
+// -----------------------------------------------------------------------------
+export { Tabs, TabsContent, TabsList, TabsTrigger } from './components/ui/tabs';
+export type { TextareaProps } from './components/ui/textarea';
+export { Textarea } from './components/ui/textarea';
+export { Toggle, toggleVariants } from './components/ui/toggle';
+export { ToggleGroup, ToggleGroupItem } from './components/ui/toggle-group';
+export {
+  Tooltip,
+  TooltipContent,
+  TooltipPortal,
+  TooltipProvider,
+  TooltipTrigger,
+} from './components/ui/tooltip';
 export type {
-  FormSchema,
-  FormSection,
-  FormStep,
-  FieldMetadata,
-  FieldType,
-  FieldCondition,
-  FieldRule,
-  DataSource,
-  FormContext,
-  FormPlugin,
-  FormAction,
-  CustomFieldComponentProps,
-  FieldOption,
-} from './components/forms/form-schema';
-
+  TreeViewIconMap,
+  TreeViewItem,
+  TreeViewItemAction,
+  TreeViewMenuItem,
+  TreeViewProps,
+  TreeViewSelectionMode,
+} from './components/ui/tree-view';
+export { default as TreeView } from './components/ui/tree-view';
 export {
-  hasOptions,
-  hasMinMaxStep,
-  isFileField,
-  isCustomField,
-} from './components/forms/form-schema';
+  hasApolloWindCss,
+  injectTailwindIntoShadowRoot,
+  TAILWIND_INJECT_ATTR,
+} from './lib/shadow-dom-css';
+// -----------------------------------------------------------------------------
+// Utilities
+// -----------------------------------------------------------------------------
+export { cn } from './lib/utils';
diff --git a/packages/apollo-wind/src/lib/index.ts b/packages/apollo-wind/src/lib/index.ts
index 8b2d7d406..781cbf766 100644
--- a/packages/apollo-wind/src/lib/index.ts
+++ b/packages/apollo-wind/src/lib/index.ts
@@ -1,6 +1,6 @@
-export { cn, get, deepEqual } from './utils';
 export {
-  injectTailwindIntoShadowRoot,
   hasApolloWindCss,
+  injectTailwindIntoShadowRoot,
   TAILWIND_INJECT_ATTR,
 } from './shadow-dom-css';
+export { cn, deepEqual, get } from './utils';
diff --git a/packages/apollo-wind/src/lib/shadow-dom-css.test.ts b/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
index 2f8f7f551..a38abca79 100644
--- a/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
+++ b/packages/apollo-wind/src/lib/shadow-dom-css.test.ts
@@ -14,8 +14,11 @@ const SAMPLE_CSS = `
 .grid { display: grid; }
 `;
 
+const SHADOW_HOST_ATTR = 'data-test-shadow-host';
+
 function createShadowHost(): { host: HTMLElement; root: ShadowRoot } {
   const host = document.createElement('div');
+  host.setAttribute(SHADOW_HOST_ATTR, '');
   document.body.appendChild(host);
   const root = host.attachShadow({ mode: 'open' });
   return { host, root };
@@ -29,7 +32,7 @@ beforeEach(() => {
 afterEach(() => {
   document.querySelectorAll(SELECTOR).forEach((el) => { el.remove(); });
   document.querySelectorAll(PROPERTY_SELECTOR).forEach((el) => { el.remove(); });
-  document.querySelectorAll('div').forEach((el) => { el.parentNode?.removeChild(el); });
+  document.querySelectorAll(`[${SHADOW_HOST_ATTR}]`).forEach((el) => { el.remove(); });
 });
 
 describe('injectTailwindIntoShadowRoot', () => {