@czi-sds/mcp 0.3.0 → 0.4.0

package/data/zeroheight-exports/Content-Card.md

@@ -6,8 +6,8 @@ Content Cards are used throughout the UI to present information in a visually or
 
 ## Overview
 
-|  | In Figma |   |  | Meets Accessibility |   |  | In Code |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+|     | In Figma |     |     | Meets Accessibility |     |     | In Code |
+| --- | -------- | --- | --- | ------------------- | --- | --- | ------- |
 
 ### Content Card Variants
 
@@ -36,27 +36,27 @@ Teams can choose whether to display the Content Card with a bounding box, with a
 #### Visual Element Options
 
 | Image | Icon | None |
-| --- | --- | --- |
+| ----- | ---- | ---- |
 
 #### Image Options
 
 | Image left (padding) | Image left (no padding) | Image right (padding) | Image right (no padding) |
-| --- | --- | --- | --- |
+| -------------------- | ----------------------- | --------------------- | ------------------------ |
 
 #### Content Options
 
 | Text | Slot |
-| --- | --- |
+| ---- | ---- |
 
 #### Additional Options
 
 All of the following options are available regardless of whether the image is positioned on the left or right side of the Content Card
 
 | With decorative border | Without decorative border | With bounding box | Without bounding box |
-| --- | --- | --- | --- |
+| ---------------------- | ------------------------- | ----------------- | -------------------- |
 
 | Left-aligned Buttons | Right-aligned Buttons |
-| --- | --- |
+| -------------------- | --------------------- |
 
 #### Interaction States
 
@@ -65,7 +65,7 @@ For Content Cards with one or zero Buttons, the Content Card itself can function
 The following states are used regardless of whether there is a visual element included on the Content Card and, if the visual element is an image, regardless of whether it is positioned on the left or right side of the Content Card.
 
 | Default | Hover | Pressed |
-| --- | --- | --- |
+| ------- | ----- | ------- |
 
 ---
 
@@ -82,25 +82,25 @@ Teams can choose whether to display the Content Card with a bounding box, with a
 #### Visual Element Options
 
 | Image | Icon | None |
-| --- | --- | --- |
+| ----- | ---- | ---- |
 
 #### Image Options
 
 | Padding | No Padding |
-| --- | --- |
+| ------- | ---------- |
 
 #### Content Options
 
 | Text | Slot |
-| --- | --- |
+| ---- | ---- |
 
 #### Additional Options
 
 | With decorative border | Without decorative border | With bounding box | Without bounding box |
-| --- | --- | --- | --- |
+| ---------------------- | ------------------------- | ----------------- | -------------------- |
 
 | Left-aligned Buttons | Right-aligned Buttons |
-| --- | --- |
+| -------------------- | --------------------- |
 
 #### Interaction States
 
@@ -109,7 +109,7 @@ For Content Cards with one or zero Buttons, the Content Card itself can function
 The following states are used regardless of whether there is a visual element included on the Content Card.
 
 | Default | Hover | Pressed |
-| --- | --- | --- |
+| ------- | ----- | ------- |
 
 ---
 
@@ -119,7 +119,7 @@ These rules establish how much margin should exist between and around elements.
 
 ## Code
 
->**Note:** The code examples below must install dependencies before displaying and may take extra time to load
+> **Note:** The code examples below must install dependencies before displaying and may take extra time to load
 
 ## Content Card
 
@@ -135,28 +135,27 @@ Documentation for the underlying MUI `Card` component can be found here.
 
 Any custom SDS props and MUI props required for implementation are found on the table below. See the MUI documentation for additional optional props.
 
