@deftui/addons 0.0.0-stage → 0.0.1

package/dist/form.d.mts

@@ -0,0 +1,8 @@
+import { RHFField } from "./react-hook-form/field.mjs";
+import { RHFForm } from "./react-hook-form/form.mjs";
+export declare const RHF: {
+  /** Form with predefined `className="grid gap-4"` */
+  Form: typeof RHFForm;
+  /** Form field with label, description, error, and `useController` wrapper */
+  Field: typeof RHFField;
+};

package/dist/form.mjs

@@ -0,0 +1,10 @@
+import { RHFField } from "./react-hook-form/field.mjs";
+import { RHFForm } from "./react-hook-form/form.mjs";
+// src/react-hook-form/index.ts
+const RHF = {
+	/** Form with predefined `className="grid gap-4"` */
+	Form: RHFForm,
+	/** Form field with label, description, error, and `useController` wrapper */
+	Field: RHFField
+};
+export { RHF };

package/dist/react-hook-form/field.d.mts

@@ -0,0 +1,14 @@
+import { Field } from "@deftui/react";
+import { FieldPath, FieldValues, UseControllerProps, UseControllerReturn } from "react-hook-form";
+import React from "react";
+type FieldStateKeys = "name" | "disabled" | "invalid" | "dirty" | "touched";
+type FieldValidKeys = "validate" | "validationMode" | "validationDebounceTime";
+type FieldRootProps = Omit<React.ComponentProps<typeof Field>, FieldStateKeys | FieldValidKeys | "children">;
+interface RHFFieldProps<Values extends FieldValues, Name extends FieldPath<Values> = FieldPath<Values>, Output = Values> extends UseControllerProps<Values, Name, Output> {
+  label?: React.ReactNode;
+  description?: React.ReactNode;
+  fieldProps?: FieldRootProps;
+  children: (state: UseControllerReturn<Values, Name>["field"]) => React.ReactNode;
+}
+export declare function RHFField<T extends FieldValues, Name extends FieldPath<T>, Output = T>(props: RHFFieldProps<T, Name, Output>): React.JSX.Element;
+export {};

package/dist/react-hook-form/field.mjs

@@ -0,0 +1,19 @@
+import { Field } from "@deftui/react";
+import { useController } from "react-hook-form";
+import { jsx, jsxs } from "react/jsx-runtime";
+// src/react-hook-form/field.tsx
+function RHFField(props) {
+	const { label, description, fieldProps, children, ...controllerProps } = props;
+	const { field, fieldState } = useController(controllerProps);
+	return /* @__PURE__ */ jsxs(Field, {
+		...fieldProps,
+		"data-invalid": fieldState.invalid,
+		children: [
+			label != null && /* @__PURE__ */ jsx(Field.Label, { children: label }),
+			children(field),
+			description != null && /* @__PURE__ */ jsx(Field.Description, { children: description }),
+			fieldState.invalid && /* @__PURE__ */ jsx(Field.Error, { errors: [fieldState.error] })
+		]
+	});
+}
+export { RHFField };

package/dist/react-hook-form/form.d.mts

@@ -0,0 +1,3 @@
+import { Form } from "@deftui/react";
+import { ComponentProps } from "react";
+export declare function RHFForm(props: ComponentProps<typeof Form>): import("react").JSX.Element;

package/dist/react-hook-form/form.mjs

@@ -0,0 +1,12 @@
+import { Form, cn } from "@deftui/react";
+import { jsx } from "react/jsx-runtime";
+// src/react-hook-form/form.tsx
+function RHFForm(props) {
+	const { children, className, ...formProps } = props;
+	return /* @__PURE__ */ jsx(Form, {
+		...formProps,
+		className: cn("grid gap-4", className),
+		children
+	});
+}
+export { RHFForm };

package/dist/router.d.mts

@@ -0,0 +1,3 @@
+import { NavigationGroup, NavigationItem, NavigationMeta, NavigationOptions } from "./tanstack-router/types.mjs";
+import { collectNavigation } from "./tanstack-router/collect.mjs";
+export { type NavigationGroup, type NavigationItem, type NavigationMeta, type NavigationOptions, collectNavigation };

package/dist/router.mjs

@@ -0,0 +1 @@
+export { collectNavigation } from "./tanstack-router/collect.mjs";

package/dist/tanstack-router/collect.d.mts

@@ -0,0 +1,14 @@
+import { NavigationGroup, NavigationOptions } from "./types.mjs";
+/**
+ * Collects & builds sidebar and command groups from `staticData.navigation`.
+ *
+ * @returns Nonempty groups in configuration order, with items sorted by `order`.
+ *
+ * @example
+ * const groups = collectNavigation({
+ *   router,
+ *   groups: { inspection: "Inspection" },
+ *   resolveLink: () => ({ params: { team } }),
+ * });
+ */
+export declare function collectNavigation({ router, groups, resolveLink }: NavigationOptions): NavigationGroup[];

package/dist/tanstack-router/collect.mjs

