@yarcl/react 0.1.0 → 0.2.0

package/dist/field-context.d.ts

@@ -0,0 +1,16 @@
+export interface FieldContextValue {
+    id: string;
+    labelId: string;
+    describedBy: string | undefined;
+    invalid: boolean;
+    required: boolean | undefined;
+}
+export declare const FieldContext: import("react").Context<FieldContextValue | null>;
+interface FieldControlProps {
+    id?: string;
+    required?: boolean;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean | 'true' | 'false' | 'grammar' | 'spelling';
+}
+export declare function useFieldProps<T extends FieldControlProps>(props: T): T;
+export {};

package/dist/field-context.js

@@ -0,0 +1,17 @@
+import { cx } from "./classes.js";
+import { createContext, useContext } from "react";
+//#region src/field-context.ts
+var FieldContext = createContext(null);
+function useFieldProps(props) {
+	const field = useContext(FieldContext);
+	if (!field) return props;
+	return {
+		...props,
+		id: props.id ?? field.id,
+		required: props.required ?? field.required,
+		"aria-describedby": cx(field.describedBy, props["aria-describedby"]) || void 0,
+		"aria-invalid": props["aria-invalid"] ?? (field.invalid || void 0)
+	};
+}
+//#endregion
+export { FieldContext, useFieldProps };

package/dist/floating.d.ts

@@ -0,0 +1,12 @@
+import { type Middleware } from '@floating-ui/react';
+import { type ReactElement, type RefObject } from 'react';
+interface MiddlewareOptions {
+    gap?: number;
+    matchWidth?: boolean;
+    arrowRef?: RefObject<SVGSVGElement | null>;
+}
+export declare function floatingMiddleware({ gap, matchWidth, arrowRef }?: MiddlewareOptions): Middleware[];
+export declare function useTrigger(child: ReactElement, setReference: (node: Element | null) => void, getReferenceProps: (props?: Record<string, unknown>) => Record<string, unknown>): ReactElement;
+export declare function ChevronIcon(): import("react").JSX.Element;
+export declare function CheckIcon(): import("react").JSX.Element;
+export {};

package/dist/floating.js

@@ -0,0 +1,52 @@
+import { cloneElement, isValidElement } from "react";
+import { jsx } from "react/jsx-runtime";
+import { arrow, flip, offset, shift, size, useMergeRefs } from "@floating-ui/react";
+//#region src/floating.tsx
+function floatingMiddleware({ gap = 6, matchWidth = false, arrowRef } = {}) {
+	return [
+		offset(gap),
+		flip({ padding: 8 }),
+		shift({ padding: 8 }),
+		size({
+			padding: 8,
+			apply({ rects, availableHeight, elements }) {
+				elements.floating.style.maxHeight = `${Math.max(availableHeight, 120)}px`;
+				if (matchWidth) elements.floating.style.minWidth = `${rects.reference.width}px`;
+			}
+		}),
+		...arrowRef ? [arrow({ element: arrowRef })] : []
+	];
+}
+function useTrigger(child, setReference, getReferenceProps) {
+	if (!isValidElement(child)) throw new Error("yarcl: trigger must be a single React element");
+	const element = child;
+	const ref = useMergeRefs([setReference, element.props.ref]);
+	return cloneElement(element, getReferenceProps({
+		...element.props,
+		ref
+	}));
+}
+function ChevronIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("path", { d: "m6 9 6 6 6-6" })
+	});
+}
+function CheckIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2.5",
+		strokeLinecap: "round",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("path", { d: "m5 12 5 5 9-10" })
+	});
+}
+//#endregion
+export { CheckIcon, ChevronIcon, floatingMiddleware, useTrigger };

package/dist/hooks.d.ts

@@ -0,0 +1 @@
+export declare function useControllable<T>(value: T | undefined, defaultValue: T, onChange?: (value: T) => void): [T, (next: T) => void];

package/dist/hooks.js

@@ -0,0 +1,12 @@
+import { useCallback, useState } from "react";
+//#region src/hooks.ts
+function useControllable(value, defaultValue, onChange) {
+	const [internal, setInternal] = useState(defaultValue);
+	const controlled = value !== void 0;
+	return [controlled ? value : internal, useCallback((next) => {
+		if (!controlled) setInternal(next);
+		onChange?.(next);
+	}, [controlled, onChange])];
+}
+//#endregion
+export { useControllable };