-| Name | Type | Default | Description |
-| --- | --- | --- | --- |
-| `boundingBox` | `boolean` | `true` | If `true`, wraps content and visuals inside a bounded layout with background and padding. |
-| `buttonsPosition` | `"left"` |`"right"` | `"left"` | Determines the alignment of buttons in the ContentCardActions component. |
-| `classes` | `object` | `-` | Custom class names for different card sub-sections (e.g., cardPaper, cardTitle, cardActions, etc.). Could be used to style the component with TailwindCss. Full list of available class names are:`cardPaper`, `cardContent`, `cardHeader`, `cardMedia`, `cardOverline`, `cardTitle`, `cardSubtitle`, `cardMetadata`, `cardActions`, `clickableCardButton` |
-| `decorativeBorder` | `boolean` | `false` | If `true`, shows a decorative border around the card. |
-| `children` | `ReactNode` | `-` | The content to be displayed inside the card body, including custom components and ContentCardActions. |
-| `clickableCard` | `boolean` | `false` | If `true`, wraps the card with an action area and makes it clickable. |
-| `clickableCardProps` | `Partial<SdsMinimalButtonProps>` | `-` | Props forwarded to the clickable card wrapper when clickableCard is true. |
-| `icon` | `ReactNode` | `-` | The icon displayed in the card when `visualElementType` is `icon`. |
-| `image` | `ReactNode` | `-` | The image displayed in the card when `visualElementType` is `image`. |
-| `imagePadding` | `boolean` | `false` | If `true`, applies padding around the image inside the card. |
-| `imagePosition` | `"left"` | `"right"` | `"left"` | Position of the image in the card layout (left or right). |
-| `imageSize` | `number` | `300` | Width of the image area in pixels when `visualElementType` is `image`. |
-| `metadataText` | `ReactNode` | `-` | Optional metadata text, usually used for extra context like date or author. |
-| `overlineText` | `ReactNode` | `-` | A small overline text displayed above the title. |
-| `sdsType` | `"wide"` | `"narrow"` | `"wide"` | Determines the card layout style. `wide` shows the image and content side by side, `narrow` stacks them vertically. |
-| `subtitleText` | `ReactNode` | `-` | Optional subtitle text displayed below the title. |
-| `titleText` | `ReactNode` | `-` | The main title text of the card.  |
-| `visualElementType` | `"image"` | `"icon"` | `"none"` | `"none"` | Specifies what type of visual element to render on the card: an image, an icon, or none. |
+| Name                 | Type                             | Default    | Description                                                                                                                                                                                                                                                                                                                                                |
+| -------------------- | -------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `boundingBox`        | `boolean`                        | `true`     | If `true`, wraps content and visuals inside a bounded layout with background and padding.                                                                                                                                                                                                                                                                  |
+| `buttonsPosition`    | `"left"`                         | `"right"`  | `"left"`                                                                                                                                                                                                                                                                                                                                                   | Determines the alignment of buttons in the ContentCardActions component.                                            |
+| `classes`            | `object`                         | `-`        | Custom class names for different card sub-sections (e.g., cardPaper, cardTitle, cardActions, etc.). Could be used to style the component with TailwindCss. Full list of available class names are:`cardPaper`, `cardContent`, `cardHeader`, `cardMedia`, `cardOverline`, `cardTitle`, `cardSubtitle`, `cardMetadata`, `cardActions`, `clickableCardButton` |
+| `decorativeBorder`   | `boolean`                        | `false`    | If `true`, shows a decorative border around the card.                                                                                                                                                                                                                                                                                                      |
+| `children`           | `ReactNode`                      | `-`        | The content to be displayed inside the card body, including custom components and ContentCardActions.                                                                                                                                                                                                                                                      |
+| `clickableCard`      | `boolean`                        | `false`    | If `true`, wraps the card with an action area and makes it clickable.                                                                                                                                                                                                                                                                                      |
+| `clickableCardProps` | `Partial<SdsMinimalButtonProps>` | `-`        | Props forwarded to the clickable card wrapper when clickableCard is true.                                                                                                                                                                                                                                                                                  |
+| `icon`               | `ReactNode`                      | `-`        | The icon displayed in the card when `visualElementType` is `icon`.                                                                                                                                                                                                                                                                                         |
+| `image`              | `ReactNode`                      | `-`        | The image displayed in the card when `visualElementType` is `image`.                                                                                                                                                                                                                                                                                       |
+| `imagePadding`       | `boolean`                        | `false`    | If `true`, applies padding around the image inside the card.                                                                                                                                                                                                                                                                                               |
+| `imagePosition`      | `"left"`                         | `"right"`  | `"left"`                                                                                                                                                                                                                                                                                                                                                   | Position of the image in the card layout (left or right).                                                           |
+| `imageSize`          | `number`                         | `300`      | Width of the image area in pixels when `visualElementType` is `image`.                                                                                                                                                                                                                                                                                     |
+| `metadataText`       | `ReactNode`                      | `-`        | Optional metadata text, usually used for extra context like date or author.                                                                                                                                                                                                                                                                                |
+| `overlineText`       | `ReactNode`                      | `-`        | A small overline text displayed above the title.                                                                                                                                                                                                                                                                                                           |
+| `sdsType`            | `"wide"`                         | `"narrow"` | `"wide"`                                                                                                                                                                                                                                                                                                                                                   | Determines the card layout style. `wide` shows the image and content side by side, `narrow` stacks them vertically. |
+| `subtitleText`       | `ReactNode`                      | `-`        | Optional subtitle text displayed below the title.                                                                                                                                                                                                                                                                                                          |
+| `titleText`          | `ReactNode`                      | `-`        | The main title text of the card.                                                                                                                                                                                                                                                                                                                           |
+| `visualElementType`  | `"image"`                        | `"icon"`   | `"none"`                                                                                                                                                                                                                                                                                                                                                   | `"none"`                                                                                                            | Specifies what type of visual element to render on the card: an image, an icon, or none. |
 
 ### Code examples
 
->**Note:** Due to a bug in Zeroheight we are unable to publish code examples at this time; we will update this section once a fix is released.
-
+> **Note:** Due to a bug in Zeroheight we are unable to publish code examples at this time; we will update this section once a fix is released.

package/data/zeroheight-exports/Contributing-to-SDS.md

