@structuralists/scaffolding 0.0.1

package/.storybook/main.ts

@@ -0,0 +1,9 @@
+import type { StorybookConfig } from '@storybook/react-vite';
+
+const config: StorybookConfig = {
+  framework: '@storybook/react-vite',
+  stories: ['../src/**/*.stories.@(ts|tsx)'],
+  addons: ['@storybook/addon-essentials', '@storybook/addon-storysource'],
+};
+
+export default config;

package/.storybook/manager.ts

@@ -0,0 +1,13 @@
+import { addons } from 'storybook/manager-api';
+import { themes } from 'storybook/theming';
+
+const mq = window.matchMedia('(prefers-color-scheme: dark)');
+
+const apply = (isDark: boolean) => {
+  addons.setConfig({
+    theme: isDark ? themes.dark : themes.light,
+  });
+};
+
+apply(mq.matches);
+mq.addEventListener('change', (e) => apply(e.matches));

package/.storybook/preview.tsx

@@ -0,0 +1,18 @@
+import type { Preview } from '@storybook/react';
+import { MemoryRouter } from 'react-router';
+import '../tokens.css';
+
+const preview: Preview = {
+  parameters: {
+    layout: 'padded',
+  },
+  decorators: [
+    (Story) => (
+      <MemoryRouter>
+        <Story />
+      </MemoryRouter>
+    ),
+  ],
+};
+
+export default preview;

package/CLAUDE.md

@@ -0,0 +1,30 @@
+# @structuralists/scaffolding
+
+Generic React component library. Storybook for dev.
+
+Designed to be used to scaffold up an app
+
+## Conventions
+
+### Component prop destructuring
+
+React components must take a single argument named `props` and destructure
+on the first line of the function body — not in the parameter list.
+
+```tsx
+// ✅ correct
+export const Foo = (props: FooProps) => {
+  const { a, b, c } = props;
+
+  return <div>{a}</div>;
+};
+
+// ❌ wrong — destructures in the parameter list
+export const Foo = ({ a, b, c }: FooProps) => {
+  return <div>{a}</div>;
+};
+```
+
+Why: the destructuring line at the top of the body acts as a quick legend
+of what the component reads from its props, scannable without parsing the
+function signature. Keeps the call shape uniform across the package.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 William Lubelski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @structuralists/scaffolding
+
+`@structuralists/scaffolding` is a bundle of react components that can make scaffolding a UI quick and efficient.  Unlike component libraries like a material UI, it does not target being used for production grade applications, but instead targets getting "something" up and running, where you don't care what exactly it looks like.
+
+It is not designed to be customized.  it's not pluggable.  It is not designed to composed into another design system (though it is react, you can write you own components and pass them as children or whatever to your heart's content.)
+
+It is designed to get you something working, and if you then do care what that looks like, build or import a design system and convert to that.