react-material-expressive 1.0.0

package/docs/components/Video.md

@@ -0,0 +1,35 @@
+# Video
+
+Native looping video for ambient/media content: `autoPlay`, `muted`,
+`loop` and `playsInline` are on by default (override via props),
+object-fit cover. The autoplay is decorative motion, so it pauses under
+`prefers-reduced-motion: reduce`.
+
+## Import
+
+```tsx
+import {Video} from "react-material-expressive";
+```
+
+## API
+
+```ts
+type VideoProps = ComponentProps<"video">;
+```
+
+## Example
+
+```tsx
+<Video
+  className="aspect-video w-full rounded-large"
+  poster="/poster.jpg"
+  src="/clip.mp4"
+/>
+```
+
+## Gotchas
+
+- Muted autoplay is required by browsers; unmute only on user gesture.
+- Autoplay pauses when the user prefers reduced motion (WCAG 2.2.2). Pass
+  `controls` if you also want an explicit play/pause affordance.
+- Combine with `MediaFrame` for framed/clipped placements.

package/llms.txt

@@ -0,0 +1,90 @@
+# react-material-expressive
+
+> React component system implementing Material 3 Expressive. Framework-
+> agnostic (native <img>/<a> + media injection), precompiled CSS (no
+> Tailwind setup needed), runtime theming via official --md-sys-* tokens,
+> React >= 19 (ESM + CJS + types, "use client" embedded). Single root
+> export (react-material-expressive) plus the precompiled ./styles.css
+> and the raw ./theme.css Tailwind partial (only to extend with your own
+> Tailwind v4).
+
+## Start here
+
+- [README](README.md): install, quickstart,
+  theming, icons, media/link injection, i18n (per-component `labels` prop,
+  English defaults only; `locale` for Intl formatting), subpath map.
+- [CHANGELOG](CHANGELOG.md): per-release history with a migration note on
+  every breaking change (pre-1.0: breaking bumps the minor version).
+
+## Component docs (API, props, variants, examples, gotchas)
+
+### Actions
+- [Button](docs/components/Button.md)
+- [ButtonGroup](docs/components/ButtonGroup.md)
+- [ButtonGroupConnected](docs/components/ButtonGroupConnected.md)
+- [IconButton](docs/components/IconButton.md)
+- [FAB and ExtendedFAB](docs/components/FAB.md)
+- [FABMenu](docs/components/FABMenu.md)
+- [SplitButton](docs/components/SplitButton.md)
+
+### Communication
+- [Badge, DotBadge, OnIconBadge](docs/components/Badge.md)
+- [Progress and Circle](docs/components/Progress.md)
+- [LoadingIndicator](docs/components/LoadingIndicator.md)
+- [Snackbar and SnackbarWrapper](docs/components/Snackbar.md)
+- [Tooltip](docs/components/Tooltip.md)
+- [Loading](docs/components/Loading.md)
+
+### Containment
+- [Card (+Header/Body/Footer)](docs/components/Card.md)
+- [Dialog (+Header/Body/Footer)](docs/components/Dialog.md)
+- [BottomSheet and SideSheet](docs/components/Sheets.md)
+- [Divider](docs/components/Divider.md)
+- [List (+List.Item)](docs/components/List.md)
+- [Table (+Head/Body/Row/Cell/HeaderCell/TextContainer)](docs/components/Table.md)
+
+### Selection and input
+- [Checkbox](docs/components/Checkbox.md)
+- [Radio](docs/components/Radio.md)
+- [Switch](docs/components/Switch.md)
+- [Chips](docs/components/Chips.md)
+- [Slider and SliderDual](docs/components/Slider.md)
+- [TextField (InputOutlined/InputFilled/TextFieldOutlined/TextFieldFilled)](docs/components/TextField.md)
+- [Select (SelectFilled/SelectOutlined)](docs/components/Select.md)
+- [Amount](docs/components/Amount.md)
+- [DatePicker (+Docked) and DateRangePicker](docs/components/DatePicker.md)
+- [TimePicker (dial + input)](docs/components/TimePicker.md)
+
+### Navigation
+- [NavigationBar (+Item)](docs/components/NavigationBar.md)
+- [NavigationRail (+Item)](docs/components/NavigationRail.md)
+- [TopAppBar (Small/Center/Medium/Large)](docs/components/TopAppBar.md)
+- [DockedToolbar and FloatingToolbar](docs/components/Toolbar.md)
+- [TabsPrimary and TabsSecondary](docs/components/Tabs.md)
+- [LinkBox and LinkContainer](docs/components/Link.md)
+- [Search (+Input/Item)](docs/components/Search.md)
+
+### Menus
+- [Menu (+Item/+Group/+Sub/+Label/+Divider)](docs/components/Menu.md) — shared M3E vertical-menu primitive
+- [Dropdown (+Item)](docs/components/Dropdown.md)
+- [OverflowMenu (+Item)](docs/components/OverflowMenu.md)
+- [ToggleTheme and ToggleThemeMenu](docs/components/ToggleTheme.md)
+
+### Media and showcase
+- [Avatar](docs/components/Avatar.md)
+- [AvatarStack](docs/components/AvatarStack.md)
+- [Img](docs/components/Img.md)
+- [MediaFrame](docs/components/MediaFrame.md)
+- [Gallery (+Row)](docs/components/Gallery.md)
+- [Stories (+User/Business)](docs/components/Stories.md)
+- [Video](docs/components/Video.md)
+- [PerspectiveImage and PerspectiveCard](docs/components/Perspective.md)
+- [Blob](docs/components/Blob.md)
+
+### Text and icons
+- [TextElement](docs/components/TextElement.md)
+- [Icon](docs/components/Icon.md)
+- [MaterialSymbol](docs/components/MaterialSymbol.md)
+
+### Layout
+- [Layers: Container and Section](docs/components/Layers.md)

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "react-material-expressive",
+  "version": "1.0.0",
+  "description": "Material 3 Expressive React component library. Framework-agnostic, precompiled CSS, official M3 design tokens.",
+  "author": "Ger Silva",
+  "homepage": "https://github.com/gersilva96/react-material-expressive#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gersilva96/react-material-expressive.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gersilva96/react-material-expressive/issues"
+  },
+  "keywords": [
+    "react",
+    "material-design",
+    "material-3",
+    "m3-expressive",
+    "components",
+    "design-system",
+    "tailwind"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist",
+    "docs",
+    "CHANGELOG.md",
+    "README.md",
+    "llms.txt"
+  ],
+  "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/styles.css",
+    "./theme.css": "./dist/theme.css",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build:css": "tailwindcss -i src/styles.css -o dist/styles.css --minify",
+    "build:lib": "tsup",
+    "copy:themes": "node scripts/copy-themes.mjs",
+    "build": "npm run clean && npm run build:css && npm run build:lib && npm run copy:themes",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint . --max-warnings=0",
+    "format": "prettier --write .",
+    "pack:dry": "npm pack --dry-run",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm run test"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.6.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@tailwindcss/cli": "4.3.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.2",
+    "@testing-library/user-event": "14.6.1",
+    "@types/jest-axe": "3.5.9",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "eslint": "10.4.1",
+    "globals": "17.6.0",
+    "jest-axe": "10.0.0",
+    "jiti": "2.7.0",
+    "jsdom": "29.1.1",
+    "prettier": "3.8.3",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "rimraf": "6.1.3",
+    "tailwindcss": "4.3.0",
+    "tsup": "8.5.1",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.60.1",
+    "vitest": "4.1.9"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}