@apollion-dsi/core 5.10.0 → 7.0.0

package/lib/containers/Base/index.esm.js

@@ -1 +1 @@
-import{a}from"../../chunks/chunk-XUDIJMQO.esm.js";import"../../chunks/chunk-PJQ3IZE7.esm.js";import"../../chunks/chunk-II2LPQYL.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-HCNNXM2C.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-F62355HF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as BaseContainer};
+import{a,b}from"../../chunks/chunk-D4ZBSTRO.esm.js";import"../../chunks/chunk-PMN6TVDW.esm.js";import"../../chunks/chunk-KKFQPSAE.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-VUFEYXWD.esm.js";import"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-LCIO2E2K.esm.js";import"../../chunks/chunk-HG4FBLPA.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-OHVMP5B7.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as BaseContainer,b as LayoutBase};

package/lib/containers/Box/Box.interface.d.ts

@@ -0,0 +1,33 @@
+import { ReactNode } from 'react';
+import { LayoutContainerProps, PolymorphicProps } from '../../factory/System';
+/**
+ * Props of the `Box` component before the native `<div>` props.
+ *
+ * `Box` is the generic **block** container — structure only (ADR-028). It
+ * extends {@link LayoutContainerProps}: spacing (margin/padding), size
+ * (width/height), container geometry (position/overflow) and the responsive
+ * channels — **no** background, border, elevation, typography or motion. Those
+ * belong to `Paper`/`Card` (surface) and `Text` (typography). Reach for `Box`
+ * instead of a raw `<div>` or the internal `Base` primitive.
+ */
+export interface BoxPropsInterface extends LayoutContainerProps {
+    children?: ReactNode;
+}
+type NativeProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'children'>;
+/**
+ * Complete set of props accepted by `<Box>` at runtime. Merges the factory
+ * props ({@link BoxPropsInterface}) with the native `<div>` props (minus
+ * `children`, which comes from the factory).
+ */
+export interface DefaultBoxInterface extends BoxPropsInterface, NativeProps {
+}
+/**
+ * Public props type for annotating a `Box` **layout object** — the runtime
+ * interface plus the `styled-components` polymorphic {@link PolymorphicProps}
+ * (`as`/`forwardedAs`). Use this (not `DefaultBoxInterface`) when a consumer
+ * types a plain object and needs `as`, so no local augmentation or
+ * `ComponentProps<typeof Box>` workaround is needed. The styled `Box` component
+ * itself always accepts `as` natively.
+ */
+export type BoxProps = DefaultBoxInterface & PolymorphicProps;
+export {};

package/lib/containers/Box/Box.style.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The design system's generic **block** container — the catch-all box. Extends
+ * {@link BaseContainer}, inheriting the full factory surface (spacing, size,
+ * color, border, flex/grid child props, `cq`, `viewportMedias`, `motion`), and
+ * sets `display: block`.
+ *
+ * `Box` is the sanctioned replacement for a raw `<div>`: consumers never render
+ * host HTML tags directly (that blocks cross-platform export — e.g. a native
+ * Android/RN target has no `<div>`), and they never reach for the internal
+ * `Base` primitive or `apollion.*`. Reach for `Flex`/`Grid` for layout, `Box`
+ * for a plain block wrapper.
+ *
+ * Exposed as `Box` in the barrel. Animation is the `motion` preset prop
+ * (ADR-027) — a factory channel of this container, not a separate module.
+ */
+export declare const BoxStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>>> & string;

package/lib/containers/Box/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public barrel of the `Box` container.
+ *
+ * Re-exports the styled-component (renaming `BoxStyle` → `Box`) and the props
+ * interfaces (`BoxPropsInterface`, `DefaultBoxInterface`, `BoxProps`).
+ *
+ * `Box` is the generic block container — the sanctioned replacement for a raw
+ * `<div>` and for the internal `Base` primitive. Animation is the `motion`
+ * preset prop on the container itself (ADR-027) — there is no separate animated
+ * variant.
+ *
+ * Every other file in the project must import from the barrel, never from
+ * internal paths such as `./Box.style` or `./Box.interface`.
+ */
+export * from './Box.interface';
+export { BoxStyle as Box } from './Box.style';

package/lib/containers/Box/index.esm.js

