@dangerousthings/react-native 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dangerous Things
+
+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,154 @@
+# @dangerousthings/react-native
+
+React Native components for the Dangerous Things design system — 18 themed components built on React Native Paper with cyberpunk beveled aesthetics.
+
+## Install
+
+```bash
+npm install @dangerousthings/react-native
+```
+
+### Peer Dependencies
+
+```bash
+npm install react-native-paper react-native-safe-area-context react-native-svg
+```
+
+Optional for custom fonts:
+
+```bash
+npx expo install expo-font
+```
+
+## Setup
+
+Wrap your app with `DTThemeProvider`:
+
+```tsx
+import { DTThemeProvider } from "@dangerousthings/react-native";
+
+export default function App() {
+  return (
+    <DTThemeProvider>
+      {/* your app */}
+    </DTThemeProvider>
+  );
+}
+```
+
+Options:
+
+```tsx
+<DTThemeProvider
+  includeSafeArea={true}  // wraps in SafeAreaProvider (default: true)
+/>
+```
+
+## Components
+
+### Basic
+
+| Component | Description |
+|-----------|-------------|
+| `DTButton` | Beveled button with variant colors (normal, emphasis, warning, success, other) |
+| `DTCard` | Beveled card with optional header and title |
+| `DTChip` | Compact labeled element (MD3 chip style) |
+| `DTLabel` | Top-right beveled label with status colors |
+
+### Forms
+
+| Component | Description |
+|-----------|-------------|
+| `DTTextInput` | Sharp-cornered input with focus glow |
+| `DTCheckbox` | Beveled checkbox with opposing corner cuts |
+| `DTSwitch` | Angular toggle switch |
+| `DTRadioGroup` | Hexagonal radio buttons |
+| `DTQuantityStepper` | Beveled +/- increment buttons |
+| `DTSearchInput` | Search-styled text input |
+
+### Layout & Display
+
+| Component | Description |
+|-----------|-------------|
+| `DTProgressBar` | Angular progress bar with optional label |
+| `DTMediaFrame` | Diagonal beveled frame for images |
+| `DTAccordion` | Collapsible sections with accent border |
+| `DTHexagon` | Decorative hexagon SVG shape |
+
+### Interactive
+
+| Component | Description |
+|-----------|-------------|
+| `DTModal` | Modal dialog with beveled corners |
+| `DTDrawer` | Side drawer with edge bevels |
+| `DTGallery` | Image gallery |
+| `DTMenu` | Dropdown menu with item variants |
+
+## Usage Examples
+
+```tsx
+import { DTButton, DTCard, DTTextInput } from "@dangerousthings/react-native";
+
+// Button with variant
+<DTButton variant="normal" onPress={handlePress}>
+  Scan NFC
+</DTButton>
+
+// Card with title
+<DTCard title="Scan Results" mode="normal">
+  <Text>Chip detected</Text>
+</DTCard>
+
+// Text input with error state
+<DTTextInput
+  variant="normal"
+  label="Username"
+  error={true}
+  errorMessage="Required"
+/>
+```
+
+## Theme Utilities
+
+```tsx
+import { useDTTheme, getColor, getVariantColor } from "@dangerousthings/react-native";
+
+// Access the full theme in a component
+const theme = useDTTheme();
+theme.colors.primary; // "#00FFFF"
+
+// Get a color with optional opacity
+getColor("modeNormal", 0.5); // "rgba(0, 255, 255, 0.5)"
+
+// Resolve a variant name to its color
+getVariantColor("emphasis"); // "#FFFF00"
+```
+
+## Bevel Utilities
+
+Build SVG paths for custom beveled shapes:
+
+```tsx
+import {
+  buildBeveledRectPath,
+  buildButtonBevelPath,
+  buildCardBevelPath,
+} from "@dangerousthings/react-native";
+
+// Custom bevel
+const path = buildBeveledRectPath(200, 48, { bottomRight: 12 });
+
+// Preset bevel paths
+const buttonPath = buildButtonBevelPath(200, 48);
+const cardPath = buildCardBevelPath(300, 200);
+```
+
+## Re-exported Paper Components
+
+For convenience, these React Native Paper components are re-exported:
+
+`Text`, `Surface`, `IconButton`, `ActivityIndicator`, `Divider`, `List`, `Portal`, `Modal`, `Snackbar`, `TextInput`
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangerousthings/react-native",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "React Native themed components for the Dangerous Things design system",
   "license": "MIT",
   "main": "dist/index.js",