package/{src/index.ts → dist/index.d.ts}

@@ -1,6 +1,5 @@
-import 'virtual:yarcl.css';
+import '@yarcl/react/styles.css';
 import './styles.css';
-
 export { Button } from './components/Button';
 export type { ButtonProps } from './components/Button';
 export { ButtonGroup } from './components/ButtonGroup';
@@ -24,7 +23,7 @@ export type { RadioGroupProps } from './components/RadioGroup';
 export { Switch } from './components/Switch';
 export type { SwitchProps } from './components/Switch';
 export { Slider } from './components/Slider';
-export type { SliderProps, SliderValue } from './components/Slider';
+export type { SliderProps, SliderRangeProps, SliderValue } from './components/Slider';
 export { Field } from './components/Field';
 export type { FieldProps } from './components/Field';
 export { Label } from './components/Label';
@@ -45,6 +44,8 @@ export { Card } from './components/Card';
 export type { CardProps } from './components/Card';
 export { Divider } from './components/Divider';
 export type { DividerProps } from './components/Divider';
+export { VisuallyHidden } from './components/VisuallyHidden';
+export type { VisuallyHiddenProps } from './components/VisuallyHidden';
 export { Popover } from './components/Popover';
 export type { PopoverProps, PopoverTriggerProps, PopoverContentProps } from './components/Popover';
 export { Tooltip } from './components/Tooltip';
@@ -58,14 +59,7 @@ export type { SelectProps, SelectOption } from './components/Select';
 export { Combobox } from './components/Combobox';
 export type { ComboboxBaseProps, ComboboxProps } from './components/Combobox';
 export { DatePicker } from './components/DatePicker';
-export type {
-  DatePickerProps,
-  DatePickerBaseProps,
-  DatePickerSingleProps,
-  DatePickerRangeProps,
-  DatePickerLabels,
-  DateRange,
-} from './components/DatePicker';
+export type { DatePickerProps, DatePickerBaseProps, DatePickerSingleProps, DatePickerRangeProps, DatePickerLabels, DateRange, } from './components/DatePicker';
 export { Dialog } from './components/Dialog';
 export type { DialogProps } from './components/Dialog';
 export { Drawer } from './components/Drawer';
@@ -76,13 +70,7 @@ export type { CommandPaletteProps, CommandPaletteCommand } from './components/Co
 export { Toaster, toast } from './components/Toast';
 export type { ToasterProps, ToastOptions } from './components/Toast';
 export { Accordion } from './components/Accordion';
-export type {
-  AccordionProps,
-  AccordionBaseProps,
-  AccordionItemProps,
-  AccordionTriggerProps,
-  AccordionContentProps,
-} from './components/Accordion';
+export type { AccordionProps, AccordionBaseProps, AccordionItemProps, AccordionTriggerProps, AccordionContentProps, } from './components/Accordion';
 export { Tabs } from './components/Tabs';
 export type { TabsProps, TabsBaseProps, TabsListProps, TabsTriggerProps, TabsPanelProps } from './components/Tabs';
 export { Pagination } from './components/Pagination';
@@ -91,6 +79,8 @@ export { Table } from './components/Table';
 export type { TableProps, TableHeaderCellProps, TableCellProps, CellAlign } from './components/Table';
 export { Badge } from './components/Badge';
 export type { BadgeProps } from './components/Badge';
+export { Avatar, AvatarGroup } from './components/Avatar';
+export type { AvatarProps, AvatarGroupProps } from './components/Avatar';
 export { Alert } from './components/Alert';
 export type { AlertProps } from './components/Alert';
 export { Spinner } from './components/Spinner';
@@ -99,21 +89,9 @@ export { Skeleton } from './components/Skeleton';
 export type { SkeletonProps } from './components/Skeleton';
 export { Progress } from './components/Progress';
 export type { ProgressProps } from './components/Progress';
