@nationaldesignstudio/react 0.0.15 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nationaldesignstudio/react",
-	"version": "0.0.15",
+	"version": "0.0.16",
 	"type": "module",
 	"sideEffects": [
 		"*.css"
@@ -17,7 +17,8 @@
 		"./tailwind.css": "./dist/tailwind.css"
 	},
 	"files": [
-		"dist"
+		"dist",
+		"src"
 	],
 	"scripts": {
 		"dev": "storybook dev -p 6006",

package/src/App.tsx

@@ -0,0 +1,7 @@
+import "./App.css";
+
+function App() {
+	return <h1 className="text-3xl font-bold underline">Hello world!</h1>;
+}
+
+export default App;

package/src/assets/react.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/src/components/atoms/accordion/accordion.stories.tsx

@@ -0,0 +1,228 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Accordion, AccordionItem } from ".";
+
+const meta: Meta<typeof Accordion> = {
+	title: "Atoms/Accordion",
+	component: Accordion,
+	parameters: {
+		layout: "padded",
+	},
+	argTypes: {
+		allowMultiple: {
+			control: "boolean",
+			description: "Allow multiple items to be expanded at once",
+		},
+		defaultExpanded: {
+			control: "text",
+			description: "ID of item to expand by default",
+		},
+	},
+	decorators: [
+		(Story) => (
+			<div className="p-spacing-56 max-w-[746px]">
+				<Story />
+			</div>
+		),
+	],
+} as Meta<typeof Accordion>;
+
+export default meta;
+type Story = StoryObj<typeof Accordion>;
+
+// =============================================================================
+// Default
+// =============================================================================
+
+export const Default: Story = {
+	render: (args) => (
+		<Accordion {...args}>
+			<AccordionItem
+				id="item-1"
+				title="What is the US Tech Force (Tech Force)?"
+			>
+				Tech Force will be an elite group of ~1,000 technology specialists hired
+				by agencies to accelerate artificial intelligence (AI) implementation
+				and solve the federal government's most critical technological
+				challenges.
+			</AccordionItem>
+			<AccordionItem
+				id="item-2"
+				title="What are the key steps in the recruiting process?"
+			>
+				The recruiting process includes an initial application, technical
+				assessment, interviews with agency leadership, and a background check.
+				Selected candidates will receive an offer within 4-6 weeks of completing
+				all steps.
+			</AccordionItem>
+			<AccordionItem id="item-3" title="What skills are required?">
+				We're looking for expertise in software engineering, artificial
+				intelligence, cybersecurity, data analytics, or technical project
+				management. Strong problem-solving abilities and a passion for public
+				service are essential.
+			</AccordionItem>
+		</Accordion>
+	),
+};
+Default.args = {
+	defaultExpanded: "item-1",
+};
+
+// =============================================================================
+// With First Item Expanded
+// =============================================================================
+
+export const FirstItemExpanded: Story = {
+	render: () => (
+		<Accordion defaultExpanded="item-1">
+			<AccordionItem
+				id="item-1"
+				title="What is the US Tech Force (Tech Force)?"
+			>
+				Tech Force will be an elite group of ~1,000 technology specialists hired
+				by agencies to accelerate artificial intelligence (AI) implementation
+				and solve the federal government's most critical technological
+				challenges. Tech Force will primarily recruit early-career technologists
+				from traditional recruiting channels, along with experienced engineering
+				managers from private sector partners, to serve two-year employment
+				terms in the federal government.
+			</AccordionItem>
+			<AccordionItem
+				id="item-2"
+				title="What are the key steps in the recruiting process?"
+			>
+				The recruiting process includes an initial application, technical
+				assessment, interviews with agency leadership, and a background check.
+			</AccordionItem>
+			<AccordionItem id="item-3" title="What skills are required?">
+				We're looking for expertise in software engineering, AI, cybersecurity,
+				data analytics, or technical project management.
+			</AccordionItem>
+		</Accordion>
+	),
+};
+
+// =============================================================================
+// Allow Multiple
+// =============================================================================
+
+export const AllowMultiple: Story = {
+	render: () => (
+		<Accordion allowMultiple defaultExpanded={["item-1", "item-2"]}>
+			<AccordionItem
+				id="item-1"
+				title="What is the US Tech Force (Tech Force)?"
+			>
+				Tech Force will be an elite group of ~1,000 technology specialists hired
+				by agencies to accelerate artificial intelligence (AI) implementation
+				and solve the federal government's most critical technological
+				challenges.
+			</AccordionItem>
+			<AccordionItem
+				id="item-2"
+				title="What are the key steps in the recruiting process?"
+			>
+				The recruiting process includes an initial application, technical
+				assessment, interviews with agency leadership, and a background check.
+			</AccordionItem>
+			<AccordionItem id="item-3" title="What skills are required?">
+				We're looking for expertise in software engineering, AI, cybersecurity,
+				data analytics, or technical project management.
+			</AccordionItem>
+		</Accordion>
+	),
+};
+
+// =============================================================================
+// All Collapsed
+// =============================================================================
+
+export const AllCollapsed: Story = {
+	render: () => (
+		<Accordion>
+			<AccordionItem
+				id="item-1"
+				title="What is the US Tech Force (Tech Force)?"
+			>
+				Tech Force will be an elite group of ~1,000 technology specialists.
+			</AccordionItem>
+			<AccordionItem
+				id="item-2"
+				title="What are the key steps in the recruiting process?"
+			>
+				The recruiting process includes an initial application and interviews.
+			</AccordionItem>
+			<AccordionItem id="item-3" title="What skills are required?">
+				Software engineering, AI, cybersecurity, data analytics.
+			</AccordionItem>
+		</Accordion>
+	),
+};
+
+// =============================================================================
+// FAQ Example (Full)
+// =============================================================================
+
+export const FAQExample: Story = {
+	render: () => (
+		<Accordion defaultExpanded="faq-1">
+			<AccordionItem id="faq-1" title="What is the US Tech Force (Tech Force)?">
+				Tech Force will be an elite group of ~1,000 technology specialists hired
+				by agencies to accelerate artificial intelligence (AI) implementation
+				and solve the federal government's most critical technological
+				challenges. Tech Force will primarily recruit early-career technologists
+				from traditional recruiting channels, along with experienced engineering
+				managers from private sector partners, to serve two-year employment
+				terms in the federal government. Tech Force will include centralized
+				organization and programming and serve as a recruiting platform
+				post-employment.
+			</AccordionItem>
+			<AccordionItem
+				id="faq-2"
+				title="What are the key steps in the recruiting process?"
+			>
+				The recruiting process includes an initial application, technical
+				assessment, interviews with agency leadership, and a background check.
+				Selected candidates will receive an offer within 4-6 weeks of completing
+				all steps.
+			</AccordionItem>
+			<AccordionItem id="faq-3" title="What skills are required?">
+				We're looking for expertise in software engineering, artificial
+				intelligence, cybersecurity, data analytics, or technical project
+				management. Strong problem-solving abilities and a passion for public
+				service are essential.
+			</AccordionItem>
+			<AccordionItem
+				id="faq-4"
+				title="Are specific educational credentials required to participate?"
+			>
+				While we value diverse educational backgrounds, candidates should
+				demonstrate strong technical skills through their work experience,
+				projects, or certifications. A traditional degree is not strictly
+				required.
+			</AccordionItem>
+			<AccordionItem
+				id="faq-5"
+				title="Is there a minimum experience level required to apply?"
+			>
+				We welcome applications from early-career technologists with 1-3 years
+				of experience as well as experienced professionals. What matters most is
+				your ability to contribute to critical government technology challenges.
+			</AccordionItem>
+			<AccordionItem id="faq-6" title="Is this a political appointment?">
+				No, Tech Force positions are not political appointments. Participants
+				are hired as federal employees based on their technical qualifications
+				and serve in non-partisan roles focused on technology implementation.
+			</AccordionItem>
+			<AccordionItem id="faq-7" title="When am I expected to start?">
+				Start dates vary by cohort. Most participants begin within 2-3 months of
+				receiving their offer, pending completion of background checks and
+				onboarding requirements.
+			</AccordionItem>
+			<AccordionItem id="faq-8" title="Where will the employment be located?">
+				Positions are primarily based in Washington, D.C., though some roles may
+				be available at agency locations across the country. Remote work options
+				vary by agency and role.
+			</AccordionItem>
+		</Accordion>
+	),
+};

