@codecademy/styleguide 79.2.1-alpha.2babc6.0 → 79.2.1-alpha.43f244.0

package/.storybook/components/Elements/DetailedCode/DetailedCodeBody/index.tsx

@@ -0,0 +1,22 @@
+import { Source } from '@storybook/blocks';
+
+import { DetailedCodeBodyWrapper, FloatingIndicator } from '../elements';
+import { DetailedCodeBodyProps } from '../types';
+
+export const DetailedCodeBody: React.FC<DetailedCodeBodyProps> = ({
+  code,
+  language,
+  showEllipses = false,
+  codeLines,
+}) => {
+  return (
+    <DetailedCodeBodyWrapper hasShowCodeButton={showEllipses}>
+      <Source code={code} dark language={language} />
+      {showEllipses && (
+        <FloatingIndicator aria-label="More code below">
+          ...{codeLines} more lines
+        </FloatingIndicator>
+      )}
+    </DetailedCodeBodyWrapper>
+  );
+};

package/.storybook/components/Elements/DetailedCode/DetailedCodeButton/index.tsx

@@ -0,0 +1,32 @@
+import { MiniChevronDownIcon } from '@codecademy/gamut-icons';
+import * as React from 'react';
+import { Anchor, Rotation, FlexBox, Text } from '@codecademy/gamut';
+
+import { DetailedCodeButtonProps } from '../types';
+
+export const DetailedCodeButton: React.FC<DetailedCodeButtonProps> = ({
+  isExpanded,
+  onToggle,
+  language,
+}) => {
+  return (
+    <Anchor
+      aria-expanded={isExpanded}
+      px={16}
+      py={12}
+      variant="interface"
+      width="100%"
+      onClick={onToggle}
+    >
+      <FlexBox columnGap={16} justifyContent="space-between">
+        <Text>{language}</Text>
+        <FlexBox columnGap={8} flexDirection="row" alignItems="center">
+          <Text>{isExpanded ? 'Show Less Code' : 'Show More Code'}</Text>
+          <Rotation rotated={isExpanded}>
+            <MiniChevronDownIcon aria-hidden size={16} />
+          </Rotation>
+        </FlexBox>
+      </FlexBox>
+    </Anchor>
+  );
+};

package/.storybook/components/Elements/DetailedCode/elements.tsx

@@ -0,0 +1,45 @@
+import { css } from '@codecademy/gamut-styles';
+import styled from '@emotion/styled';
+import { FlexBox, Box } from '@codecademy/gamut';
+
+export const DetailedCodeWrapper = styled(FlexBox)(
+  css({
+    width: '100%',
+    flexDirection: 'column',
+    borderRadius: 'md',
+    border: 1,
+    bg: 'background',
+  })
+);
+
+export const DetailedCodeBodyWrapper = styled(FlexBox)<{
+  hasShowCodeButton?: boolean;
+}>(({ hasShowCodeButton }) =>
+  css({
+    position: 'relative',
+    flexDirection: 'column',
+    /* Override Storybook's Source component default styles to remove unwanted spacing and borders in the container */
+    '& .docblock-source': {
+      borderRadius: 'none',
+      margin: 0,
+      pb: hasShowCodeButton ? 32 : 0,
+    },
+  })
+);
+
+export const FloatingIndicator = styled(Box)(
+  css({
+    position: 'absolute',
+    bottom: 16,
+    left: 16,
+    zIndex: 1,
+    bg: 'inherit',
+    px: 12,
+    py: 4,
+    fontSize: 14,
+    fontFamily: 'monospace',
+    letterSpacing: '0.1em',
+    /* Color to match the text color in the Source component */
+    textColor: '#C9CDCF',
+  })
+);

package/.storybook/components/Elements/DetailedCode/index.tsx

