@companycam/slab-web 2.2.2 → 2.3.0

package/lib/Card/Card.d.ts

@@ -1,26 +1,30 @@
-import { ComponentPropsWithRef, CSSProperties, ReactNode } from 'react';
-export type HTMLCardProps = Omit<ComponentPropsWithRef<'button'> & ComponentPropsWithRef<'a'> & ComponentPropsWithRef<'div'>, 'title'>;
-export type CardProps = HTMLCardProps & {
-    children?: ReactNode;
+import { CSSProperties, ReactNode } from 'react';
+import { OmitProps } from '../shared/types';
+export type CardProps = OmitProps<'div', 'onClick' | 'title'> & {
     /** Style hook for the _interior_ card container (border, background, etc.) */
     containerStyle?: Readonly<CSSProperties>;
     contentAction?: ReactNode;
     contentBefore?: ReactNode;
     contentAfter?: ReactNode;
     contentThumbnail?: ReactNode;
-    /** Card renders as a link */
-    href?: string;
-    /** Card renders as a button */
-    onClick?: undefined | (() => void);
     /** Card heading */
     title?: ReactNode;
-};
+} & ((OmitProps<'a', 'onClick' | 'title'> & {
+    onClick?: never;
+}) | (OmitProps<'button', 'title'> & {
+    href?: never;
+}));
 /**
  * - Flexible and composable, offering four slots for different content.
- * - Card is BYO-spacing-between-content, to keep it as flexible as possible. Don't forget [Text](/docs/text--docs) has a `ccMargin` prop!
+ * - Card is BYO-spacing-between-content, to keep it as flexible as possible.
+ * Don't forget [Text](/docs/text--docs) has a `ccMargin` prop!
  * - Can render as a div, button, or link.
  *
- * > **It's invalid HTML to nest buttons or links inside buttons or links.** If you're making the whole card clickable via `href` or `onClick`, the only valid place you can add another button or link is in the `contentAction` slot.
+ * > [!IMPORTANT]
+ * > **It's invalid HTML to nest buttons or links inside buttons or links.** If
+ * > you're making the whole card clickable via `href` or `onClick`, the only
+ * > valid place you can add another button or link is in the `contentAction`
+ * > slot.
  */
-export declare function Card({ containerStyle, contentAction, contentAfter, contentBefore, contentThumbnail, children, onClick, href, title, ...props }: CardProps): import("react/jsx-runtime").JSX.Element;
+export declare const Card: ({ children, className, containerStyle, contentAction, contentAfter, contentBefore, contentThumbnail, style, title, ...props }: CardProps) => import("react/jsx-runtime").JSX.Element;
 export default Card;

package/lib/Table/Table.d.ts

@@ -1,5 +1,5 @@
 import { ComponentPropsWithRef } from 'react';
-import { Row, CellContext, ColumnDef, ColumnSort, OnChangeFn, SortingState } from '@tanstack/react-table';
+import { CellContext, ColumnDef, ColumnSort, OnChangeFn, Row, SortingState } from '@tanstack/react-table';
 import { CellSize } from '../shared/types';
 export type TableProps<T> = ComponentPropsWithRef<'table'> & {
     defaultData: readonly T[];

package/lib/shared/types.d.ts

@@ -90,3 +90,7 @@ export type PolymorphicForwardRefComponent<DefaultElement extends ElementType, P
     <C extends ElementType = DefaultElement>(props: PolymorphicComponentPropsWithRef<C, Props>): ReactElement | null;
     displayName?: string;
 };
+/**
+ * {@linkcode ComponentPropsWithRef}, omitting the given `Props`.
+ */
+export type OmitProps<Element extends ElementType, Props extends keyof ComponentPropsWithRef<Element>> = Omit<ComponentPropsWithRef<Element>, Props>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companycam/slab-web",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "main": "./index.js",
   "module": "./index.mjs",
   "types": "./index.d.ts",

package/storybook/TokenDocs/utils.d.ts

@@ -4,3 +4,4 @@ export declare const getFilteredTokenDocs: ({ query, category, }: {
     query?: string;
     category?: WebTokenDocCategory;
 }) => TokenDoc[];
+export declare const getTokenAsCssVariable: (tokenName: string) => string;