package/src/components/atoms/accordion/accordion.tsx

@@ -0,0 +1,219 @@
+"use client";
+
+import { Accordion as BaseAccordion } from "@base-ui-components/react/accordion";
+import * as React from "react";
+import { tv, type VariantProps } from "tailwind-variants";
+import { cn } from "@/lib/utils";
+
+// =============================================================================
+// Accordion Variants
+// =============================================================================
+
+const accordionVariants = tv({
+	base: "flex flex-col",
+	variants: {
+		variant: {
+			dark: "",
+			light: "",
+		},
+	},
+	defaultVariants: {
+		variant: "dark",
+	},
+});
+
+const accordionItemVariants = tv({
+	base: "border-b overflow-hidden",
+	variants: {
+		variant: {
+			dark: "border-gray-300",
+			light: "border-gray-500",
+		},
+	},
+	defaultVariants: {
+		variant: "dark",
+	},
+});
+
+const accordionTriggerVariants = tv({
+	base: [
+		// Uses primitive spacing tokens
+		"flex w-full items-center justify-between py-spacing-24 text-left",
+		"typography-body-large transition-colors cursor-pointer",
+	],
+	variants: {
+		variant: {
+			dark: "text-gray-100 data-[open]:text-white",
+			light: "text-gray-800 data-[open]:text-gray-900",
+		},
+	},
+	defaultVariants: {
+		variant: "dark",
+	},
+});
+
+const accordionPanelVariants = tv({
+	// Uses primitive spacing tokens
+	base: "typography-body-large pb-spacing-24",
+	variants: {
+		variant: {
+			dark: "text-gray-100",
+			light: "text-gray-800",
+		},
+	},
+	defaultVariants: {
+		variant: "dark",
+	},
+});
+
+// =============================================================================
+// Accordion Context
+// =============================================================================
+
+const AccordionContext = React.createContext<{
+	variant: "dark" | "light";
+}>({
+	variant: "dark",
+});
+
+// =============================================================================
+// Accordion
+// =============================================================================
+
+export interface AccordionProps
+	extends React.HTMLAttributes<HTMLDivElement>,
+		VariantProps<typeof accordionVariants> {
+	/**
+	 * Allow multiple items to be expanded at once
+	 * @default false
+	 */
+	allowMultiple?: boolean;
+	/**
+	 * The ID(s) of items that should be expanded by default
+	 */
+	defaultExpanded?: string | string[];
+	children: React.ReactNode;
+}
+
+/**
+ * Accordion component for expandable/collapsible content sections.
+ * Built on Base UI's Accordion primitive.
+ *
+ * Variants:
+ * - dark: Dark theme styling (default)
+ * - light: Light theme styling
+ *
+ * @example
+ * ```tsx
+ * <Accordion defaultExpanded="item-1" variant="dark">
+ *   <AccordionItem id="item-1" title="Question 1">
+ *     Answer to question 1
+ *   </AccordionItem>
+ *   <AccordionItem id="item-2" title="Question 2">
+ *     Answer to question 2
+ *   </AccordionItem>
+ * </Accordion>
+ * ```
+ */
+const Accordion = React.forwardRef<HTMLDivElement, AccordionProps>(
+	(
+		{
+			className,
+			allowMultiple = false,
+			defaultExpanded,
+			variant = "light",
+			children,
+		},
+		ref,
+	) => {
+		// Normalize defaultExpanded to array format for Base UI
+		const defaultValue = React.useMemo((): string[] | undefined => {
+			if (!defaultExpanded) return undefined;
+			if (Array.isArray(defaultExpanded)) return defaultExpanded;
+			return [defaultExpanded];
+		}, [defaultExpanded]);
+
+		return (
+			<AccordionContext.Provider value={{ variant: variant ?? "dark" }}>
+				<BaseAccordion.Root
+					ref={ref}
+					className={accordionVariants({ variant, class: className })}
+					defaultValue={defaultValue}
+					multiple={allowMultiple}
+				>
+					{children}
+				</BaseAccordion.Root>
+			</AccordionContext.Provider>
+		);
+	},
+);
+Accordion.displayName = "Accordion";
+
+// =============================================================================
+// AccordionItem
+// =============================================================================
+
+export interface AccordionItemProps
+	extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+	/**
+	 * Unique identifier for this item
+	 */
+	id: string;
+	/**
+	 * The question/title displayed in the header
+	 */
+	title: string;
+	/**
+	 * The answer/content revealed when expanded
+	 */
+	children: React.ReactNode;
+}
+
+/**
+ * Individual accordion item with collapsible content.
+ * Must be used within an Accordion component.
+ */
+const AccordionItem = React.forwardRef<HTMLDivElement, AccordionItemProps>(
+	({ className, id, title, children }, ref) => {
+		const { variant } = React.useContext(AccordionContext);
+
+		return (
+			<BaseAccordion.Item
+				ref={ref}
+				value={id}
+				className={accordionItemVariants({ variant, class: className })}
+			>
+				{/* Header - always visible */}
+				<BaseAccordion.Header>
+					<BaseAccordion.Trigger
+						className={accordionTriggerVariants({ variant })}
+					>
+						<span>{title}</span>
+						<span
+							className={cn(
+								"text-base transition-transform duration-200",
+								"[[data-open]_&]:rotate-45",
+							)}
+						>
+							+
+						</span>
+					</BaseAccordion.Trigger>
+				</BaseAccordion.Header>
+
+				{/* Content - collapsible */}
+				<BaseAccordion.Panel
+					className={cn(
+						"h-[var(--accordion-panel-height)] overflow-hidden",
+						"transition-[height] duration-300 ease-out",
+						"[&[data-starting-style]]:h-0 [&[data-ending-style]]:h-0",
+					)}
+				>
+					<div className={accordionPanelVariants({ variant })}>{children}</div>
+				</BaseAccordion.Panel>
+			</BaseAccordion.Item>
+		);
+	},
+);
+AccordionItem.displayName = "AccordionItem";
+
+export { Accordion, AccordionItem, accordionVariants };

