@viraui/react 0.0.1

package/dist/surface/surface.guide.json

@@ -0,0 +1,23 @@
+{
+  "name": "Surface",
+  "summary": "Presentational container with token background, optional border, radius, and padding.",
+  "whenToUse": [
+    "Group content with base-level background and contrast border",
+    "Popup or card chrome with optional hover background",
+    "Compose with Elevator for animated elevation transitions"
+  ],
+  "whenNotToUse": [
+    "Interactive control semantics without an appropriate render root",
+    "Expecting hover background on touch-primary devices"
+  ],
+  "accessibility": [
+    "Surface is presentational — pair with headings or labels so grouped content is discoverable",
+    "Choose render roots with correct roles when Surface wraps interactive content",
+    "Do not rely on hover-only background changes as the only state indicator"
+  ],
+  "antiPatterns": [
+    "Overwriting transition shorthand without composing box-shadow when data-elevation is present",
+    "Assuming hoverColor applies on touch devices"
+  ],
+  "related": ["Elevator", "Stack"]
+}

package/dist/switch/switch.guide.json

@@ -0,0 +1,23 @@
+{
+  "name": "Switch",
+  "summary": "Field-wrapped toggle control with regular or small track and optional field copy.",
+  "whenToUse": [
+    "Boolean on/off settings with optional label and helper text",
+    "Compact small or regular track sizes",
+    "Invalid and disabled states with Textfield-parity focus treatment"
+  ],
+  "whenNotToUse": [
+    "Unlabeled switch without aria-label on the root",
+    "Expecting size or variant beyond regular and small"
+  ],
+  "accessibility": [
+    "Provide visible label or aria-label so the switch has an accessible name",
+    "Checked state must map to the native switch semantics exposed by the control",
+    "Surface invalid state and error copy through the shared field pattern"
+  ],
+  "antiPatterns": [
+    "Rendering a switch without label and without aria-label",
+    "Expecting description to stay visible when invalid without an error message"
+  ],
+  "related": ["Textfield", "Stack", "Text"]
+}

package/dist/text/text.guide.json

@@ -0,0 +1,20 @@
+{
+  "name": "Text",
+  "summary": "Theme-aware body-copy primitive with tone, family, and responsive body sizing.",
+  "whenToUse": [
+    "Body copy with semantic tone and token-backed typography",
+    "Helper, label, or inline copy inside other components",
+    "Mono or body family text with fluid clamp sizing"
+  ],
+  "whenNotToUse": [
+    "Headings or display typography — use Title",
+    "Heading semantics without an appropriate render root"
+  ],
+  "accessibility": [
+    "Use Text for body copy; do not substitute for heading elements in the document outline",
+    "Semantic tone supports meaning but does not replace explicit labels on controls",
+    "Choose render when the copy must live on a specific inline or block element"
+  ],
+  "antiPatterns": ["Using Text for headings instead of Title"],
+  "related": ["Title", "ClampText"]
+}

package/dist/textarea/textarea.guide.json

@@ -0,0 +1,17 @@
+{
+  "name": "Textarea",
+  "summary": "Multi-line field control with shared field copy and optional resize.",
+  "whenToUse": [
+    "Multi-line text entry with label, description, and error",
+    "Controlled vertical or bidirectional resize",
+    "Native textarea attributes through the field control"
+  ],
+  "whenNotToUse": ["Single-line input — use Textfield", "Addon slots like Textfield startAddon or endAddon"],
+  "accessibility": [
+    "Associate label with the textarea through the field label pattern",
+    "Expose validation and helper copy through description and error slots",
+    "Prefer resize modes that do not hide required content from keyboard users"
+  ],
+  "antiPatterns": ["Using Textarea for single-line values", "Expecting unsupported size or variant props"],
+  "related": ["Textfield", "Text"]
+}

package/dist/textfield/textfield.guide.json

@@ -0,0 +1,20 @@
+{
+  "name": "Textfield",
+  "summary": "Single-line field input with control-group chrome and optional addons.",
+  "whenToUse": [
+    "Single-line text, email, password, or similar native input types",
+    "Start or end addon slots inside the shared control group",
+    "Label, description, and error copy with validation states"
+  ],
+  "whenNotToUse": ["Multi-line entry — use Textarea", "Custom size or variant props — fixed medium treatment"],
+  "accessibility": [
+    "Associate label with the input through the field label pattern",
+    "Surface validation errors in the shared description slot or Field.Error",
+    "Addon buttons must keep type=\"button\" and their own accessible names"
+  ],
+  "antiPatterns": [
+    "Passing unsupported size or variant props",
+    "Expecting a focus ring when focus is only on addon controls"
+  ],
+  "related": ["Textarea", "Select", "Text"]
+}

package/dist/title/title.guide.json

@@ -0,0 +1,20 @@
+{
+  "name": "Title",
+  "summary": "Theme-aware heading and display typography primitive.",
+  "whenToUse": [
+    "Headings and display text with title presets",
+    "Semantic heading tags chosen through render",
+    "Fluid clamp sizing across title levels"
+  ],
+  "whenNotToUse": ["Body copy — use Text", "Body or mono family typography"],
+  "accessibility": [
+    "Choose render to match the correct heading level for the page outline",
+    "Visual level presets do not replace picking the right h1–h6 element",
+    "Keep heading hierarchy sequential; do not skip levels for styling alone"
+  ],
+  "antiPatterns": [
+    "Letting level force the HTML tag instead of choosing render explicitly",
+    "Using Title for long body paragraphs"
+  ],
+  "related": ["Text", "ClampText"]
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@viraui/react",
+  "version": "0.0.1",
+  "private": false,
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "imports": {
+    "#internal-icons/icon-registry": {
+      "types": "./dist/internal-icons/icon-registry.d.ts",
+      "default": "./dist/internal-icons/icon-registry.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./preflight.css": "./dist/preflight.css",
+    "./catalog.json": "./dist/catalog.json",
+    "./consumption.json": "./dist/consumption.json",
+    "./theme-surface.json": "./dist/theme-surface.json",
+    "./*.css": "./dist/*/*.css",
+    "./*.guide.json": "./dist/*/*.guide.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "run-s clean build:icons build:types build:css build:catalog",
+    "build:css": "run-s build:css:components build:css:preflight build:css:guides",
+    "build:css:components": "copyfiles -u 1 \"src/components/**/*.css\" dist",
+    "build:css:preflight": "postcss src/preflight.css --output dist/preflight.css",
+    "build:css:guides": "copyfiles -u 2 \"src/components/**/*.guide.json\" dist && copyfiles -u 1 \"src/guides/*.json\" dist",
+    "build:catalog": "node --import tsx src/build-catalog.ts",
+    "build:icons": "node --import tsx src/build-icons.ts",
+    "build:types": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@viraui/icons": "workspace:*",
+    "clsx": "2.1.1"
+  },
+  "devDependencies": {
+    "@base-ui/react": "1.5.0",
+    "@viraui/foundation": "workspace:*",
+    "@viraui/postcss-config": "workspace:*",
+    "@viraui/tsconfig": "workspace:*",
+    "postcss-cli": "11.0.1",
+    "react": ">=19.2.7",
+    "react-dom": ">=19.2.7",
+    "svger-cli": "4.0.8"
+  },
+  "peerDependencies": {
+    "@base-ui/react": ">=1.5.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  }
+}