@@ -0,0 +1,40 @@
+// src/tanstack-router/collect.ts
+/**
+* Collects & builds sidebar and command groups from `staticData.navigation`.
+*
+* @returns Nonempty groups in configuration order, with items sorted by `order`.
+*
+* @example
+* const groups = collectNavigation({
+*   router,
+*   groups: { inspection: "Inspection" },
+*   resolveLink: () => ({ params: { team } }),
+* });
+*/
+function collectNavigation({ router, groups, resolveLink }) {
+	const navigation = new Map(Object.entries(groups).map(([id, label]) => [id, {
+		id,
+		label,
+		items: []
+	}]));
+	for (const route of Object.values(router.routesById)) {
+		const metadata = route.options.staticData?.navigation;
+		if (!metadata || metadata.visibility?.sidebar === false && metadata.visibility?.command === false) continue;
+		const group = navigation.get(metadata.group);
+		if (!group) continue;
+		const link = resolveLink?.(route);
+		if (link === null) continue;
+		group.items.push({
+			...metadata,
+			id: route.id,
+			link: {
+				...link,
+				to: link?.to ?? route.to,
+				activeOptions: link?.activeOptions ?? metadata.activeOptions
+			}
+		});
+	}
+	for (const group of navigation.values()) group.items.sort((left, right) => (left.order ?? 0) - (right.order ?? 0));
+	return [...navigation.values()].filter((group) => group.items.length > 0);
+}
+export { collectNavigation };

package/dist/tanstack-router/types.d.mts

@@ -0,0 +1,63 @@
+import { ComponentType } from "react";
+import { ActiveOptions, AnyRoute, AnyRouter, LinkOptions, RegisteredRouter } from "@tanstack/react-router";
+export type NavigationLinkOptions = LinkOptions<RegisteredRouter, string, string, string, string>;
+/**
+ * Opt-in route metadata for `collectNavigation`.
+ *
+ * @example
+ * declare module "@tanstack/react-router" {
+ *   interface StaticDataRouteOption extends RouteMeta {}
+ * }
+ */
+export interface NavigationMeta {
+  /** Define in the main route file so collection does not depend on lazy loading. */
+  navigation?: {
+    /** A key in `NavigationOptions.groups`. */
+    group: string;
+    /** Ascending group position; defaults to 0. Ties retain route registration order. */
+    order?: number;
+    label: string;
+    title?: string;
+    icon?: ComponentType<{
+      className?: string;
+    }>;
+    /** Additional search terms. */
+    keywords?: readonly string[];
+    /** Forwarded to Link. Use `{ exact: true }` for entries that should not match child paths. */
+    activeOptions?: ActiveOptions;
+    /** Both menus include the item by default. Set a flag to false to hide it in that menu. */
+    visibility?: {
+      sidebar?: false;
+      command?: false;
+    };
+  };
+}
+/** Shared route metadata with its source identity and resolved link. */
+export interface NavigationItem extends NonNullable<NavigationMeta["navigation"]> {
+  /** Source route ID, including layout and index segments; distinct from the URL. */
+  id: string;
+  /** Pass directly to TanStack Link or `router.navigate`. */
+  link: NavigationLinkOptions;
+}
+/** A configured group containing at least one collected item. */
+export interface NavigationGroup {
+  id: string;
+  label?: string;
+  /** Filter by `visibility.sidebar` or `visibility.command` when rendering; skip groups left empty. */
+  items: NavigationItem[];
+}
+/** Collection scope and optional application-specific link resolution. */
+export interface NavigationOptions {
+  /** Initialized router whose route registry supplies the default destinations. */
+  router: AnyRouter;
+  /** IDs mapped to labels in display order; undefined omits the heading. Unlisted and empty groups are excluded. */
+  groups: Readonly<Record<string, string | undefined>>;
+  /**
+   * Adds params/search or overrides `route.to` and the metadata's `activeOptions`.
+   *
+   * Called once per eligible entry; null excludes it from both menus.
+   *
+   * Without a callback, links use `route.to`. Supply params for dynamic targets.
+   */
+  resolveLink?: (route: AnyRoute) => NavigationLinkOptions | null;
+}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@deftui/addons",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KiriRainCat/deftui.git",
+    "directory": "packages/addons"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./form": {
+      "types": "./dist/form.d.mts",
+      "import": "./dist/form.mjs"
+    },
+    "./router": {
+      "types": "./dist/router.d.mts",
+      "import": "./dist/router.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "check": "vp lint",
+    "fix": "vp check --fix"
+  },
+  "devDependencies": {
+    "@deftui/react": "^0.0.1",
+    "@tanstack/react-router": "^1.170.46",
+    "@types/react": "^19.3.0",
+    "react-hook-form": "^7.91.0",
+    "vite-plus": "catalog:"
+  },
+  "peerDependencies": {
+    "@deftui/react": "^0.0.1",
+    "@tanstack/react-router": "^1",
+    "react": "^19",
+    "react-hook-form": "^7"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-router": {
+      "optional": true
+    },
+    "react-hook-form": {
+      "optional": true
+    }
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.