nextworks 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/kits/forms/.nextworks/docs/FORMS_QUICKSTART.md

@@ -0,0 +1,85 @@
+# Forms Quickstart — Example page
+
+This short doc points to the minimal example that demonstrates how to use the Forms primitives with Select, Checkbox and Switch components. It also documents the ApiResult pattern for mapping server field errors into react-hook-form and points to the per-field async validation helper used in the signup form.
+
+> To add these examples and primitives to your own app via the CLI, the recommended alpha setup is to install Blocks with sections and templates first, then Forms:
+>
+> ```bash
+> npx nextworks add blocks --sections --templates
+> npx nextworks add forms
+> ```
+>
+> The CLI will copy the Forms primitives and example pages into your `components/ui/form/*`, `components/hooks/`, `lib/validation/*`, and `app/examples/forms/*` directories.
+
+Where to find the example
+
+- Example page: /examples/forms/basic
+  - Full path in repo: app/examples/forms/basic/page.tsx
+
+What the example shows
+
+- react-hook-form + zodResolver integration using the project's Form primitives
+- Usage of Select, Checkbox and Switch UI components with FormField (which uses RHF Controller under the hood)
+- A minimal submit handler (client-side) you can copy/replace with your API call
+
+How to try it locally
+
+1. Start the dev server:
+   npm run dev
+2. Open your browser and visit:
+   http://localhost:3000/examples/forms/basic
+
+Note: Some examples that hit the server (such as the wizard/server-action flows) assume you have a Prisma schema and database configured in your app, often via Auth Core/Data. If you haven’t set that up yet, expect those examples to need additional setup.
+The Forms kit does **not** include a Prisma schema; you must define your own `prisma/schema.prisma` and run Prisma migrations if you want the server-action and wizard examples to use a real database.
+
+Tip: If you change the Prisma schema, run:
+npx prisma generate
+npx prisma migrate dev
+
+Copy/paste tips for your app
+
+- Import Form primitives and controls from:
+  - components/ui/form/\* (Form, FormField, FormItem, FormLabel, FormControl, FormMessage)
+  - components/ui/select.tsx, components/ui/checkbox.tsx, components/ui/switch.tsx
+- The example shows how to forward checkbox/switch changes to RHF by using f.onChange(e.target.checked) and setting checked={!!f.value}.
+
+If you want the example to submit to your API, replace the onSubmit handler's console/alert with a fetch() call or server action.
+
+---
+
+Kit manifest & files (for packaging)
+
+If you plan to package a Forms kit (CLI or manual copy), here are the primary files used by the examples and primitives. This manifest is for documentation and packaging reference.
+
+Files
+
+- components/ui/form/form.tsx
+- components/ui/form/form-field.tsx
+- components/ui/form/form-item.tsx
+- components/ui/form/form-control.tsx
+- components/ui/form/form-description.tsx
+- components/ui/form/form-label.tsx
+- components/ui/form/form-message.tsx
+- components/ui/select.tsx
+- components/ui/checkbox.tsx
+- components/ui/switch.tsx
+- components/hooks/useCheckUnique.ts
+- lib/validation/forms.ts
+- lib/validation/wizard.ts
+- lib/forms/map-errors.ts
+- app/examples/forms/basic/page.tsx
+- app/examples/forms/server-action/page.tsx
+- app/examples/forms/server-action/form-client.tsx
+- app/examples/forms/wizard/wizard-client.tsx
+- app/examples/forms/wizard/page.tsx
+
+API routes (used by examples)
+
+- app/api/wizard/route.ts
+
+Notes
+
+- The Forms primitives are UI-only and do not require Prisma or NextAuth to function. The server-action example and the mapping helper demonstrate how to validate server-side and map errors back to react-hook-form.
+- If you are packaging the kit, consider copying only components/ui/form/\* and the select/checkbox/switch files, plus the example pages if you want to keep the demo pages.
+
+If you want, I can create docs/FORMS_MANIFEST.json in the repo with the above manifest for the CLI packaging step.

package/dist/kits/forms/{README.md → .nextworks/docs/FORMS_README.md}

@@ -21,9 +21,21 @@ What the kit includes
 Notes
 
 - The forms primitives are UI-only and do not require Prisma or NextAuth.
+- The Forms kit does **not** ship a Prisma schema; if you use the server-action or wizard examples against a real database, you must add a `prisma/schema.prisma` in your app and run `npx prisma generate` and `npx prisma migrate dev`.
 - The wizard example assumes a basic app/api/wizard/route.ts endpoint; adjust it as needed for your project.
 - Keep this kit folder in sync with cli_manifests/forms_manifest.json.
 
+> **Alpha note**
+>
+> In this early alpha, Forms is tested on top of a **Blocks** install that includes sections and templates. For the smoothest experience, install Blocks first:
+>
+> ```bash
+> npx nextworks add blocks --sections --templates
+> npx nextworks add forms
+> ```
+>
+> Using Forms without Blocks may work but can require manual tweaks (for example around shared UI primitives).
+
 Post-install steps (recommended)
 
 1. Install dependencies (the CLI will merge `package-deps.json` into your `package.json`):