@@ -12,14 +12,14 @@ Use the following guides when you have a new request for something to be added o
 2. If not, submit the request or idea you want to contribute to the SDS by creating a github issue
 3. The SDS Team will assess the request and make sure they understand the needs
 4. **Decision Point**: should it be included in the SDS?
-    1. If the needs are joint across multiple projects, the SDS team will likely decide to include it
-    2. If not, it can become a **Snowflake** (a one-off component maintained by the product teams)
+   1. If the needs are joint across multiple projects, the SDS team will likely decide to include it
+   2. If not, it can become a **Snowflake** (a one-off component maintained by the product teams)
 
 #### Design
 
 1. **Decision Point**: who will build the component, the SDS or product team?
-    1. SDS team – if the SDS team has bandwidth in alignment with other priorities
-    2. Product team – if the product team is in a rush and need it sooner. They may build for SDS or in their own codebase to be incorporated into SDS later
+   1. SDS team – if the SDS team has bandwidth in alignment with other priorities
+   2. Product team – if the product team is in a rush and need it sooner. They may build for SDS or in their own codebase to be incorporated into SDS later
 2. Design Process – gather requirements, design critique, design review with SDS team and product teams, and iteration and hand-off to engineering with specs. Communicate with teams throughout.
 
 #### Implementation and Testing
@@ -37,9 +37,9 @@ Use the following guides when you have a new request for something to be added o
 
 When getting started with contributing, here are guides to follow. Be sure to also partner with an SDS core team member.
 
-* Contributing Design – SDS Feature Design Process
-* Contributing Code – [guide coming soon]
-* Contributing Documentation – [guide coming soon]
+- Contributing Design – SDS Feature Design Process
+- Contributing Code – [guide coming soon]
+- Contributing Documentation – [guide coming soon]
 
 ## Contributor Models
 
@@ -47,10 +47,10 @@ When getting started with contributing, here are guides to follow. Be sure to al
 
 There are a range of tasks and projects to work on as a contributor to the SDS, such as:
 
-* Fixing a bug; grab something from the backlog
-* Flagging things to the SDS team; give the SDS team feedback
-* Brainstorming new feature needs; suggest features
-* Participating in engineering design reviews
+- Fixing a bug; grab something from the backlog
+- Flagging things to the SDS team; give the SDS team feedback
+- Brainstorming new feature needs; suggest features
+- Participating in engineering design reviews
 
 ### Commitment Levels
 
@@ -58,42 +58,41 @@ Contributing to the SDS doesn't need to be a huge time commitment and there are
 
 #### One-Off Contributor (Occasional)
 
-* Contribute when they have free time or interest in a particular project
-* No commitment to contribute long term; contributions can be sporadic
+- Contribute when they have free time or interest in a particular project
+- No commitment to contribute long term; contributions can be sporadic
 
-Some examples include: 
+Some examples include:
 
-* Participating during SDS events, such as hackathons, sprints, or workshops
-* Pick up one-off tickets, such as a well-defined accessibility task
-* Make fixes or contributions on things relevant to your current work—if you’re already working on something on your team and want to contribute back to SDS
+- Participating during SDS events, such as hackathons, sprints, or workshops
+- Pick up one-off tickets, such as a well-defined accessibility task
+- Make fixes or contributions on things relevant to your current work—if you’re already working on something on your team and want to contribute back to SDS
 
 #### Team Representative
 
 These contributors are go-to SDS advocates on their teams and point people. Their expectations include:
 
-* Consistent involvement within their team
-* Act as advocates, spreading awareness and encouraging participation, such as:
-    * Flagging when a SDS component is beneficial
-    * When their team has a need to share with SDS
-    * Watching for breaking changes so their team can react if needed
-* May not be directly involved in development but promote the project's importance
-* Project based: if the SDS team is collaborating on a project with their team
+- Consistent involvement within their team
+- Act as advocates, spreading awareness and encouraging participation, such as:
+  - Flagging when a SDS component is beneficial
+  - When their team has a need to share with SDS
+  - Watching for breaking changes so their team can react if needed
+- May not be directly involved in development but promote the project's importance
+- Project based: if the SDS team is collaborating on a project with their team
 
 Current team representatives:
 
-* Janeece Pourroy – design
-* Harley Thomas – design
-* Karen Liang – design
-* Timmy Huang – engineering
-* Jerry Fu – engineering
+- Janeece Pourroy – design
+- Harley Thomas – design
+- Karen Liang – design
+- Timmy Huang – engineering
+- Jerry Fu – engineering
 
 #### Commitment to a Timeframe (fixed-term)
 
 These contributors commit to a specific period, typically 3 to 6 months, at the Quarter and Half planning times, to work on SDS and its roadmap. This involves:
 
-* Defined time commitment
-* Attend SDS meetings
-* Typically involved in development, planning, or execution of project goals
-* Providing a more predictable level of support over a specified timeframe
-* Revisited after initial timeframe commitment is complete
-
+- Defined time commitment
+- Attend SDS meetings
+- Typically involved in development, planning, or execution of project goals
+- Providing a more predictable level of support over a specified timeframe
+- Revisited after initial timeframe commitment is complete