@smartyweb/ui 1.0.0

package/README.md

@@ -0,0 +1,126 @@
+# @smartyweb/ui
+
+Shared React component library consumed by multiple Next.js microservices via private npm.
+
+## Stack
+
+- React 19, TypeScript, SCSS Modules
+- Vite (outputs ESM + CJS + types to `dist/`)
+- Storybook v10 for component development and documentation
+- Changesets for versioning and changelogs
+
+## Getting Started
+
+```bash
+npm install
+```
+
+### Development
+
+```bash
+npm run storybook
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+## Usage
+
+Install the package in your consuming app:
+
+```bash
+npm install @smartyweb/ui
+```
+
+Import styles once in your app's entry point:
+
+```js
+import "@smartyweb/ui/styles.css";
+```
+
+Then import components:
+
+```js
+import { Button } from "@smartyweb/ui";
+```
+
+## Project Structure
+
+```
+src/
+  components/
+    ComponentName/
+      ComponentName.tsx          # "use client" at top
+      ComponentName.module.scss
+      ComponentName.stories.tsx
+      index.ts                   # named export
+    index.ts                     # barrel export
+  styles/
+    _variables.scss
+    _mixins.scss
+    global.scss
+  index.ts                       # main entry point
+```
+
+## Publishing
+
+This package uses [Changesets](https://github.com/changesets/changesets) for versioning and changelog management.
+
+### 1. Document your changes (on your feature branch)
+
+After making changes, create a changeset to describe what changed and the bump type (patch/minor/major):
+
+```bash
+npm run changeset
+```
+
+This opens an interactive prompt. Select the bump type and write a summary. Commit the generated `.changeset/*.md` file along with your code changes.
+
+### 2. Version the package (on master, before publishing)
+
+After merging your feature branch, bump the version and update `CHANGELOG.md`:
+
+```bash
+npx changeset version
+```
+
+Commit the result:
+
+```bash
+git add .
+git commit -m "chore: version bump"
+```
+
+### 3. Publish to npm
+
+Make sure your npm token is set, then build and publish:
+
+```bash
+NPM_TOKEN=<your-token> npm run build && NPM_TOKEN=<your-token> npm run release
+```
+
+Or set it once for the session:
+
+```bash
+export NPM_TOKEN=<your-token>
+npm run build && npm run release
+```
+
+`npm run release` runs `changeset publish`, which publishes any packages whose version in `package.json` is not yet on the registry.
+
+### 4. Push the version commit and tags
+
+```bash
+git push && git push --tags
+```
+
+## Architecture
+
+- **Component library only** — no routing, no pages, no app logic.
+- **All components include `"use client"`** for compatibility with Next.js App Router and Pages Router.
+- **CSS is compiled to a single file at build time.** No runtime CSS injection.
+- **React is a peerDependency**, not bundled.
+- **Stories are co-located with components.**

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react/jsx-runtime"),o="_hExtra_1on9j_1",a={hExtra:o};function c({as:s="h1",children:t,className:e}){const r=[a.hExtra,e].filter(Boolean).join(" ");return n.jsx(s,{className:r,children:t})}const h="_h1_ilnrk_1",i={h1:h};function l({children:s,className:t}){return n.jsx("h1",{className:`${i.h1}${t?` ${t}`:""}`,children:s})}exports.H1=l;exports.HExtra=c;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './text';

package/dist/index.js

@@ -0,0 +1,18 @@
+import { jsx as n } from "react/jsx-runtime";
+const a = "_hExtra_1on9j_1", h = {
+  hExtra: a
+};
+function x({ as: s = "h1", children: t, className: o }) {
+  const r = [h.hExtra, o].filter(Boolean).join(" ");
+  return /* @__PURE__ */ n(s, { className: r, children: t });
+}
+const c = "_h1_ilnrk_1", e = {
+  h1: c
+};
+function i({ children: s, className: t }) {
+  return /* @__PURE__ */ n("h1", { className: `${e.h1}${t ? ` ${t}` : ""}`, children: s });
+}
+export {
+  i as H1,
+  x as HExtra
+};

package/dist/text/H1/H1.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export interface H1Props {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function H1({ children, className }: H1Props): import("react/jsx-runtime").JSX.Element;

package/dist/text/H1/index.d.ts

@@ -0,0 +1 @@
+export { H1 } from './H1';

package/dist/text/HExtra/HExtra.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface HExtraProps {
+    as?: "h1" | "h2" | "h3" | "span";
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function HExtra({ as: Tag, children, className }: HExtraProps): import("react/jsx-runtime").JSX.Element;

package/dist/text/HExtra/index.d.ts

@@ -0,0 +1,2 @@
+export { HExtra } from './HExtra';
+export type { HExtraProps } from './HExtra';

package/dist/text/index.d.ts

@@ -0,0 +1,2 @@
+export * from './HExtra';
+export * from './H1';

package/dist/ui.css

@@ -0,0 +1 @@
+._hExtra_1on9j_1{font-family:TT Hoves Pro,sans-serif;font-weight:600;font-size:96px;line-height:106px;letter-spacing:-.03em;font-feature-settings:"dlig" 1;margin:0}._h1_ilnrk_1{font-family:TT Hoves Pro,sans-serif;font-weight:500;font-size:64px;line-height:64px;letter-spacing:-.02em;font-feature-settings:"dlig" 1;margin:0}

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@smartyweb/ui",
+	"version": "1.0.0",
+	"description": "Shared React component library",
+	"type": "module",
+	"main": "dist/index.cjs",
+	"module": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./styles.css": "./dist/ui.css"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "vite build",
+		"typecheck": "tsc --noEmit",
+		"changeset": "changeset",
+		"release": "changeset publish",
+		"storybook": "storybook dev -p 6006",
+		"build-storybook": "storybook build"
+	},
+	"peerDependencies": {
+		"react": "^19.0.0",
+		"react-dom": "^19.0.0"
+	},
+	"devDependencies": {
+		"@changesets/cli": "^2.29.8",
+		"@storybook/react-vite": "^10.2.8",
+		"@types/react": "^19.2.13",
+		"@types/react-dom": "^19.2.3",
+		"@vitejs/plugin-react": "^5.1.3",
+		"prettier": "^3.8.1",
+		"react": "^19.2.4",
+		"react-dom": "^19.2.4",
+		"sass": "^1.97.3",
+		"storybook": "^10.2.8",
+		"typescript": "^5.9.3",
+		"vite": "^7.3.1",
+		"vite-plugin-dts": "^4.5.4"
+	}
+}