package/src/components/atoms/accordion/index.ts

@@ -0,0 +1,6 @@
+export {
+	Accordion,
+	AccordionItem,
+	type AccordionItemProps,
+	type AccordionProps,
+} from "./accordion";

package/src/components/atoms/button/button.stories.tsx

@@ -0,0 +1,102 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Button } from ".";
+
+const meta: Meta<typeof Button> = {
+	title: "Atoms/Button",
+} as Meta<typeof Button>;
+
+export default meta;
+type Story = StoryObj<typeof Button>;
+
+export const Playground: Story = {
+	render: (args) => <Button {...args}>Button</Button>,
+};
+Playground.argTypes = {
+	size: {
+		control: {
+			type: "radio",
+		},
+		options: ["sm", "default", "lg"],
+	},
+	disabled: {
+		control: {
+			type: "boolean",
+		},
+	},
+	variant: {
+		control: {
+			type: "radio",
+		},
+		options: [
+			"primary",
+			"primaryOutline",
+			"secondary",
+			"charcoal",
+			"charcoalOutline",
+			"charcoalOutlineQuiet",
+			"ivory",
+			"ivoryOutline",
+			"ivoryOutlineQuiet",
+			"gray",
+		],
+	},
+};
+Playground.args = {
+	size: "default",
+	disabled: false,
+	variant: "primary",
+};
+
+// =============================================================================
+// Semantic Variants (recommended)
+// =============================================================================
+
+export const Primary = () => <Button variant="primary">Primary</Button>;
+
+export const PrimaryOutline = () => (
+	<Button variant="primaryOutline">Primary Outline</Button>
+);
+
+export const Secondary = () => <Button variant="secondary">Secondary</Button>;
+
+// =============================================================================
+// Legacy Variants
+// =============================================================================
+
+export const Charcoal = () => <Button variant="charcoal">Charcoal</Button>;
+
+export const CharcoalOutline = () => (
+	<Button variant="charcoalOutline">Charcoal Outline</Button>
+);
+
+export const CharcoalOutlineQuiet = () => (
+	<Button variant="charcoalOutlineQuiet">Charcoal Outline Quiet</Button>
+);
+
+export const Ivory = () => <Button variant="ivory">Ivory</Button>;
+
+export const IvoryOutline = () => (
+	<Button variant="ivoryOutline">Ivory Outline</Button>
+);
+
+export const IvoryOutlineQuiet = () => (
+	<Button variant="ivoryOutlineQuiet">Ivory Outline Quiet</Button>
+);
+
+export const Gray = () => <Button variant="gray">Gray</Button>;
+
+// =============================================================================
+// Sizes
+// =============================================================================
+
+export const Small = () => <Button size="sm">Small</Button>;
+
+export const Medium = () => <Button size="default">Medium</Button>;
+
+export const Large = () => <Button size="lg">Large</Button>;
+
+// =============================================================================
+// States
+// =============================================================================
+
+export const Disabled = () => <Button disabled>Disabled</Button>;