@@ -0,0 +1,49 @@
+import React, { useState } from 'react';
+
+import { DetailedCodeBody } from './DetailedCodeBody';
+import { DetailedCodeButton } from './DetailedCodeButton';
+import { DetailedCodeWrapper } from './elements';
+import { DetailedCodeProps } from './types';
+
+const DEFAULT_PREVIEW_LINES = 20;
+const DEFAULT_LANGUAGE = 'tsx';
+
+export const DetailedCode: React.FC<DetailedCodeProps> = ({
+  code,
+  initiallyExpanded = false,
+  language = DEFAULT_LANGUAGE,
+  preview = false,
+  previewLines = DEFAULT_PREVIEW_LINES,
+}) => {
+  const [isExpanded, setIsExpanded] = useState(initiallyExpanded);
+  const normalizedPreviewLines = Math.max(0, previewLines);
+  const previewEnabled = preview && normalizedPreviewLines > 0;
+
+  const codeLines = code.trimEnd().split('\n');
+  const hasMoreCode =
+    previewEnabled && codeLines.length > normalizedPreviewLines;
+
+  const previewCode = previewEnabled
+    ? codeLines.slice(0, normalizedPreviewLines).join('\n')
+    : code;
+
+  const displayedCode = isExpanded ? code : previewCode;
+
+  return (
+    <DetailedCodeWrapper>
+      <DetailedCodeBody
+        code={displayedCode}
+        language={language}
+        showEllipses={hasMoreCode && !isExpanded}
+        codeLines={codeLines.length}
+      />
+      {hasMoreCode && (
+        <DetailedCodeButton
+          isExpanded={isExpanded}
+          onToggle={() => setIsExpanded((prev) => !prev)}
+          language={language}
+        />
+      )}
+    </DetailedCodeWrapper>
+  );
+};

package/.storybook/components/Elements/DetailedCode/types.ts

@@ -0,0 +1,25 @@
+import { Source } from '@storybook/blocks';
+import { ComponentProps } from 'react';
+
+type SourceLanguage = ComponentProps<typeof Source>['language'];
+
+export interface DetailedCodeProps {
+  code: string;
+  language?: SourceLanguage;
+  initiallyExpanded?: boolean;
+  preview?: boolean;
+  previewLines?: number;
+}
+
+export interface DetailedCodeButtonProps {
+  isExpanded: boolean;
+  onToggle: () => void;
+  language: SourceLanguage;
+}
+
+export interface DetailedCodeBodyProps {
+  code: string;
+  language: SourceLanguage;
+  showEllipses?: boolean;
+  codeLines: number;
+}

package/.storybook/components/index.tsx

@@ -2,6 +2,7 @@ export * from './ImageWrapper';
 export * from './TokenTable';
 export * from './Headers';
 export * from './Elements/Callout';
+export * from './Elements/DetailedCode';
 export * from './Elements/KeyboardKey';
 export * from './Elements/Markdown';
 export * from './Elements/ImageGallery';

package/.storybook/theming/GamutThemeProvider.tsx