@@ -0,0 +1 @@
+import{b as t}from"../../chunks/chunk-D4ZBSTRO.esm.js";import"../../chunks/chunk-PMN6TVDW.esm.js";import"../../chunks/chunk-KKFQPSAE.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-VUFEYXWD.esm.js";import"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-LCIO2E2K.esm.js";import"../../chunks/chunk-HG4FBLPA.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-OHVMP5B7.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import{g as o}from"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";var r=o(t).withConfig({componentId:"sc-fc1jyz-0"})(["display:block;"]);export{r as Box};

package/lib/containers/Card/Card.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { CardInterface } from './Card.interface';
+import { CardProps } from './Card.interface';
 import type { GridMediaInterface } from '../Grid';
 /**
  * Builds the default grid template from the slots present. Rows are `auto`
@@ -38,4 +38,4 @@ export declare const cardTemplate: (slots: {
  *
  * @see {@link CardInterface} for the detailed props.
  */
-export declare const CardComponent: React.FC<CardInterface>;
+export declare const CardComponent: React.FC<CardProps>;

package/lib/containers/Card/Card.interface.d.ts

@@ -1,17 +1,24 @@
 import { ReactNode } from 'react';
-import { GridPropsInterface } from '../Grid';
+import { PolymorphicProps, SurfaceContainerProps } from '../../factory/System';
+import { GridShapeProps } from '../Grid';
 /**
  * Props of the {@link CardComponent} component.
  *
- * `Card` is the Paper-like surface that **absorbs Grid**: it extends
- * {@link GridPropsInterface} (layout props + `medias` + the alignment
- * surface), and its slots — `media`, `title`, `description` / `subtitle` /
- * `children` (the `content` area), `actionComponent` — are named grid areas
- * on the Card itself. The default template follows the slots present
- * (`auto 1fr auto` with an action, so the footer pins); pass `medias` to
- * replace it, keeping the same area names.
+ * `Card` is the Paper-like surface that **absorbs Grid**: its slots — `media`,
+ * `title`, `description` / `subtitle` / `children` (the `content` area),
+ * `actionComponent` — are named grid areas on the Card itself. The default
+ * template follows the slots present (`auto 1fr auto` with an action, so the
+ * footer pins); pass `medias` to replace it, keeping the same area names.
+ *
+ * `Card` is the Grid-rooted **surface** (ADR-028): it composes the grid shape
+ * ({@link GridShapeProps}: `medias` + alignment) with {@link SurfaceContainerProps}
+ * — the layout factory group **plus** the surface group (`bgColor`, border,
+ * `deep`) and the responsive channels at full width — so a Card paints a ground
+ * (and can respond to width with surface props) while a bare `Grid` stays pure
+ * layout. `as`/`forwardedAs` and the anchor attributes come from the
+ * component's own props type ({@link CardProps} / {@link CardComponent}).
  */
