@easy-editor/setters 0.0.2

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright © 2025-PRESENT JinSo <https://github.com/JinSooo>
+
+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,256 @@
+# @easy-editor/setters
+
+Official setters library for EasyEditor - A collection of property setter components for the visual low-code editor.
+
+## 📦 Included Setters
+
+### Basic Setters
+- **StringSetter** - Text input setter
+- **NumberSetter** - Number input setter with min/max/step support
+- **ColorSetter** - Color picker setter
+- **NodeIdSetter** - Display node ID and component title
+- **RectSetter** - Rectangle position and size setter (X, Y, W, H)
+- **SwitchSetter** - Boolean toggle switch
+- **UploadSetter** - File upload setter with preview
+
+### Group Setters
+- **CollapseSetter** - Collapsible group container
+- **TabSetter** - Tabbed group container
+
+## 🚀 Installation
+
+```bash
+npm install @easy-editor/setters
+# or
+pnpm add @easy-editor/setters
+```
+
+## 📖 Usage
+
+### Import All Setters
+
+```typescript
+import { setterMap } from '@easy-editor/setters'
+
+// Register all setters at once
+Object.entries(setterMap).forEach(([name, setter]) => {
+  editor.setters.register(name, setter)
+})
+```
+
+### Import Individual Setters
+
+```typescript
+import { StringSetter, NumberSetter, ColorSetter } from '@easy-editor/setters'
+
+// Register individually
+editor.setters.register('StringSetter', StringSetter)
+editor.setters.register('NumberSetter', NumberSetter)
+editor.setters.register('ColorSetter', ColorSetter)
+```
+
+### Import Specific Setter
+
+```typescript
+import StringSetter from '@easy-editor/setters/StringSetter'
+
+editor.setters.register('StringSetter', StringSetter)
+```
+
+### Via CDN (UMD)
+
+```html
+<script src="https://unpkg.com/@easy-editor/setters@latest/dist/index.min.js"></script>
+<script>
+  // All setters are available at window.$EasyEditor.setters
+  const { StringSetter, NumberSetter, ColorSetter } = window.$EasyEditor.setters
+  
+  // Or use the setterMap
+  const setterMap = window.$EasyEditor.setters.setterMap
+</script>
+```
+
+## 🎨 Setter Examples
+
+### StringSetter
+
+```typescript
+{
+  name: 'title',
+  title: 'Title',
+  setter: 'StringSetter',
+  extraProps: {
+    placeholder: 'Enter title...',
+    suffix: 'px',
+  },
+}
+```
+
+### NumberSetter
+
+```typescript
+{
+  name: 'fontSize',
+  title: 'Font Size',
+  setter: 'NumberSetter',
+  extraProps: {
+    min: 12,
+    max: 72,
+    step: 2,
+    suffix: 'px',
+  },
+}
+```
+
+### ColorSetter
+
+```typescript
+{
+  name: 'color',
+  title: 'Color',
+  setter: 'ColorSetter',
+  extraProps: {
+    disableAlpha: false,
+  },
+}
+```
+
+### RectSetter
+
+```typescript
+{
+  name: 'rect',
+  title: 'Position & Size',
+  setter: 'RectSetter',
+  extraProps: {
+    getValue(target) {
+      return target.getExtraPropValue('$dashboard.rect')
+    },
+    setValue(target, value) {
+      target.setExtraPropValue('$dashboard.rect', value)
+    },
+  },
+}
+```
+
+### SwitchSetter
+
+```typescript
+{
+  name: 'visible',
+  title: 'Visible',
+  setter: 'SwitchSetter',
+  extraProps: {
+    defaultValue: true,
+  },
+}
+```
+
+### UploadSetter
+
+```typescript
+{
+  name: 'image',
+  title: 'Image',
+  setter: 'UploadSetter',
+  extraProps: {
+    accept: '.jpg,.jpeg,.png,.gif',
+    maxSize: 5 * 1024 * 1024, // 5MB
+  },
+}
+```
+
+### CollapseSetter (Group)
+
+```typescript
+{
+  type: 'group',
+  title: 'Advanced Settings',
+  setter: {
+    componentName: 'CollapseSetter',
+    props: {
+      icon: true,
+    },
+  },
+  items: [
+    // ... nested field configs
+  ],
+}
+```
+
+### TabSetter (Group)
+
+```typescript
+{
+  type: 'group',
+  title: 'Settings',
+  setter: 'TabSetter',
+  items: [
+    {
+      type: 'group',
+      key: 'basic',
+      title: 'Basic',
+      items: [/* ... */],
+    },
+    {
+      type: 'group',
+      key: 'advanced',
+      title: 'Advanced',
+      items: [/* ... */],
+    },
+  ],
+}
+```
+
+## 🔧 TypeScript Support
+
+All setters are fully typed with TypeScript:
+
+```typescript
+import type { StringSetterProps, NumberSetterProps, ColorSetterProps, UploadValue } from '@easy-editor/setters'
+```
+
+## 📦 Package Exports
+
+The package supports multiple import methods:
+
+- **Default**: `import setterMap from '@easy-editor/setters'`
+- **Named**: `import { StringSetter, NumberSetter } from '@easy-editor/setters'`
+- **Specific**: `import StringSetter from '@easy-editor/setters/StringSetter'`
+
+## 🌐 CDN Usage
+
+### unpkg
+
+```html
+<script src="https://unpkg.com/@easy-editor/setters@latest/dist/index.min.js"></script>
+```
+
+### jsdelivr
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@easy-editor/setters@latest/dist/index.min.js"></script>
+```
+
+## 🎯 Features
+
+- ✅ **9 Built-in Setters** - Covers most common property types
+- ✅ **TypeScript Support** - Fully typed with IntelliSense
+- ✅ **Multiple Import Methods** - Use all or individual setters
+- ✅ **CDN Ready** - UMD build for browser usage
+- ✅ **Zero Dependencies** - Only peer dependencies (React, @easy-editor/core)
+- ✅ **Lightweight** - Small bundle size with tree-shaking support
+- ✅ **Customizable** - Pure inline styles, no CSS dependencies
+
+## 📄 License
+
+MIT © JinSo
+
+## 🔗 Related Projects
+
+- [EasyEditor](https://github.com/Easy-Editor/EasyEditor) - Core editor
+- [EasyMaterials](https://github.com/Easy-Editor/EasyMaterials) - Official materials library
+
+## 💬 Support
+
+If you have any questions or suggestions, please submit an [Issue](https://github.com/Easy-Editor/EasySetters/issues).

package/dist/basic/color-setter/index.d.ts

@@ -0,0 +1,6 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface ColorSetterProps extends SetterProps<string> {
+    disableAlpha?: boolean;
+}
+declare const ColorSetter: (props: ColorSetterProps) => import("react").JSX.Element;
+export default ColorSetter;

package/dist/basic/node-id-setter/index.d.ts

@@ -0,0 +1,5 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface NodeIdSetterProps extends SetterProps<string> {
+}
+declare const NodeIdSetter: (props: NodeIdSetterProps) => import("react").JSX.Element;
+export default NodeIdSetter;

package/dist/basic/number-setter/index.d.ts

@@ -0,0 +1,7 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface NumberSetterProps extends SetterProps<number> {
+    placeholder?: string;
+    suffix?: string;
+}
+declare const NumberSetter: (props: NumberSetterProps) => import("react").JSX.Element;
+export default NumberSetter;

package/dist/basic/rect-setter/index.d.ts

@@ -0,0 +1,5 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface RectSetterProps extends SetterProps<DOMRect> {
+}
+declare const RectSetter: (props: RectSetterProps) => import("react").JSX.Element;
+export default RectSetter;

package/dist/basic/string-setter/index.d.ts

@@ -0,0 +1,7 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface StringSetterProps extends SetterProps<string> {
+    placeholder?: string;
+    suffix?: string;
+}
+declare const StringSetter: (props: StringSetterProps) => import("react").JSX.Element;
+export default StringSetter;

package/dist/basic/switch-setter/index.d.ts

@@ -0,0 +1,5 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface SwitchSetterProps extends SetterProps<boolean> {
+}
+declare const SwitchSetter: (props: SwitchSetterProps) => import("react").JSX.Element;
+export default SwitchSetter;

package/dist/basic/upload-setter/index.d.ts

@@ -0,0 +1,17 @@
+import type { SetterProps } from '@easy-editor/core';
+export interface UploadValue {
+    raw: {
+        name: string;
+        size: number;
+        type: string;
+        width: number;
+        height: number;
+    };
+    base64: string;
+}
+export interface UploadSetterProps extends SetterProps<UploadValue | null> {
+    accept?: string;
+    maxSize?: number;
+}
+declare const UploadSetter: (props: UploadSetterProps) => import("react").JSX.Element;
+export default UploadSetter;

package/dist/components/ui/button.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const Button: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string> & {
+    asChild?: boolean;
+}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export { Button, buttonVariants };

package/dist/components/ui/collapsible.d.ts

@@ -0,0 +1,5 @@
+import * as CollapsiblePrimitive from "@radix-ui/react-collapsible";
+declare function Collapsible({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.Root>): import("react").JSX.Element;
+declare function CollapsibleTrigger({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>): import("react").JSX.Element;
+declare function CollapsibleContent({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>): import("react").JSX.Element;
+export { Collapsible, CollapsibleTrigger, CollapsibleContent };

package/dist/components/ui/dropdown-menu.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Root>): React.JSX.Element;
+declare function DropdownMenuPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>): React.JSX.Element;
+declare function DropdownMenuTrigger({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): React.JSX.Element;
+declare function DropdownMenuContent({ className, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>): React.JSX.Element;
+declare function DropdownMenuGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Group>): React.JSX.Element;
+declare function DropdownMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): React.JSX.Element;
+declare function DropdownMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>): React.JSX.Element;
+declare function DropdownMenuRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>): React.JSX.Element;
+declare function DropdownMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>): React.JSX.Element;
+declare function DropdownMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>): React.JSX.Element;
+declare function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+declare function DropdownMenuSub({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>): React.JSX.Element;
+declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>): React.JSX.Element;
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, };

package/dist/components/ui/input.d.ts

@@ -0,0 +1,3 @@
+import * as React from "react";
+declare function Input({ className, type, ...props }: React.ComponentProps<"input">): React.JSX.Element;
+export { Input };

package/dist/components/ui/label.d.ts

@@ -0,0 +1,4 @@
+import * as React from "react";
+import * as LabelPrimitive from "@radix-ui/react-label";
+declare function Label({ className, ...props }: React.ComponentProps<typeof LabelPrimitive.Root>): React.JSX.Element;
+export { Label };

package/dist/components/ui/popover.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+declare function Popover({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Root>): React.JSX.Element;
+declare function PopoverTrigger({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Trigger>): React.JSX.Element;
+declare function PopoverContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof PopoverPrimitive.Content>): React.JSX.Element;
+declare function PopoverAnchor({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Anchor>): React.JSX.Element;
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };

package/dist/components/ui/switch.d.ts

@@ -0,0 +1,4 @@
+import * as React from "react";
+import * as SwitchPrimitive from "@radix-ui/react-switch";
+declare function Switch({ className, ...props }: React.ComponentProps<typeof SwitchPrimitive.Root>): React.JSX.Element;
+export { Switch };

package/dist/components/ui/tabs.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+declare function Tabs({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Root>): React.JSX.Element;
+declare function TabsList({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.List>): React.JSX.Element;
+declare function TabsTrigger({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Trigger>): React.JSX.Element;
+declare function TabsContent({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Content>): React.JSX.Element;
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/dist/custom-field-item.d.ts

@@ -0,0 +1,3 @@
+import type { SettingField } from '@easy-editor/core';
+import type { ReactNode } from 'react';
+export declare const customFieldItem: (field: SettingField, setter: ReactNode) => import("react").JSX.Element;

package/dist/group/collapse-setter/index.d.ts

@@ -0,0 +1,7 @@
+import type { SetterProps } from '@easy-editor/core';
+import type { PropsWithChildren } from 'react';
+export interface CollapseSetterProps extends SetterProps<boolean>, PropsWithChildren {
+    icon?: boolean;
+}
+declare const CollapseSetter: (props: CollapseSetterProps) => import("react").JSX.Element;
+export default CollapseSetter;

package/dist/group/tab-setter/index.d.ts

@@ -0,0 +1,11 @@
+import type { SetterProps } from '@easy-editor/core';
+import type { PropsWithChildren } from 'react';
+import React from 'react';
+export interface TabSetterProps extends SetterProps<string>, PropsWithChildren {
+    tabs?: {
+        label: string;
+        value: string;
+    }[];
+}
+declare const TabSetter: (props: TabSetterProps) => React.JSX.Element;
+export default TabSetter;