@@ -44,7 +44,7 @@ type GlobalsContext = {
 export const withEmotion = (Story: any, context: GlobalsContext) => {
   const colorMode = context.globals.colorMode ?? 'light';
   const selectedTheme = context.globals.theme;
-  const useLogicalProperties = Boolean(context.globals.logicalProps);
+  const useLogicalProperties = context.globals.logicalProps !== 'false';
   const direction = context.globals.direction ?? 'ltr';
   const background = corePalette[themeBackground[colorMode]];
   const storyRef = useRef<HTMLDivElement>(null);

package/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-### [79.2.1-alpha.2babc6.0](https://github.com/Codecademy/gamut/compare/@codecademy/styleguide@79.2.0...@codecademy/styleguide@79.2.1-alpha.2babc6.0) (2026-03-12)
+### [79.2.1-alpha.43f244.0](https://github.com/Codecademy/gamut/compare/@codecademy/styleguide@79.2.0...@codecademy/styleguide@79.2.1-alpha.43f244.0) (2026-03-18)
 
 **Note:** Version bump only for package @codecademy/styleguide
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@codecademy/styleguide",
   "description": "Styleguide & Component library for codecademy.com",
-  "version": "79.2.1-alpha.2babc6.0",
+  "version": "79.2.1-alpha.43f244.0",
   "author": "Codecademy Engineering",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "repository": "git@github.com:Codecademy/gamut.git",
-  "gitHead": "6075bdc5a1bf15a7337c96581728af96cf3eb7da"
+  "gitHead": "c7d70ef30530dcbb5983cdc0824bddfe789c4b09"
 }

package/src/lib/Organisms/ConnectedForm/ConnectedForm/ConnectedForm.mdx

@@ -1,8 +1,9 @@
 import { Canvas, Controls, Meta } from '@storybook/blocks';
 
-import { ComponentHeader, LinkTo } from '~styleguide/blocks';
+import { ComponentHeader, DetailedCode, LinkTo } from '~styleguide/blocks';
 
 import * as ConnectedFormStories from './ConnectedForm.stories';
+import { example } from './example';
 
 export const parameters = {
   title: 'ConnectedForm',
@@ -40,75 +41,7 @@ This hook also returns the `FormRequiredText` component - include this before yo
 
 ### Example code
 
-```tsx
-import {
-  ConnectedCheckbox,
-  ConnectedInput,
-  ConnectedSelect,
-  useConnectedForm,
-} from '@codecademy/gamut';
-
-import { TerminalIcon } from '@codecademy/gamut-icons';
-
-export const GoodForm = () => {
-  const {
-    ConnectedFormGroup,
-    ConnectedForm,
-    connectedFormProps,
-    FormRequiredText,
-  } = useConnectedForm({
-    defaultValues: {
-      thisField: true,
-      thatField: 'zero',
-      anotherField: 'state your name.',
-    },
-    validationRules: {
-      thisField: { required: 'you need to check this.' },
-      thatField: {
-        pattern: {
-          value: /^(?:(?!zero).)*$/,
-          message: 'literally anything but zero',
-        },
-      },
-    },
-  });
-
-  return (
-    <ConnectedForm
-      onSubmit={({ thisField }) => console.log(thisField)}
-      resetOnSubmit
-      {...connectedFormProps}
-    >
-      <SubmitButton>submit this form.</SubmitButton>
-      <ConnectedFormGroup
-        name="thisField"
-        label="cool checkbox bruh"
-        field={{
-          component: ConnectedCheckbox,
-          label: 'check it ouuut',
-        }}
-      />
-      <ConnectedFormGroup
-        name="thatField"
-        label="cool select dude"
-        field={{
-          component: ConnectedSelect,
-          options: ['one', 'two', 'zero'],
-        }}
-      />
-      <ConnectedFormGroup
-        name="anotherField"
-        label="cool input"
-        field={{
-          component: ConnectedInput,
-          icon: TerminalIcon,
-        }}
-      />
-      <FormRequiredText />
-    </ConnectedForm>
-  );
-};
-```
+<DetailedCode code={example} language="tsx" preview />
 
 ## Variants
 

package/src/lib/Organisms/ConnectedForm/ConnectedForm/example.ts

@@ -0,0 +1,67 @@
+export const example = `import {
+  ConnectedCheckbox,
+  ConnectedInput,
+  ConnectedSelect,
+  useConnectedForm,
+} from '@codecademy/gamut';
+
+import { TerminalIcon } from '@codecademy/gamut-icons';
+
+export const GoodForm = () => {
+  const {
+    ConnectedFormGroup,
+    ConnectedForm,
+    connectedFormProps,
+    FormRequiredText,
+  } = useConnectedForm({
+    defaultValues: {
+      thisField: true,
+      thatField: 'zero',
+      anotherField: 'state your name.',
+    },
+    validationRules: {
+      thisField: { required: 'you need to check this.' },
+      thatField: {
+        pattern: {
+          value: /^(?:(?!zero).)*$/,
+          message: 'literally anything but zero',
+        },
+      },
+    },
+  });
+
+  return (
+    <ConnectedForm
+      onSubmit={({ thisField }) => console.log(thisField)}
+      resetOnSubmit
+      {...connectedFormProps}
+    >
+      <SubmitButton>submit this form.</SubmitButton>
+      <ConnectedFormGroup
+        name="thisField"
+        label="cool checkbox bruh"
+        field={{
+          component: ConnectedCheckbox,
+          label: 'check it ouuut',
+        }}
+      />
+      <ConnectedFormGroup
+        name="thatField"
+        label="cool select dude"
+        field={{
+          component: ConnectedSelect,
+          options: ['one', 'two', 'zero'],
+        }}
+      />
+      <ConnectedFormGroup
+        name="anotherField"
+        label="cool input"
+        field={{
+          component: ConnectedInput,
+          icon: TerminalIcon,
+        }}
+      />
+      <FormRequiredText />
+    </ConnectedForm>
+  );
+};`;