-export interface CardInterface extends GridPropsInterface {
+export interface CardInterface extends SurfaceContainerProps, GridShapeProps {
     /**
      * Announce hover: primary border, `level-three` glow and a 2px lift over
      * the `short` transition (`overflow` becomes `visible` so the glow is not
@@ -49,3 +56,29 @@ export interface CardInterface extends GridPropsInterface {
      */
     media?: ReactNode;
 }
+/**
+ * The navigational anchor attributes an interactive Card rendered `as="a"`
+ * needs. Kept as a small explicit set (rather than the full
+ * `ComponentPropsWithoutRef<'a'>`) so the Card props stay well under the
+ * styled-components union-complexity ceiling and never collide with the
+ * factory surface.
+ */
+export interface CardAnchorProps {
+    /** Destination when the tile renders as an anchor (`as="a"`). */
+    href?: string;
+    /** Anchor target (`_blank`, `_self`, …). */
+    target?: React.HTMLAttributeAnchorTarget;
+    /** Anchor `rel` (e.g. `noopener noreferrer` for `target="_blank"`). */
+    rel?: string;
+    /** Anchor `download` hint. */
+    download?: boolean | string;
+}
+/**
+ * Full public props of `<Card>`: {@link CardInterface} plus the
+ * `styled-components` polymorphic {@link PolymorphicProps} (`as`/`forwardedAs`)
+ * and the navigational anchor attributes ({@link CardAnchorProps}) an
+ * interactive tile rendered `as="a"` needs. This is the component's own props
+ * type — a consumer can type a Card layout object with it and set `cq`,
+ * `viewportMedias`, `motion`, `as`, `href` without a local augmentation.
+ */
+export type CardProps = CardInterface & PolymorphicProps & CardAnchorProps;

package/lib/containers/Card/Card.style.d.ts

@@ -1,32 +1,33 @@
+import { SurfaceFactoryProps } from '../../factory/System';
 import type { SpacingInterface } from '../../themes/Spacing';
 /**
  * Card surface — a `Grid` with Paper-like chrome. Slots are named grid areas
  * on this element; the page `Grid` places Cards, a slot that needs grouping
  * uses `Flex`.
  */
-export declare const CardStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+export declare const CardStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, keyof import("..").DefaultGridInterface> & import("..").DefaultGridInterface, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+}, keyof import("..").GridShapeProps> & import("..").GridShapeProps, never> & Partial<Pick<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, keyof import("..").DefaultGridInterface> & import("..").DefaultGridInterface, never>> & {
+}, keyof import("..").GridShapeProps> & import("..").GridShapeProps, never>> & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, "$interactive"> & {
+}, keyof SurfaceFactoryProps | "$interactive"> & {
     $interactive?: boolean;
-}, never> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+} & SurfaceFactoryProps, never> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, keyof import("..").DefaultGridInterface> & import("..").DefaultGridInterface, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+}, keyof import("..").GridShapeProps> & import("..").GridShapeProps, never> & Partial<Pick<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, keyof import("..").DefaultGridInterface> & import("..").DefaultGridInterface, never>> & {
+}, keyof import("..").GridShapeProps> & import("..").GridShapeProps, never>> & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, "$interactive"> & {
+}, keyof SurfaceFactoryProps | "$interactive"> & {
     $interactive?: boolean;
-}, never>>> & string;
+} & SurfaceFactoryProps, never>>> & string;
 /**
  * Full-bleed media slot. Cancels the Card's padding (`$pad`) on the top and
  * sides so the image meets the Card edges; the grid gap keeps the space
@@ -34,24 +35,88 @@ export declare const CardStyle: import("styled-components/dist/types").IStyledCo
  * corner radius and clips, so the image keeps rounded top corners even when
  * the Card's own `overflow` is `visible` (interactive tiles).
  */