-export type {
-  Size,
-  Radius,
-  Color,
-  Variant,
-  Spacing,
-  Shadow,
-  TextStyle,
-  Density,
-  ModalSize,
-  Align,
-  Justify,
-  TokenProps,
-  VariantProps,
-} from './types';
+export { EmptyState } from './components/EmptyState';
+export type { EmptyStateProps } from './components/EmptyState';
+export type { Size, ComponentSize, Radius, Color, Variant, Spacing, Shadow, TextStyle, Density, ModalSize, Align, Justify, TokenProps, VariantProps, } from './types';
 /** The build-time design system config: the consumer's, or the library default. */
 export { default as config } from '@yarcl/config';
 export { useConfig } from './runtime';

package/dist/index.js

@@ -0,0 +1,50 @@
+import { useConfig } from "./runtime.js";
+import { ButtonGroup } from "./components/ButtonGroup.js";
+import { Spinner } from "./components/Spinner.js";
+import { Button } from "./components/Button.js";
+import { ToggleGroup } from "./components/ToggleGroup.js";
+import { IconButton } from "./components/IconButton.js";
+import { Input } from "./components/Input.js";
+import { Textarea } from "./components/Textarea.js";
+import { NumberInput } from "./components/NumberInput.js";
+import { Checkbox } from "./components/Checkbox.js";
+import { RadioGroup } from "./components/RadioGroup.js";
+import { Radio } from "./components/Radio.js";
+import { Switch } from "./components/Switch.js";
+import { Slider } from "./components/Slider.js";
+import { Label } from "./components/Label.js";
+import { Field } from "./components/Field.js";
+import { Text } from "./components/Text.js";
+import { Heading } from "./components/Heading.js";
+import { Link } from "./components/Link.js";
+import { Breadcrumb } from "./components/Breadcrumb.js";
+import { Stack } from "./components/Stack.js";
+import { Inline } from "./components/Inline.js";
+import { Card } from "./components/Card.js";
+import { Divider } from "./components/Divider.js";
+import { VisuallyHidden } from "./components/VisuallyHidden.js";
+import { Popover } from "./components/Popover.js";
+import { Tooltip } from "./components/Tooltip.js";
+import { HoverCard } from "./components/HoverCard.js";
+import { Menu } from "./components/Menu.js";
+import { Select } from "./components/Select.js";
+import { Badge } from "./components/Badge.js";
+import { Combobox } from "./components/Combobox.js";
+import { DatePicker } from "./components/DatePicker.js";
+import { Dialog } from "./components/Dialog.js";
+import { Drawer } from "./components/Drawer.js";
+import { CommandPalette } from "./components/CommandPalette.js";
+import { Toaster, toast } from "./components/Toast.js";
+import { Accordion } from "./components/Accordion.js";
+import { Tabs } from "./components/Tabs.js";
+import { Pagination } from "./components/Pagination.js";
+import { Table } from "./components/Table.js";
+import { Avatar, AvatarGroup } from "./components/Avatar.js";
+import { Alert } from "./components/Alert.js";
+import { Skeleton } from "./components/Skeleton.js";
+import { Progress } from "./components/Progress.js";
+import { EmptyState } from "./components/EmptyState.js";
+import "@yarcl/react/styles.css";
+import "./styles.css";
+import config from "@yarcl/config";
+export { Accordion, Alert, Avatar, AvatarGroup, Badge, Breadcrumb, Button, ButtonGroup, Card, Checkbox, Combobox, CommandPalette, DatePicker, Dialog, Divider, Drawer, EmptyState, Field, Heading, HoverCard, IconButton, Inline, Input, Label, Link, Menu, NumberInput, Pagination, Popover, Progress, Radio, RadioGroup, Select, Skeleton, Slider, Spinner, Stack, Switch, Table, Tabs, Text, Textarea, Toaster, ToggleGroup, Tooltip, VisuallyHidden, config, toast, useConfig };

package/dist/init.d.ts

@@ -0,0 +1,18 @@
+interface InitOptions {
+    root: string;
+    configPath?: string;
+    configProvided?: boolean;
+    buildTool?: BuildTool;
+    install?: boolean;
+    version: string;
+}
+export interface InitResult {
+    configPath: string;
+    tsconfig: string;
+    buildConfig: string;
+    buildTool: BuildTool;
+    dependencyAdded: boolean;
+}
+export type BuildTool = 'vite' | 'webpack' | 'rspack' | 'rollup' | 'esbuild';
+export declare function initProject(options: InitOptions): Promise<InitResult>;
+export {};

