tinywidgets 1.0.14 → 1.0.16

package/README.md

@@ -0,0 +1,60 @@
+# TinyWidgets
+
+A collection of tiny, reusable, UI components
+— wrapped in a helpful app layout with header, side bar, dark mode, and more.
+
+See the [website](https://tinywidgets.org/) for more details. Get started [here](https://tinywidgets.org/#installation).
+
+<img width="1213" alt="image" src="https://github.com/user-attachments/assets/22b69545-52d5-424d-ab80-084bb87237f4">
+
+---
+
+## Dependencies
+
+TinyWidgets uses [React](https://react.dev/) for DOM manipulation, [Vanilla-Extract](https://vanilla-extract.style/) at build-time for styling, [Lucide](https://lucide.dev/) for icons, and [TinyBase](https://tinybase.org/) for state management. Its philosophy is all about simplicity, decent defaults, a streamlined DOM, and concise styling.
+
+But, just to be clear - that doesn't mean you need to use Vanilla-Extract, Lucide, or Tinybase in the apps you build with these widgets. You can set arbitrary class names (from Tailwind, for example!) on all components if you like.
+
+## Help out!
+
+This project was created because [I](https://github.com/jamesgpearce) want to be able to build lots of local-first apps quickly and without the overhead of all the app boilerplate each time.
+
+Making it open source seemed like the right thing to do, so please try and it out and get involved. I'll always be interested in issues, more style variants, new components altogether, or even some professional-grade design assistance. I'm not a designer...
+
+See you on [GitHub](https://github.com/tinyplex/tinywidgets)!
+
+## Installation
+
+The easiest way to get started with TinyWidgets is to use its [Vite template](https://github.com/tinyplex/vite-tinywidgets/). This comes with the (simple) build configuration you need to work with TinyWidgets.
+
+To create a new TinyWidgets application using this template, do the following:
+
+1. Make a copy of this template into a new directory:
+
+```sh
+npx tiged tinyplex/vite-tinywidgets my-tinywidgets-app
+```
+
+2. Go into the directory:
+
+```sh
+cd my-tinywidgets-app
+```
+
+3. Install the dependencies:
+
+```sh
+npm install
+```
+
+4. Run the application:
+
+```sh
+npm run dev
+```
+
+5. The Vite server should start up. Go the URL shown and enjoy!
+
+<img width="1160" alt="image" src="https://github.com/user-attachments/assets/073a26dc-4212-4ab0-b5a0-d968ac47342c">
+
+Note that you can also create a production build with `npm run build`.

package/package.json

@@ -1,13 +1,23 @@
 {
   "name": "tinywidgets",
-  "description": "A collection of tiny, reusable, React components",
-  "version": "1.0.14",
-  "scripts": {
-    "prePublishPackage": "eslint . && cspell --quiet . && tsc"
-  },
+  "version": "1.0.16",
   "author": "jamesgpearce",
   "repository": "github:tinyplex/tinywidgets",
+  "license": "MIT",
+  "homepage": "https://tinywidgets.org",
+  "description": "A collection of tiny, reusable, UI components - wrapped in a helpful app layout with header, side bar, dark mode, and more.",
+  "keywords": [
+    "tiny",
+    "local-first",
+    "ui",
+    "components",
+    "styling",
+    "react"
+  ],
   "type": "module",
+  "scripts": {
+    "prePublishPackage": "eslint . && cspell --quiet . && tsc && cp ../README.md ./README.md"
+  },
   "devDependencies": {
     "@types/react": "^18.3.11",
     "@types/react-dom": "^18.3.0",
@@ -26,7 +36,6 @@
     ".": "./src/index.ts",
     "./css": "./src/index.css.ts"
   },
-  "license": "MIT",
   "dependencies": {
     "@vanilla-extract/css": "^1.16.0",
     "lucide-react": "^0.447.0",

package/src/components/Image/index.css.ts

@@ -7,6 +7,10 @@ export const image = style({
   flexShrink: 0,
   width: '100%',
   maxHeight: 'inherit',
+});
+
+export const clickable = style({
+  cursor: 'pointer',
   selectors: {
     '&:hover': {
       backgroundColor: colors.backgroundHover,

package/src/components/Image/index.tsx

@@ -1,5 +1,5 @@
-import {image, imageVariants} from './index.css.ts';
-import React from 'react';
+import React, {useCallback} from 'react';
+import {clickable, image, imageVariants} from './index.css.ts';
 import {classNames} from '../../common/functions.tsx';
 
 /**
@@ -46,6 +46,7 @@ export const Image = ({
   src,
   onClick,
   variant = 'default',
+  href,
   alt,
   className,
 }: {
@@ -65,6 +66,11 @@ export const Image = ({
    * - `icon`
    */
   readonly variant?: keyof typeof imageVariants;
+  /**
+   * A URL that can be used instead of an `onClick` to launch a new web
+   * page, much like a link.
+   */
+  readonly href?: string;
   /**
    * Alternative text shown when the user hovers over the image.
    */
@@ -74,12 +80,22 @@ export const Image = ({
    */
   readonly className?: string;
 }) => {
+  const hrefClick = useCallback(
+    () => (href ? open(href, '_blank', 'noreferrer') : null),
+    [href],
+  );
+
   return (
     <img
       src={src}
-      onClick={onClick}
+      onClick={onClick ?? hrefClick}
       title={alt}
-      className={classNames(image, imageVariants[variant], className)}
+      className={classNames(
+        image,
+        imageVariants[variant],
+        (onClick || href) && clickable,
+        className,
+      )}
     />
   );
 };

package/src/css/global.css.ts

@@ -7,5 +7,5 @@ globalStyle('*', {
   boxSizing: 'border-box',
   color: 'inherit',
   fontSize: 'inherit',
-  ...small({fontSize: '0.85rem'}),
+  ...small({fontSize: '0.9rem'}),
 });