-export declare const CardMediaStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+export declare const CardMediaStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+}, "wrap" | "flex" | "gap" | "flexDirection" | "flexBasis" | "justifyContent" | "alignItems" | "alignContent" | "justifyItems" | "placeItems" | "alignSelf" | "grow" | "shrink" | "order" | "justifySelf"> & Partial<{
+    flex: import("../../factory/FlexFactory/FlexFactory.interface").Flex;
+    gap?: SpacingInterface;
+    flexDirection: import("../../factory/FlexFactory/FlexFactory.interface").FlexDirection;
+    flexBasis: string | number;
+    justifyContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexJustify;
+    alignItems: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignItems;
+    alignContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignContent;
+    justifyItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    placeItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    wrap: import("../../factory/FlexFactory/FlexFactory.interface").FlexWrap;
+    alignSelf: import("../../factory/FlexFactory/FlexFactory.interface").AlignSelf;
+    grow: boolean;
+    shrink: boolean;
+    order: import("../../factory/FlexFactory/FlexFactory.interface").FlexOrder;
+    justifySelf: import("../../factory/FlexFactory/FlexFactory.interface").JustifySelf;
+}>, never> & Partial<Pick<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, never>> & {
+}, "wrap" | "flex" | "gap" | "flexDirection" | "flexBasis" | "justifyContent" | "alignItems" | "alignContent" | "justifyItems" | "placeItems" | "alignSelf" | "grow" | "shrink" | "order" | "justifySelf"> & Partial<{
+    flex: import("../../factory/FlexFactory/FlexFactory.interface").Flex;
+    gap?: SpacingInterface;
+    flexDirection: import("../../factory/FlexFactory/FlexFactory.interface").FlexDirection;
+    flexBasis: string | number;
+    justifyContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexJustify;
+    alignItems: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignItems;
+    alignContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignContent;
+    justifyItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    placeItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    wrap: import("../../factory/FlexFactory/FlexFactory.interface").FlexWrap;
+    alignSelf: import("../../factory/FlexFactory/FlexFactory.interface").AlignSelf;
+    grow: boolean;
+    shrink: boolean;
+    order: import("../../factory/FlexFactory/FlexFactory.interface").FlexOrder;
+    justifySelf: import("../../factory/FlexFactory/FlexFactory.interface").JustifySelf;
+}>, never>> & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
 }, "$pad"> & {
     $pad: SpacingInterface;
-}, never> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+}, never> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+}, "wrap" | "flex" | "gap" | "flexDirection" | "flexBasis" | "justifyContent" | "alignItems" | "alignContent" | "justifyItems" | "placeItems" | "alignSelf" | "grow" | "shrink" | "order" | "justifySelf"> & Partial<{
+    flex: import("../../factory/FlexFactory/FlexFactory.interface").Flex;
+    gap?: SpacingInterface;
+    flexDirection: import("../../factory/FlexFactory/FlexFactory.interface").FlexDirection;
+    flexBasis: string | number;
+    justifyContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexJustify;
+    alignItems: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignItems;
+    alignContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignContent;
+    justifyItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    placeItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    wrap: import("../../factory/FlexFactory/FlexFactory.interface").FlexWrap;
+    alignSelf: import("../../factory/FlexFactory/FlexFactory.interface").AlignSelf;
+    grow: boolean;
+    shrink: boolean;
+    order: import("../../factory/FlexFactory/FlexFactory.interface").FlexOrder;
+    justifySelf: import("../../factory/FlexFactory/FlexFactory.interface").JustifySelf;
+}>, never> & Partial<Pick<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, never>> & {
+}, "wrap" | "flex" | "gap" | "flexDirection" | "flexBasis" | "justifyContent" | "alignItems" | "alignContent" | "justifyItems" | "placeItems" | "alignSelf" | "grow" | "shrink" | "order" | "justifySelf"> & Partial<{
+    flex: import("../../factory/FlexFactory/FlexFactory.interface").Flex;
+    gap?: SpacingInterface;
+    flexDirection: import("../../factory/FlexFactory/FlexFactory.interface").FlexDirection;
+    flexBasis: string | number;
+    justifyContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexJustify;
+    alignItems: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignItems;
+    alignContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignContent;
+    justifyItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    placeItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    wrap: import("../../factory/FlexFactory/FlexFactory.interface").FlexWrap;
+    alignSelf: import("../../factory/FlexFactory/FlexFactory.interface").AlignSelf;
+    grow: boolean;
+    shrink: boolean;
+    order: import("../../factory/FlexFactory/FlexFactory.interface").FlexOrder;
+    justifySelf: import("../../factory/FlexFactory/FlexFactory.interface").JustifySelf;
+}>, never>> & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
 }, "$pad"> & {

package/lib/containers/Card/index.esm.js

@@ -1 +1 @@
-import{a}from"../../chunks/chunk-6DTZVTDE.esm.js";import"../../chunks/chunk-GZVFLN6W.esm.js";import"../../chunks/chunk-7D6Z463O.esm.js";import"../../chunks/chunk-EBOJSNZ5.esm.js";import"../../chunks/chunk-DXAKT2S3.esm.js";import"../../chunks/chunk-TG2P4DDY.esm.js";import"../../chunks/chunk-4E3BR56X.esm.js";import"../../chunks/chunk-TMIQIUOH.esm.js";import"../../chunks/chunk-4L2KOZIQ.esm.js";import"../../chunks/chunk-I564UV6U.esm.js";import"../../chunks/chunk-YJHYFCT7.esm.js";import"../../chunks/chunk-TLIKQFOT.esm.js";import"../../chunks/chunk-IA234JY2.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-G757UD32.esm.js";import"../../chunks/chunk-OSFHXCPW.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-BERIBF3O.esm.js";import"../../chunks/chunk-LVVNQRJ2.esm.js";import"../../chunks/chunk-Z7GJDO5T.esm.js";import"../../chunks/chunk-P7RR4ZHS.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-PFLBU7HG.esm.js";import"../../chunks/chunk-IPANNHV3.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-HVFI7FHR.esm.js";import"../../chunks/chunk-QQU6KGIF.esm.js";import"../../chunks/chunk-XUDIJMQO.esm.js";import"../../chunks/chunk-PJQ3IZE7.esm.js";import"../../chunks/chunk-II2LPQYL.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-HCNNXM2C.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-F62355HF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Card};
+import{a}from"../../chunks/chunk-HW42PSLQ.esm.js";import"../../chunks/chunk-RI7KKIJD.esm.js";import"../../chunks/chunk-EXHRZZ5E.esm.js";import"../../chunks/chunk-EBOJSNZ5.esm.js";import"../../chunks/chunk-4E3BR56X.esm.js";import"../../chunks/chunk-TMIQIUOH.esm.js";import"../../chunks/chunk-4L2KOZIQ.esm.js";import"../../chunks/chunk-R6MCW24V.esm.js";import"../../chunks/chunk-A77HKHNQ.esm.js";import"../../chunks/chunk-TLIKQFOT.esm.js";import"../../chunks/chunk-IA234JY2.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-G757UD32.esm.js";import"../../chunks/chunk-OSFHXCPW.esm.js";import"../../chunks/chunk-LVVNQRJ2.esm.js";import"../../chunks/chunk-Z7GJDO5T.esm.js";import"../../chunks/chunk-P7RR4ZHS.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-PFLBU7HG.esm.js";import"../../chunks/chunk-TG2P4DDY.esm.js";import"../../chunks/chunk-YJHYFCT7.esm.js";import"../../chunks/chunk-UHABJEDB.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-BERIBF3O.esm.js";import"../../chunks/chunk-HVFI7FHR.esm.js";import"../../chunks/chunk-NHE4GLQK.esm.js";import"../../chunks/chunk-D4ZBSTRO.esm.js";import"../../chunks/chunk-PMN6TVDW.esm.js";import"../../chunks/chunk-KKFQPSAE.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-VUFEYXWD.esm.js";import"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-LCIO2E2K.esm.js";import"../../chunks/chunk-HG4FBLPA.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-OHVMP5B7.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Card};

package/lib/containers/Content/index.d.ts

@@ -1,9 +1,16 @@
 /**
- * Public barrel of the `Content` component.
+ * Internal barrel of the `Content` building block.
  *
  * Re-exports the component (renaming `ContentComponent` → `Content`) and
  * the props interface (`ContentProps`).
  *
+ * @internal Internal building block, **not** consumer API — a linear
+ * opener/content/closer row with a non-jumping `loading` mode, used by `Button`,
+ * `Modal`, `Notification` and the `Table` cells. `./containers/content` is not
+ * in `package.json#exports`; it was only ever public by accident (ADR-001
+ * Slice 2 auto-emitted a subpath per leaf folder). Consumers compose the
+ * finished components; there is no consumer-facing "content" primitive.
+ *
  * Every other file in the project must import from the barrel, never from
  * internal paths such as `./Content` or `./Content.interface`.
  */

package/lib/containers/Content/index.esm.js

@@ -1 +1 @@
-import{a}from"../../chunks/chunk-H7ZXGMID.esm.js";import"../../chunks/chunk-2JTAHCGS.esm.js";import"../../chunks/chunk-KT4BKJVV.esm.js";import"../../chunks/chunk-QQU6KGIF.esm.js";import"../../chunks/chunk-XUDIJMQO.esm.js";import"../../chunks/chunk-PJQ3IZE7.esm.js";import"../../chunks/chunk-II2LPQYL.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-HCNNXM2C.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-F62355HF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Content};
+import{a}from"../../chunks/chunk-VU3NKSLB.esm.js";import"../../chunks/chunk-GM3IRR2E.esm.js";import"../../chunks/chunk-KT4BKJVV.esm.js";import"../../chunks/chunk-NHE4GLQK.esm.js";import"../../chunks/chunk-D4ZBSTRO.esm.js";import"../../chunks/chunk-PMN6TVDW.esm.js";import"../../chunks/chunk-KKFQPSAE.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-VUFEYXWD.esm.js";import"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-LCIO2E2K.esm.js";import"../../chunks/chunk-HG4FBLPA.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-OHVMP5B7.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Content};

package/lib/containers/Flex/Flex.interface.d.ts

@@ -1,14 +1,18 @@
 import { ReactNode } from 'react';
-import { ApollionProps } from '../../factory/System';
+import { FlexFactoryProps } from '../../factory/FlexFactory';
+import { LayoutContainerProps, PolymorphicProps } from '../../factory/System';
 /**
  * Props of the `Flex` component before the native `<div>` props.
  *
- * Extends {@link ApollionProps} — inheriting all factory props
- * (spacing, size, colors, borders, deep, etc.) — and adds only
- * `children`. It is exposed separately so that other components can
- * style themselves "like a Flex" without importing the native div props.
+ * `Flex` is a **layout** container — structure only (ADR-028). It extends the
+ * layout surface ({@link LayoutContainerProps}: spacing, size, container
+ * geometry, responsive channels) plus the flex layout props
+ * ({@link FlexFactoryProps}: `gap`, `flexDirection`, `alignItems`,
+ * `justifyContent`, `wrap`, `flex`, …). It carries **no** background, border,
+ * elevation, typography or motion — a `Flex` in a tree always means layout, and
+ * a visual ground is a `Paper`/`Card`.
  */
-export interface FlexPropsInterface extends ApollionProps {
+export interface FlexPropsInterface extends LayoutContainerProps, FlexFactoryProps {
     children?: ReactNode;
 }
 type NativeProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'children'>;
@@ -22,4 +26,17 @@ type NativeProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'children'>;
  */
 export interface DefaultFlexInterface extends FlexPropsInterface, NativeProps {
 }
+/**
+ * Public props type for annotating a `Flex` **layout object** — the runtime
+ * interface plus the `styled-components` polymorphic {@link PolymorphicProps}
+ * (`as`/`forwardedAs`). Use this (not `DefaultFlexInterface`) when a consumer
+ * types a plain object and needs `as`, so no local augmentation or
+ * `ComponentProps<typeof Flex>` workaround is needed.
+ *
+ * `as`/`forwardedAs` live here rather than on `DefaultFlexInterface` because
+ * that interface is the generic passed to `styled(...)` internally, where a
+ * polymorphic `as` blows the styled-components union past the TS ceiling
+ * (TS2590). The styled `Flex` component itself still accepts `as` natively.
+ */
+export type FlexProps = DefaultFlexInterface & PolymorphicProps;
 export {};

package/lib/containers/Flex/Flex.style.d.ts

@@ -1,17 +1,62 @@
+import { FlexFactoryProps } from '../../factory/FlexFactory';
+import { SurfaceContainerProps } from '../../factory/System';
+import { IStyledComponent } from '../../vendors/StyledComponents';
 /**
  * The design system's `flex` container. Extends {@link BaseContainer},
  * inheriting all factory props (spacing, colors, borders, etc.), and
  * adds `display: flex` by default.
  *
- * Exposed as `Flex` in the barrel. The animated variant lives in the
- * `containers/motion` subpath (`AnimatedFlex`) — keeping it out of this
- * module prevents `framer-motion` from entering the bundle of consumers
- * that only use the plain `Flex`.
+ * Exposed as `Flex` in the barrel. Animation is the `motion` preset prop
+ * (ADR-027) — a factory channel of this container, not a separate module.
  */
-export declare const DefaultFlexStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+export declare const DefaultFlexStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
+}, "wrap" | "flex" | "gap" | "flexDirection" | "flexBasis" | "justifyContent" | "alignItems" | "alignContent" | "justifyItems" | "placeItems" | "alignSelf" | "grow" | "shrink" | "order" | "justifySelf"> & Partial<{
+    flex: import("../../factory/FlexFactory/FlexFactory.interface").Flex;
+    gap?: import("../../themes").SpacingInterface;
+    flexDirection: import("../../factory/FlexFactory/FlexFactory.interface").FlexDirection;
+    flexBasis: string | number;
+    justifyContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexJustify;
+    alignItems: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignItems;
+    alignContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignContent;
+    justifyItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    placeItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    wrap: import("../../factory/FlexFactory/FlexFactory.interface").FlexWrap;
+    alignSelf: import("../../factory/FlexFactory/FlexFactory.interface").AlignSelf;
+    grow: boolean;
+    shrink: boolean;
+    order: import("../../factory/FlexFactory/FlexFactory.interface").FlexOrder;
+    justifySelf: import("../../factory/FlexFactory/FlexFactory.interface").JustifySelf;
+}>, never> & Partial<Pick<import("styled-components").FastOmit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "color"> & import("../../factory").LayoutContainerProps & {
     as?: import("styled-components").WebTarget;
     forwardedAs?: import("styled-components").WebTarget;
-}, never>>> & string;
+}, "wrap" | "flex" | "gap" | "flexDirection" | "flexBasis" | "justifyContent" | "alignItems" | "alignContent" | "justifyItems" | "placeItems" | "alignSelf" | "grow" | "shrink" | "order" | "justifySelf"> & Partial<{
+    flex: import("../../factory/FlexFactory/FlexFactory.interface").Flex;
+    gap?: import("../../themes").SpacingInterface;
+    flexDirection: import("../../factory/FlexFactory/FlexFactory.interface").FlexDirection;
+    flexBasis: string | number;
+    justifyContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexJustify;
+    alignItems: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignItems;
+    alignContent: import("../../factory/FlexFactory/FlexFactory.interface").FlexAlignContent;
+    justifyItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    placeItems: import("../../factory/FlexFactory/FlexFactory.interface").GridItemsAlign;
+    wrap: import("../../factory/FlexFactory/FlexFactory.interface").FlexWrap;
+    alignSelf: import("../../factory/FlexFactory/FlexFactory.interface").AlignSelf;
+    grow: boolean;
+    shrink: boolean;
+    order: import("../../factory/FlexFactory/FlexFactory.interface").FlexOrder;
+    justifySelf: import("../../factory/FlexFactory/FlexFactory.interface").JustifySelf;
+}>, never>>> & string;
+/**
+ * **Surface-typed** view of {@link DefaultFlexStyle} (ADR-028) — the same
+ * runtime flex container, retyped to accept the surface groups (background,
+ * border, elevation, typography, motion) on top of the flex layout, **without**
+ * `Paper`'s pre-set defaults. For internal surface building blocks that are
+ * genuinely visual (badges, dividers, list rows, dialog/notification chrome) —
+ * they are surfaces, so they carry surface props, but they are not `Paper`.
+ *
+ * @internal Not published — layout consumers use `Flex`; visual surfaces use
+ * `Paper` / `Card`.
+ */
+export declare const SurfaceFlex: IStyledComponent<"web", React.JSX.IntrinsicElements["div"] & SurfaceContainerProps & FlexFactoryProps>;