package/dist/init.js

@@ -0,0 +1,224 @@
+import { CONFIG_MODULE, DEFAULT_CONFIG_PATH, configMappings, findTsconfig } from "./setup.js";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { applyEdits, modify } from "jsonc-parser";
+import { env } from "node:process";
+import { spawnSync } from "node:child_process";
+import { platform } from "node:os";
+//#region src/init.ts
+var buildConfigNames = {
+	vite: [
+		"vite.config.ts",
+		"vite.config.mts",
+		"vite.config.js",
+		"vite.config.mjs"
+	],
+	webpack: [
+		"webpack.config.ts",
+		"webpack.config.mts",
+		"webpack.config.js",
+		"webpack.config.mjs",
+		"webpack.config.cjs",
+		"webpack.config.cts"
+	],
+	rspack: [
+		"rspack.config.ts",
+		"rspack.config.mts",
+		"rspack.config.js",
+		"rspack.config.mjs",
+		"rspack.config.cjs",
+		"rspack.config.cts"
+	],
+	rollup: [
+		"rollup.config.ts",
+		"rollup.config.mts",
+		"rollup.config.js",
+		"rollup.config.mjs",
+		"rollup.config.cjs",
+		"rollup.config.cts"
+	],
+	esbuild: [
+		"esbuild.config.ts",
+		"esbuild.config.mts",
+		"esbuild.config.js",
+		"esbuild.config.mjs",
+		"esbuild.config.cjs",
+		"esbuild.config.cts"
+	]
+};
+function findBuildConfig(root, requested) {
+	const tools = requested ? [requested] : Object.keys(buildConfigNames);
+	for (const tool of tools) {
+		const file = buildConfigNames[tool].map((name) => resolve(root, name)).find((candidate) => existsSync(candidate));
+		if (file) return {
+			tool,
+			file
+		};
+	}
+}
+function closingToken(source, start, open, close) {
+	let depth = 0;
+	let quote = "";
+	let escaped = false;
+	let lineComment = false;
+	let blockComment = false;
+	for (let index = start; index < source.length; index += 1) {
+		const character = source[index];
+		const next = source[index + 1];
+		if (lineComment) {
+			if (character === "\n") lineComment = false;
+			continue;
+		}
+		if (blockComment) {
+			if (character === "*" && next === "/") {
+				blockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (quote) {
+			if (escaped) escaped = false;
+			else if (character === "\\") escaped = true;
+			else if (character === quote) quote = "";
+			continue;
+		}
+		if (character === "/" && next === "/") {
+			lineComment = true;
+			index += 1;
+			continue;
+		}
+		if (character === "/" && next === "*") {
+			blockComment = true;
+			index += 1;
+			continue;
+		}
+		if (character === "'" || character === "\"" || character === "`") {
+			quote = character;
+			continue;
+		}
+		if (character === open) depth += 1;
+		if (character === close) {
+			depth -= 1;
+			if (depth === 0) return index;
+		}
+	}
+	return -1;
+}
+function existingPluginPath(source) {
+	const call = /\byarcl\s*\(/g.exec(source);
+	if (!call) return void 0;
+	const open = source.indexOf("(", call.index);
+	const close = closingToken(source, open, "(", ")");
+	if (close < 0) throw new Error("yarcl: Could not parse the yarcl plugin call in the build config.");
+	const options = source.slice(open + 1, close).trim();
+	if (!options) return DEFAULT_CONFIG_PATH;
+	const match = /\bconfig\s*:\s*(['"`])([^'"`]+)\1/.exec(options);
+	if (match) return match[2];
+	if (options.startsWith("{")) return /\bconfig\s*:/.test(options) ? null : DEFAULT_CONFIG_PATH;
+	return null;
+}
+function pluginImport(source, tool, file) {
+	const entry = `@yarcl/react/${tool}`;
+	const oldImport = /import\s*\{\s*yarcl\s*\}\s*from\s*['"]@yarcl\/react\/plugin['"]\s*;?/;
+	if (oldImport.test(source)) return source.replace(oldImport, `import yarcl from '${entry}';`);
+	if (source.includes(entry)) return source;
+	return /\.(?:cjs|cts)$/.test(file) || /\bmodule\.exports\b|\brequire\s*\(/.test(source) && !/\bimport\s/.test(source) ? `const yarcl = require('${entry}');\n${source}` : `import yarcl from '${entry}';\n${source}`;
+}
+function addPlugin(source, configPath, config) {
+	if (existingPluginPath(source) !== void 0) return pluginImport(source, config.tool, config.file);
+	const match = /\bplugins\s*:\s*\[/g.exec(source);
+	if (!match) throw new Error(`yarcl: Could not find a plugins array in the ${config.tool} config. Add one and run "yarcl init" again.`);
+	const open = source.indexOf("[", match.index);
+	const close = closingToken(source, open, "[", "]");
+	if (close < 0) throw new Error(`yarcl: Could not parse the plugins array in the ${config.tool} config.`);
+	const body = source.slice(open + 1, close);
+	const plugin = `yarcl({ config: '${configPath.replaceAll("'", "\\'")}' })`;
+	let updatedBody;
+	if (!body.includes("\n")) updatedBody = body.trim() ? `${body.trimEnd()}, ${plugin}` : plugin;
+	else {
+		const trailing = /\s*$/.exec(body)?.[0] ?? "";
+		const content = body.slice(0, body.length - trailing.length).trimEnd();
+		const closeIndent = /(?:^|\n)([ \t]*)[^\n]*$/.exec(source.slice(0, close))?.[1] ?? "";
+		const itemIndent = /\n([ \t]+)\S/.exec(body)?.[1] ?? `${closeIndent}  `;
+		updatedBody = `${content}${content.endsWith(",") ? "" : ","}\n${itemIndent}${plugin},${trailing}`;
+	}
+	return pluginImport(source.slice(0, open + 1) + updatedBody + source.slice(close), config.tool, config.file);
+}
+function detectPackageManager(root) {
+	if (existsSync(resolve(root, "pnpm-lock.yaml"))) return "pnpm";
+	if (existsSync(resolve(root, "yarn.lock"))) return "yarn";
+	if (existsSync(resolve(root, "bun.lock")) || existsSync(resolve(root, "bun.lockb"))) return "bun";
+	const caller = env.npm_config_user_agent?.split("/")[0];
+	if (caller === "pnpm" || caller === "yarn" || caller === "bun") return caller;
+	return "npm";
+}
+function install(root) {
+	const manager = detectPackageManager(root);
+	const executable = platform() === "win32" ? `${manager}.cmd` : manager;
+	const result = spawnSync(executable, manager === "pnpm" ? ["install", "--no-frozen-lockfile"] : ["install"], {
+		cwd: root,
+		stdio: "inherit"
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw new Error(`yarcl: ${manager} install failed with status ${result.status ?? "unknown"}.`);
+}
+function normalizedConfigPath(root, configPath) {
+	const projectRelative = relative(root, resolve(root, configPath));
+	if (isAbsolute(configPath) || projectRelative === ".." || projectRelative.startsWith(`..${sep}`)) throw new Error("yarcl: The config path must be inside the project.");
+	return configPath.replaceAll("\\", "/").replace(/^\.\//, "");
+}
+async function initProject(options) {
+	const root = resolve(options.root);
+	const manifestPath = resolve(root, "package.json");
+	const buildConfig = findBuildConfig(root, options.buildTool);
+	const tsconfig = findTsconfig(root);
+	if (!existsSync(manifestPath)) throw new Error(`yarcl: No package.json found in ${root}.`);
+	if (!buildConfig) {
+		const requested = options.buildTool ? `${options.buildTool} config` : "Vite, webpack, Rspack, Rollup or esbuild config";
+		throw new Error(`yarcl: No ${requested} found in ${root}.`);
+	}
+	if (!tsconfig) throw new Error(`yarcl: No tsconfig.app.json or tsconfig.json found in ${root}.`);
+	const requested = normalizedConfigPath(root, options.configPath ?? "src/yarcl.config.ts");
+	const buildSource = await readFile(buildConfig.file, "utf8");
+	const existing = existingPluginPath(buildSource);
+	if (existing === null) throw new Error("yarcl: The existing yarcl plugin uses a dynamic config path that cannot be updated.");
+	if (options.configProvided && existing && resolve(root, existing) !== resolve(root, requested)) throw new Error(`yarcl: The ${buildConfig.tool} plugin already uses "${existing}", not "${requested}".`);
+	const configPath = normalizedConfigPath(root, existing ?? requested);
+	const updatedBuildConfig = addPlugin(buildSource, configPath, buildConfig);
+	const tsconfigSource = await readFile(tsconfig, "utf8");
+	const eol = tsconfigSource.includes("\r\n") ? "\r\n" : "\n";
+	const edits = modify(tsconfigSource, [
+		"compilerOptions",
+		"paths",
+		CONFIG_MODULE
+	], configMappings(root, tsconfig, configPath), { formattingOptions: {
+		insertSpaces: true,
+		tabSize: 2,
+		eol
+	} });
+	const updatedTsconfig = applyEdits(tsconfigSource, edits);
+	const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+	const dependencyAdded = !manifest.dependencies?.["@yarcl/react"] && !manifest.devDependencies?.["@yarcl/react"];
+	if (dependencyAdded) manifest.dependencies = {
+		...manifest.dependencies,
+		"@yarcl/react": `^${options.version}`
+	};
+	const targetConfig = resolve(root, configPath);
+	await Promise.all([
+		writeFile(buildConfig.file, updatedBuildConfig),
+		writeFile(tsconfig, updatedTsconfig),
+		writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`),
+		existsSync(targetConfig) ? Promise.resolve() : mkdir(dirname(targetConfig), { recursive: true }).then(() => writeFile(targetConfig, "import { defineConfig } from '@yarcl/react/define';\nimport defaults from '@yarcl/react/defaults';\n\nexport default defineConfig({\n  ...defaults,\n});\n"))
+	]);
+	if (dependencyAdded && options.install !== false) install(root);
+	return {
+		configPath,
+		tsconfig,
+		buildConfig: buildConfig.file,
+		buildTool: buildConfig.tool,
+		dependencyAdded
+	};
+}
+//#endregion
+export { initProject };

package/dist/plugin.d.ts

@@ -1,33 +1,17 @@
-import { type Plugin } from 'vite';
-/** Options for the yarcl Vite plugin. */
+/** Options shared by every yarcl build-tool plugin. */
 export interface YarclPluginOptions {
     /**
-     * Path to the consumer's config file, relative to the Vite root.
+     * Path to the consumer's config file, relative to the project root.
      * If the file does not exist, the library's default config is used.
      * @default 'src/yarcl.config.ts'
      */
     config?: string;
+    /**
+     * Project root used to resolve the config and TypeScript mapping.
+     * Build-tool adapters normally detect it automatically.
+     * @default process.cwd()
+     */
+    root?: string;
 }
-/**
- * Vite plugin that connects the library to the consumer's config.
- *
- * - Aliases `@yarcl/config` to the consumer's config file (or the library default).
- * - Generates `virtual:yarcl.css` from the config at build time: CSS variables on `:root`
- *   and one `yarcl-{group}-{key}` class per key. No inline styles, no runtime cost.
- * - Warns when a color's foreground fails WCAG AA contrast.
- * - Regenerates the CSS when the config file changes.
- *
- * Must be paired with a matching `paths` entry for `@yarcl/config` in the
- * consumer's `tsconfig.json`, so the types resolve to the same file.
- *
- * @example
- * ```ts
- * // vite.config.ts
- * import { yarcl } from '@yarcl/react/plugin';
- *
- * export default defineConfig({
- *   plugins: [react(), yarcl({ config: 'src/yarcl.config.ts' })],
- * });
- * ```
- */
-export declare function yarcl({ config }?: YarclPluginOptions): Plugin;
+/** Shared yarcl plugin implementation used by every build-tool adapter. */
+export declare const yarclPlugin: import("unplugin").UnpluginInstance<YarclPluginOptions | undefined, boolean>;