package/dist/kits/forms/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jakob Bro Liebe Hansen
+
+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/package.json

@@ -1,11 +1,14 @@
 {
   "name": "nextworks",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.10",
   "description": "Nextworks CLI - Feature kits installer for Next.js apps",
   "main": "dist/index.js",
   "bin": {
     "nextworks": "dist/index.js"
   },
+  "repository": "github:jblh/nextworks-cli",
+"bugs": "https://github.com/jblh/nextworks-cli/issues",
+"homepage": "https://github.com/jblh/nextworks-cli#readme",
   "scripts": {
     "build": "tsc",
     "postbuild": "node ./scripts/copy-assets.js",

package/dist/kits/blocks/components/ui/button_bck.tsx

@@ -1,93 +0,0 @@
-import * as React from "react";
-import { Slot } from "@radix-ui/react-slot";
-import { cva, type VariantProps } from "class-variance-authority";
-
-import { cn } from "@/lib/utils";
-
-const buttonVariants = cva(
-  "focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive inline-flex shrink-0 items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap transition-all outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-  {
-    variants: {
-      variant: {
-        default:
-          "bg-primary text-primary-foreground hover:bg-primary/90 shadow-xs",
-        destructive:
-          "bg-destructive hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60 text-white shadow-xs",
-        outline:
-          "bg-background hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 border shadow-xs",
-        secondary:
-          "bg-secondary text-secondary-foreground hover:bg-secondary/80 shadow-xs",
-        ghost:
-          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-9 px-4 py-2 has-[>svg]:px-3",
-        sm: "h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5",
-        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
-        icon: "size-9",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-      size: "default",
-    },
-  },
-);
-
-function Button({
-  className,
-  variant,
-  size,
-  asChild = false,
-  unstyled = false,
-  ...props
-}: React.ComponentProps<"button"> &
-  VariantProps<typeof buttonVariants> & {
-    asChild?: boolean;
-    /** When true, bypasses tokenized buttonVariants so callers fully control classes */
-    unstyled?: boolean;
-  }) {
-  const Comp = asChild ? Slot : "button";
-
-  return (
-    <Comp
-      data-slot="button"
-      className={
-        unstyled
-          ? cn(
-              "inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap disabled:pointer-events-none disabled:opacity-50",
-              className,
-            )
-          : cn(
-              buttonVariants({ variant, size }),
-              // Color var hooks (ignored when vars are unset; tokens from variants apply)
-              "text-[var(--btn-fg)]",
-              "bg-[var(--btn-bg)]",
-              "hover:bg-[var(--btn-hover-bg)]",
-              "hover:text-[var(--btn-hover-fg)]",
-              // explicit dark variants to compete with dark: utilities from variants like outline
-              "dark:bg-[var(--btn-bg)]",
-              "dark:hover:bg-[var(--btn-hover-bg)]",
-              "dark:hover:text-[var(--btn-hover-fg)]",
-              // Focus ring and border hooks
-              "focus-visible:ring-[var(--btn-ring)]",
-              "border-[var(--btn-border)]",
-              "dark:border-[var(--btn-border)]",
-              className,
-            )
-      }
-      style={{
-        ...(props.style as React.CSSProperties),
-        color: "var(--btn-fg)",
-        backgroundColor: "var(--btn-bg)",
-        borderColor: "var(--btn-border)",
-        // @ts-expect-error custom CSS var for Tailwind ring color
-        "--tw-ring-color": "var(--btn-ring)",
-      }}
-      {...props}
-    />
-  );
-}
-
-export { Button, buttonVariants };

package/dist/kits/blocks/lib/themes_old.ts

@@ -1,37 +0,0 @@
-// TypeScript cli/kits/blocks/lib/themes.ts
-
-export type Theme = {
-  name: string;
-  colors: {
-    primary: string;
-    background: string;
-    surface: string;
-    text: string;
-    muted: string;
-  };
-};
-
-export const themes: Theme[] = [
-  {
-    name: "light",
-    colors: {
-      primary: "#7c3aed",
-      background: "#ffffff",
-      surface: "#f8fafc",
-      text: "#0f172a",
-      muted: "#64748b",
-    },
-  },
-  {
-    name: "dark",
-    colors: {
-      primary: "#8b5cf6",
-      background: "#0b1220",
-      surface: "#071026",
-      text: "#e6eef8",
-      muted: "#93c5fd",
-    },
-  },
-];
-
-export const defaultTheme = themes[0];

package/dist/kits/blocks/notes/THEMING_CONVERSION_SUMMARY.md

@@ -1,14 +0,0 @@
-# Theming Conversion Summary
-
-This document summarizes the changes made when converting the components to the new theming system.
-
-Key changes
-
-- All hardcoded tailwind classes for colors were replaced with semantic theme tokens defined in lib/themes.ts.
-- Components now read theme values via CSS variables injected by the EnhancedThemeProvider.
-- PresetThemeVars components in each template set CSS variables for each preset theme.
-
-Recommended follow-ups
-
-- Review components for any remaining hardcoded colors and replace them with theme tokens.
-- Add more theme presets into lib/themes.ts and update the PresetThemeVars where necessary.