package/lib/containers/Flex/index.d.ts

@@ -4,12 +4,11 @@
  * Re-exports the styled-component (renaming `DefaultFlexStyle` → `Flex`)
  * and the props interfaces (`FlexPropsInterface`, `DefaultFlexInterface`).
  *
- * The animated version (`AnimatedFlex`) lives in the `containers/motion`
- * subpath to keep `framer-motion` out of the bundle of consumers that only
- * use the plain `Flex`.
+ * Animation is the `motion` preset prop on the container itself (ADR-027) —
+ * there is no separate animated variant.
  *
  * Every other file in the project must import from the barrel, never from
  * internal paths such as `./Flex.style` or `./Flex.interface`.
  */
 export * from './Flex.interface';
-export { DefaultFlexStyle as Flex } from './Flex.style';
+export { DefaultFlexStyle as Flex, SurfaceFlex } from './Flex.style';

package/lib/containers/Flex/index.esm.js

@@ -1 +1 @@
-import{a}from"../../chunks/chunk-QQU6KGIF.esm.js";import"../../chunks/chunk-XUDIJMQO.esm.js";import"../../chunks/chunk-PJQ3IZE7.esm.js";import"../../chunks/chunk-II2LPQYL.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-HCNNXM2C.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-F62355HF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Flex};
+import{a,b}from"../../chunks/chunk-NHE4GLQK.esm.js";import"../../chunks/chunk-D4ZBSTRO.esm.js";import"../../chunks/chunk-PMN6TVDW.esm.js";import"../../chunks/chunk-KKFQPSAE.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-VUFEYXWD.esm.js";import"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-LCIO2E2K.esm.js";import"../../chunks/chunk-HG4FBLPA.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-OHVMP5B7.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-TZQMBDGR.esm.js";import"../../chunks/chunk-WCUEINBQ.esm.js";import"../../chunks/chunk-YJ6PPJQ4.esm.js";import"../../chunks/chunk-QYL6LECA.esm.js";import"../../chunks/chunk-3A7I6HM2.esm.js";import"../../chunks/chunk-WI3WPCW3.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Flex,b as SurfaceFlex};

package/lib/containers/Grid/Grid.interface.d.ts

@@ -1,9 +1,9 @@
 import { ReactNode } from 'react';
 import { FlexFactoryProps } from '../../factory/FlexFactory';
+import { LayoutContainerProps, PolymorphicProps } from '../../factory/System';
 import { BreakpointTypes } from '../../themes/Breakpoints';
 import { SpacingInterface } from '../../themes/Spacing';
 import { Theme } from '../../themes/ThemeProvider';
-import { BaseContainerProps } from '../Base';
 /**
  * Breakpoints accepted by the `Grid`'s `medias` prop.
  *
@@ -75,13 +75,13 @@ export type GridAlignmentProps = Pick<FlexFactoryProps, 'alignItems' | 'justifyC
  */
 export type GridBreakpoints = Partial<Record<GridMediasTypes, GridMediaInterface>> & GridMediaInterface;
 /**
- * Props of the `Grid` before the native `<div>` props.
- *
- * Extends {@link BaseContainerProps} to inherit all factory props
- * (spacing, color, borders, etc.) and adds `medias` to configure
- * the grid per breakpoint.
+ * The grid-specific shape — the box alignment surface plus the responsive grid
+ * template (`medias`) — **without** the responsive channels. Channel-agnostic,
+ * so both the layout `Grid` ({@link GridPropsInterface}) and the Grid-rooted
+ * **surface** `Card` compose it: `Grid` adds the layout channels, `Card` the
+ * surface channels (ADR-028).
  */
-export interface GridPropsInterface extends BaseContainerProps, GridAlignmentProps {
+export interface GridShapeProps extends GridAlignmentProps {
     /**
      * Responsive grid configuration. Accepts either a "flat" config
      * (applied as the default) or an object with per-breakpoint keys
@@ -93,6 +93,17 @@ export interface GridPropsInterface extends BaseContainerProps, GridAlignmentPro
      * ```
      */
     medias?: GridBreakpoints;
+}
+/**
+ * Props of the `Grid` before the native `<div>` props.
+ *
+ * `Grid` is a **layout** container — structure only (ADR-028). It extends the
+ * layout surface ({@link LayoutContainerProps}: spacing, size, container
+ * geometry, layout-only responsive channels) plus the grid template + alignment
+ * ({@link GridShapeProps}). It carries **no** background, border, elevation,
+ * typography or motion — the Grid-rooted **surface** is `Card`.
+ */
+export interface GridPropsInterface extends LayoutContainerProps, GridShapeProps {
     children?: ReactNode;
 }
 /**
@@ -102,6 +113,19 @@ export interface GridPropsInterface extends BaseContainerProps, GridAlignmentPro
  */
 export interface DefaultGridInterface extends GridPropsInterface, Omit<React.ComponentPropsWithoutRef<'div'>, 'children'> {
 }
+/**
+ * Public props type for annotating a `Grid` **layout object** — the runtime
+ * interface plus the `styled-components` polymorphic {@link PolymorphicProps}
+ * (`as`/`forwardedAs`). Use this (not `DefaultGridInterface`) when a consumer
+ * types a plain object and needs `as`, so no local augmentation or
+ * `ComponentProps<typeof Grid>` workaround is needed.
+ *
+ * `as`/`forwardedAs` live here rather than on `DefaultGridInterface` because
+ * that interface is the generic passed to `styled(...)` internally, where a
+ * polymorphic `as` blows the styled-components union past the TS ceiling
+ * (TS2590). The styled `Grid` component itself still accepts `as` natively.
+ */
+export type GridProps = DefaultGridInterface & PolymorphicProps;
 /**
  * Props that reach the Grid's styled-components functions. Equivalent to
  * {@link DefaultGridInterface} with the `theme` injected by the