@ainsleydev/sveltekit-helper 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, ainsley.dev
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,248 @@
+# @ainsleydev/sveltekit-helper
+
+SvelteKit utilities, components and helpers for ainsley.dev builds.
+
+## Installation
+
+```bash
+pnpm add @ainsleydev/sveltekit-helper
+```
+
+## Features
+
+- **Grid System**: Responsive Container, Row, and Column components with CSS variables
+- **Form Utilities**: Schema generation and error helpers for Zod validation
+- **Payload CMS Integration**: Ready-to-use components for Payload CMS forms and media
+- **SCSS with BEM**: All components use SCSS with BEM naming convention
+
+## Grid Components
+
+### Container
+
+Center content horizontally with predefined max-width and support for breakout layouts.
+
+```svelte
+<script>
+	import { Container, Row, Column } from '@ainsleydev/sveltekit-helper/components/Grid'
+</script>
+
+<Container>
+	<Row>
+		<Column class="col-12 col-desk-6">
+			Content
+		</Column>
+	</Row>
+</Container>
+```
+
+#### Customisation
+
+Override CSS variables to customise the container:
+
+```css
+.container {
+	--container-padding: 2rem;
+	--container-max-width: 1400px;
+	--container-breakout-max-width: 1600px;
+}
+```
+
+### Row
+
+Flexbox row container with gap management.
+
+```svelte
+<Row>
+	<Column class="col-12 col-tab-6">
+		Column 1
+	</Column>
+	<Column class="col-12 col-tab-6">
+		Column 2
+	</Column>
+</Row>
+
+<!-- No gaps -->
+<Row noGaps>
+	<Column class="col-6">Content</Column>
+</Row>
+```
+
+#### Customisation
+
+```css
+.row {
+	--row-gap: 1.5rem;
+}
+```
+
+### Column
+
+Base column component with customisable gap. Consumers should define their own grid classes in global styles.
+
+```svelte
+<Column class="col-12 col-tab-6 col-desk-4">
+	Content
+</Column>
+```
+
+#### Customisation
+
+```css
+.col {
+	--col-gap: 1.5rem;
+}
+
+/* Define your own grid classes */
+.col-12 { width: 100%; }
+.col-6 { width: 50%; }
+
+@media (min-width: 768px) {
+	.col-tab-6 { width: 50%; }
+}
+```
+
+## Form Utilities
+
+### generateFormSchema
+
+Generates a Zod schema from Payload CMS form fields.
+
+```typescript
+import { generateFormSchema } from '@ainsleydev/sveltekit-helper/utils/forms'
+
+const fields = [
+	{ blockType: 'text', name: 'name', label: 'Name', required: true },
+	{ blockType: 'email', name: 'email', label: 'Email', required: true },
+	{ blockType: 'textarea', name: 'message', label: 'Message', required: false }
+]
+
+const schema = generateFormSchema(fields)
+// Returns Zod schema with appropriate validation
+```
+
+### flattenZodErrors
+
+Converts Zod validation errors into a simple key-value object.
+
+```typescript
+import { flattenZodErrors } from '@ainsleydev/sveltekit-helper/utils/forms'
+import { z } from 'zod'
+
+const schema = z.object({ email: z.string().email() })
+const result = schema.safeParse({ email: 'invalid' })
+
+if (!result.success) {
+	const errors = flattenZodErrors(result.error)
+	// { email: 'Invalid email' }
+}
+```
+
+## Payload CMS Components
+
+### PayloadForm
+
+Renders a form dynamically from Payload CMS form builder fields.
+
+```svelte
+<script>
+	import { PayloadForm } from '@ainsleydev/sveltekit-helper/components/payload'
+
+	export let data
+</script>
+
+<PayloadForm
+	form={data.form}
+	apiEndpoint="/api/forms"
+/>
+```
+
+#### Custom Submission
+
+```svelte
+<PayloadForm
+	form={data.form}
+	onSubmit={async (formData) => {
+		// Custom submission logic
+		await customAPI.submit(formData)
+	}}
+/>
+```
+
+#### Customisation
+
+Style the form using CSS variables:
+
+```css
+.payload-form {
+	--form-gap: 1.5rem;
+	--form-input-padding: 1rem;
+	--form-input-border: 1px solid #e5e7eb;
+	--form-input-border-radius: 0.5rem;
+	--form-input-bg: #ffffff;
+	--form-input-text: #111827;
+	--form-error-color: #ef4444;
+	--form-success-color: #10b981;
+	--form-button-bg: #3b82f6;
+	--form-button-text: #ffffff;
+	--form-button-hover-bg: #2563eb;
+	--form-button-disabled-bg: #9ca3af;
+}
+```
+
+### PayloadMedia
+
+Renders responsive images and videos from Payload CMS media fields with automatic format prioritisation (AVIF → WebP → JPEG/PNG).
+
+```svelte
+<script>
+	import { PayloadMedia } from '@ainsleydev/sveltekit-helper/components/payload'
+
+	export let data
+</script>
+
+<PayloadMedia
+	data={data.image}
+	loading="lazy"
+	maxWidth={1200}
+/>
+```
+
+#### Props
+
+- `data`: Payload media object with `url`, `sizes`, `mimeType`, etc.
+- `loading`: Optional `'lazy'` or `'eager'` loading strategy
+- `maxWidth`: Optional maximum width to limit responsive sources
+- `breakpointBuffer`: Pixels to add to breakpoint media queries (default: 50)
+- `className`: Optional CSS class name
+- `onload`: Optional load event handler
+
+## Peer Dependencies
+
+- `svelte@^5.0.0`
+- `@sveltejs/kit@^2.0.0`
+
+### Optional Dependencies
+
+- `payload@^3.0.0` - For Payload CMS components
+- `zod@^3.0.0` - For form validation
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the package
+pnpm build
+
+# Run tests
+pnpm test
+
+# Lint and format
+pnpm lint
+pnpm format
+```
+
+## License
+
+MIT

package/dist/components/Grid/index.d.ts

@@ -0,0 +1,4 @@
+export { default as Container } from './Container.svelte';
+export { default as Row } from './Row.svelte';
+export { default as Column } from './Column.svelte';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Grid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/components/Grid/index.js

@@ -0,0 +1,5 @@
+export { default as Container } from './Container.svelte';
+export { default as Row } from './Row.svelte';
+export { default as Column } from './Column.svelte';
+
+//# sourceMappingURL=index.js.map

package/dist/components/Grid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/Grid/index.ts"],"sourcesContent":["export { default as Container } from './Container.svelte';\nexport { default as Row } from './Row.svelte';\nexport { default as Column } from './Column.svelte';\n"],"names":["default","Container","Row","Column"],"mappings":"AAAA,SAASA,WAAWC,SAAS,QAAQ,qBAAqB;AAC1D,SAASD,WAAWE,GAAG,QAAQ,eAAe;AAC9C,SAASF,WAAWG,MAAM,QAAQ,kBAAkB"}

package/dist/components/payload/index.d.ts

@@ -0,0 +1,4 @@
+export { default as PayloadForm } from './PayloadForm.svelte';
+export { default as PayloadMedia } from './PayloadMedia.svelte';
+export type { Media, MediaSizes, PayloadMediaProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/payload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/payload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/payload/index.js

@@ -0,0 +1,4 @@
+export { default as PayloadForm } from './PayloadForm.svelte';
+export { default as PayloadMedia } from './PayloadMedia.svelte';
+
+//# sourceMappingURL=index.js.map

package/dist/components/payload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/payload/index.ts"],"sourcesContent":["export { default as PayloadForm } from './PayloadForm.svelte';\nexport { default as PayloadMedia } from './PayloadMedia.svelte';\nexport type { Media, MediaSizes, PayloadMediaProps } from './types.js';\n"],"names":["default","PayloadForm","PayloadMedia"],"mappings":"AAAA,SAASA,WAAWC,WAAW,QAAQ,uBAAuB;AAC9D,SAASD,WAAWE,YAAY,QAAQ,wBAAwB"}

package/dist/components/payload/types.d.ts

@@ -0,0 +1,33 @@
+import type { HTMLAttributes } from 'svelte/elements';
+export type MediaSizes = Record<string, Partial<{
+    url?: string | null;
+    width?: number | null;
+    height?: number | null;
+    mimeType?: string | null;
+}> | undefined>;
+export type PayloadMediaProps = HTMLAttributes<HTMLElement> & {
+    data: Media;
+    loading?: 'lazy' | 'eager' | undefined;
+    className?: string;
+    breakpointBuffer?: number;
+    maxWidth?: number | undefined;
+    onload?: (event: Event) => void;
+};
+export type Media = {
+    id: number;
+    alt?: string;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+    url?: string | null;
+    thumbnailURL?: string | null;
+    filename?: string | null;
+    mimeType?: string | null;
+    filesize?: number | null;
+    width?: number | null;
+    height?: number | null;
+    focalX?: number | null;
+    focalY?: number | null;
+    sizes?: MediaSizes;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/components/payload/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/payload/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,MAAM,CAC9B,MAAM,EACJ,OAAO,CAAC;IACR,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC,GACF,SAAS,CACX,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IAC7D,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC"}

package/dist/components/payload/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/components/payload/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/payload/types.ts"],"sourcesContent":["import type { HTMLAttributes } from 'svelte/elements';\n\nexport type MediaSizes = Record<\n\tstring,\n\t| Partial<{\n\t\t\turl?: string | null;\n\t\t\twidth?: number | null;\n\t\t\theight?: number | null;\n\t\t\tmimeType?: string | null;\n\t  }>\n\t| undefined\n>;\n\nexport type PayloadMediaProps = HTMLAttributes<HTMLElement> & {\n\tdata: Media;\n\tloading?: 'lazy' | 'eager' | undefined;\n\tclassName?: string;\n\tbreakpointBuffer?: number;\n\tmaxWidth?: number | undefined;\n\tonload?: (event: Event) => void;\n};\n\nexport type Media = {\n\tid: number;\n\talt?: string;\n\tupdatedAt: string;\n\tcreatedAt: string;\n\tdeletedAt?: string | null;\n\turl?: string | null;\n\tthumbnailURL?: string | null;\n\tfilename?: string | null;\n\tmimeType?: string | null;\n\tfilesize?: number | null;\n\twidth?: number | null;\n\theight?: number | null;\n\tfocalX?: number | null;\n\tfocalY?: number | null;\n\tsizes?: MediaSizes;\n};\n"],"names":[],"mappings":"AAsBA,WAgBE"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @ainsleydev/sveltekit-helper
+ *
+ * SvelteKit utilities, components and helpers for ainsley.dev builds.
+ * Provides form utilities, grid components, and Payload CMS integrations.
+ */
+export * from './components/Grid/index.js';
+export * from './components/payload/index.js';
+export * from './utils/forms/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @ainsleydev/sveltekit-helper
+ *
+ * SvelteKit utilities, components and helpers for ainsley.dev builds.
+ * Provides form utilities, grid components, and Payload CMS integrations.
+ */ // Re-export all exports from submodules
+export * from './components/Grid/index.js';
+export * from './components/payload/index.js';
+export * from './utils/forms/index.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @ainsleydev/sveltekit-helper\n *\n * SvelteKit utilities, components and helpers for ainsley.dev builds.\n * Provides form utilities, grid components, and Payload CMS integrations.\n */\n\n// Re-export all exports from submodules\nexport * from './components/Grid/index.js';\nexport * from './components/payload/index.js';\nexport * from './utils/forms/index.js';\n"],"names":[],"mappings":"AAAA;;;;;CAKC,GAED,wCAAwC;AACxC,cAAc,6BAA6B;AAC3C,cAAc,gCAAgC;AAC9C,cAAc,yBAAyB"}

package/dist/utils/forms/helpers.d.ts

@@ -0,0 +1,24 @@
+import type { z } from 'zod';
+export type FormErrors = Record<string, string>;
+/**
+ * Flattens Zod validation errors into a simple key-value object.
+ * Takes only the first error message for each field.
+ *
+ * @param error - ZodError from validation failure.
+ * @returns Object mapping field names to error messages.
+ *
+ * @example
+ * ```typescript
+ * import { flattenZodErrors } from '@ainsleydev/sveltekit-helper/utils/forms'
+ *
+ * const schema = z.object({ email: z.string().email() })
+ * const result = schema.safeParse({ email: 'invalid' })
+ *
+ * if (!result.success) {
+ *   const errors = flattenZodErrors(result.error)
+ *   // { email: 'Invalid email' }
+ * }
+ * ```
+ */
+export declare const flattenZodErrors: (error: z.ZodError) => FormErrors;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/forms/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/forms/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,CAAC,CAAC,QAAQ,KAAG,UAWpD,CAAC"}

package/dist/utils/forms/helpers.js

@@ -0,0 +1,31 @@
+/**
+ * Flattens Zod validation errors into a simple key-value object.
+ * Takes only the first error message for each field.
+ *
+ * @param error - ZodError from validation failure.
+ * @returns Object mapping field names to error messages.
+ *
+ * @example
+ * ```typescript
+ * import { flattenZodErrors } from '@ainsleydev/sveltekit-helper/utils/forms'
+ *
+ * const schema = z.object({ email: z.string().email() })
+ * const result = schema.safeParse({ email: 'invalid' })
+ *
+ * if (!result.success) {
+ *   const errors = flattenZodErrors(result.error)
+ *   // { email: 'Invalid email' }
+ * }
+ * ```
+ */ export const flattenZodErrors = (error)=>{
+    const errors = {};
+    for (const issue of error.issues){
+        const path = issue.path.join('.');
+        if (!errors[path]) {
+            errors[path] = issue.message;
+        }
+    }
+    return errors;
+};
+
+//# sourceMappingURL=helpers.js.map

package/dist/utils/forms/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/forms/helpers.ts"],"sourcesContent":["import type { z } from 'zod';\n\nexport type FormErrors = Record<string, string>;\n\n/**\n * Flattens Zod validation errors into a simple key-value object.\n * Takes only the first error message for each field.\n *\n * @param error - ZodError from validation failure.\n * @returns Object mapping field names to error messages.\n *\n * @example\n * ```typescript\n * import { flattenZodErrors } from '@ainsleydev/sveltekit-helper/utils/forms'\n *\n * const schema = z.object({ email: z.string().email() })\n * const result = schema.safeParse({ email: 'invalid' })\n *\n * if (!result.success) {\n *   const errors = flattenZodErrors(result.error)\n *   // { email: 'Invalid email' }\n * }\n * ```\n */\nexport const flattenZodErrors = (error: z.ZodError): FormErrors => {\n\tconst errors: FormErrors = {};\n\n\tfor (const issue of error.issues) {\n\t\tconst path = issue.path.join('.');\n\t\tif (!errors[path]) {\n\t\t\terrors[path] = issue.message;\n\t\t}\n\t}\n\n\treturn errors;\n};\n"],"names":["flattenZodErrors","error","errors","issue","issues","path","join","message"],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,MAAMA,mBAAmB,CAACC;IAChC,MAAMC,SAAqB,CAAC;IAE5B,KAAK,MAAMC,SAASF,MAAMG,MAAM,CAAE;QACjC,MAAMC,OAAOF,MAAME,IAAI,CAACC,IAAI,CAAC;QAC7B,IAAI,CAACJ,MAAM,CAACG,KAAK,EAAE;YAClBH,MAAM,CAACG,KAAK,GAAGF,MAAMI,OAAO;QAC7B;IACD;IAEA,OAAOL;AACR,EAAE"}

package/dist/utils/forms/index.d.ts

@@ -0,0 +1,3 @@
+export { flattenZodErrors, type FormErrors } from './helpers.js';
+export { generateFormSchema, type PayloadFormField } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/forms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/forms/index.js

@@ -0,0 +1,4 @@
+export { flattenZodErrors } from './helpers.js';
+export { generateFormSchema } from './schema.js';
+
+//# sourceMappingURL=index.js.map

package/dist/utils/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/forms/index.ts"],"sourcesContent":["export { flattenZodErrors, type FormErrors } from './helpers.js';\nexport { generateFormSchema, type PayloadFormField } from './schema.js';\n"],"names":["flattenZodErrors","generateFormSchema"],"mappings":"AAAA,SAASA,gBAAgB,QAAyB,eAAe;AACjE,SAASC,kBAAkB,QAA+B,cAAc"}

package/dist/utils/forms/schema.d.ts

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+/**
+ * Represents a form field from Payload CMS form builder.
+ * This is a simplified type that covers the most common field types.
+ */
+export type PayloadFormField = {
+    name: string;
+    label?: string | null;
+    placeholder?: string | null;
+    defaultValue?: string | null;
+    required?: boolean | null;
+    id?: string | null;
+    blockName?: string | null;
+    blockType: 'text';
+} | {
+    name: string;
+    label?: string | null;
+    placeholder?: string | null;
+    defaultValue?: string | null;
+    required?: boolean | null;
+    id?: string | null;
+    blockName?: string | null;
+    blockType: 'email';
+} | {
+    name: string;
+    label?: string | null;
+    placeholder?: string | null;
+    defaultValue?: number | null;
+    required?: boolean | null;
+    id?: string | null;
+    blockName?: string | null;
+    blockType: 'number';
+} | {
+    name: string;
+    label?: string | null;
+    placeholder?: string | null;
+    defaultValue?: string | null;
+    required?: boolean | null;
+    id?: string | null;
+    blockName?: string | null;
+    blockType: 'textarea';
+} | {
+    name: string;
+    label?: string | null;
+    defaultValue?: boolean | null;
+    required?: boolean | null;
+    id?: string | null;
+    blockName?: string | null;
+    blockType: 'checkbox';
+};
+/**
+ * Generates a dynamic Zod schema from Payload CMS Form Fields.
+ *
+ * This utility automatically creates validation schemas for Payload form fields,
+ * respecting required flags and field types.
+ *
+ * @param fields - Array of form fields from Payload CMS form builder.
+ * @returns Zod object schema for validating the form.
+ *
+ * @example
+ * ```typescript
+ * import { generateFormSchema } from '@ainsleydev/sveltekit-helper/utils/forms'
+ *
+ * const fields = [
+ *   { blockType: 'text', name: 'name', label: 'Name', required: true },
+ *   { blockType: 'email', name: 'email', label: 'Email', required: true },
+ *   { blockType: 'textarea', name: 'message', label: 'Message', required: false }
+ * ]
+ *
+ * const schema = generateFormSchema(fields)
+ * // Returns z.object({
+ * //   name: z.string().min(1, { message: 'Name is required' }),
+ * //   email: z.string().email({ message: 'Invalid email' }),
+ * //   message: z.string().optional()
+ * // })
+ * ```
+ */
+export declare const generateFormSchema: (fields?: PayloadFormField[] | null) => z.ZodObject<Record<string, z.ZodTypeAny>>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/forms/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/forms/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACzB;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACjB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CAClB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC;CACnB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACrB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACrB,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,kBAAkB,GAC9B,SAAS,gBAAgB,EAAE,GAAG,IAAI,KAChC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CA0B1C,CAAC"}

package/dist/utils/forms/schema.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+/**
+ * Generates a dynamic Zod schema from Payload CMS Form Fields.
+ *
+ * This utility automatically creates validation schemas for Payload form fields,
+ * respecting required flags and field types.
+ *
+ * @param fields - Array of form fields from Payload CMS form builder.
+ * @returns Zod object schema for validating the form.
+ *
+ * @example
+ * ```typescript
+ * import { generateFormSchema } from '@ainsleydev/sveltekit-helper/utils/forms'
+ *
+ * const fields = [
+ *   { blockType: 'text', name: 'name', label: 'Name', required: true },
+ *   { blockType: 'email', name: 'email', label: 'Email', required: true },
+ *   { blockType: 'textarea', name: 'message', label: 'Message', required: false }
+ * ]
+ *
+ * const schema = generateFormSchema(fields)
+ * // Returns z.object({
+ * //   name: z.string().min(1, { message: 'Name is required' }),
+ * //   email: z.string().email({ message: 'Invalid email' }),
+ * //   message: z.string().optional()
+ * // })
+ * ```
+ */ export const generateFormSchema = (fields)=>{
+    if (!fields?.length) return z.object({});
+    const shape = {};
+    for (const field of fields){
+        if (field.blockType === 'text' || field.blockType === 'textarea') {
+            shape[field.name] = field.required ? z.string().min(1, {
+                message: `${field.label || field.name} is required`
+            }) : z.string().optional();
+        } else if (field.blockType === 'email') {
+            shape[field.name] = field.required ? z.string().email({
+                message: 'Invalid email'
+            }) : z.string().email({
+                message: 'Invalid email'
+            }).optional();
+        } else if (field.blockType === 'number') {
+            shape[field.name] = field.required ? z.number() : z.number().optional();
+        } else if (field.blockType === 'checkbox') {
+            shape[field.name] = field.required ? z.boolean().refine((val)=>val === true, {
+                message: `${field.label || field.name} must be checked`
+            }) : z.boolean().optional();
+        }
+    }
+    return z.object(shape);
+};
+
+//# sourceMappingURL=schema.js.map

package/dist/utils/forms/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/forms/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Represents a form field from Payload CMS form builder.\n * This is a simplified type that covers the most common field types.\n */\nexport type PayloadFormField =\n\t| {\n\t\t\tname: string;\n\t\t\tlabel?: string | null;\n\t\t\tplaceholder?: string | null;\n\t\t\tdefaultValue?: string | null;\n\t\t\trequired?: boolean | null;\n\t\t\tid?: string | null;\n\t\t\tblockName?: string | null;\n\t\t\tblockType: 'text';\n\t  }\n\t| {\n\t\t\tname: string;\n\t\t\tlabel?: string | null;\n\t\t\tplaceholder?: string | null;\n\t\t\tdefaultValue?: string | null;\n\t\t\trequired?: boolean | null;\n\t\t\tid?: string | null;\n\t\t\tblockName?: string | null;\n\t\t\tblockType: 'email';\n\t  }\n\t| {\n\t\t\tname: string;\n\t\t\tlabel?: string | null;\n\t\t\tplaceholder?: string | null;\n\t\t\tdefaultValue?: number | null;\n\t\t\trequired?: boolean | null;\n\t\t\tid?: string | null;\n\t\t\tblockName?: string | null;\n\t\t\tblockType: 'number';\n\t  }\n\t| {\n\t\t\tname: string;\n\t\t\tlabel?: string | null;\n\t\t\tplaceholder?: string | null;\n\t\t\tdefaultValue?: string | null;\n\t\t\trequired?: boolean | null;\n\t\t\tid?: string | null;\n\t\t\tblockName?: string | null;\n\t\t\tblockType: 'textarea';\n\t  }\n\t| {\n\t\t\tname: string;\n\t\t\tlabel?: string | null;\n\t\t\tdefaultValue?: boolean | null;\n\t\t\trequired?: boolean | null;\n\t\t\tid?: string | null;\n\t\t\tblockName?: string | null;\n\t\t\tblockType: 'checkbox';\n\t  };\n\n/**\n * Generates a dynamic Zod schema from Payload CMS Form Fields.\n *\n * This utility automatically creates validation schemas for Payload form fields,\n * respecting required flags and field types.\n *\n * @param fields - Array of form fields from Payload CMS form builder.\n * @returns Zod object schema for validating the form.\n *\n * @example\n * ```typescript\n * import { generateFormSchema } from '@ainsleydev/sveltekit-helper/utils/forms'\n *\n * const fields = [\n *   { blockType: 'text', name: 'name', label: 'Name', required: true },\n *   { blockType: 'email', name: 'email', label: 'Email', required: true },\n *   { blockType: 'textarea', name: 'message', label: 'Message', required: false }\n * ]\n *\n * const schema = generateFormSchema(fields)\n * // Returns z.object({\n * //   name: z.string().min(1, { message: 'Name is required' }),\n * //   email: z.string().email({ message: 'Invalid email' }),\n * //   message: z.string().optional()\n * // })\n * ```\n */\nexport const generateFormSchema = (\n\tfields?: PayloadFormField[] | null,\n): z.ZodObject<Record<string, z.ZodTypeAny>> => {\n\tif (!fields?.length) return z.object({}) as z.ZodObject<Record<string, z.ZodTypeAny>>;\n\n\tconst shape: Record<string, z.ZodTypeAny> = {};\n\n\tfor (const field of fields) {\n\t\tif (field.blockType === 'text' || field.blockType === 'textarea') {\n\t\t\tshape[field.name] = field.required\n\t\t\t\t? z.string().min(1, { message: `${field.label || field.name} is required` })\n\t\t\t\t: z.string().optional();\n\t\t} else if (field.blockType === 'email') {\n\t\t\tshape[field.name] = field.required\n\t\t\t\t? z.string().email({ message: 'Invalid email' })\n\t\t\t\t: z.string().email({ message: 'Invalid email' }).optional();\n\t\t} else if (field.blockType === 'number') {\n\t\t\tshape[field.name] = field.required ? z.number() : z.number().optional();\n\t\t} else if (field.blockType === 'checkbox') {\n\t\t\tshape[field.name] = field.required\n\t\t\t\t? z.boolean().refine((val) => val === true, {\n\t\t\t\t\t\tmessage: `${field.label || field.name} must be checked`,\n\t\t\t\t\t})\n\t\t\t\t: z.boolean().optional();\n\t\t}\n\t}\n\n\treturn z.object(shape) as z.ZodObject<Record<string, z.ZodTypeAny>>;\n};\n"],"names":["z","generateFormSchema","fields","length","object","shape","field","blockType","name","required","string","min","message","label","optional","email","number","boolean","refine","val"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AAyDxB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BC,GACD,OAAO,MAAMC,qBAAqB,CACjCC;IAEA,IAAI,CAACA,QAAQC,QAAQ,OAAOH,EAAEI,MAAM,CAAC,CAAC;IAEtC,MAAMC,QAAsC,CAAC;IAE7C,KAAK,MAAMC,SAASJ,OAAQ;QAC3B,IAAII,MAAMC,SAAS,KAAK,UAAUD,MAAMC,SAAS,KAAK,YAAY;YACjEF,KAAK,CAACC,MAAME,IAAI,CAAC,GAAGF,MAAMG,QAAQ,GAC/BT,EAAEU,MAAM,GAAGC,GAAG,CAAC,GAAG;gBAAEC,SAAS,GAAGN,MAAMO,KAAK,IAAIP,MAAME,IAAI,CAAC,YAAY,CAAC;YAAC,KACxER,EAAEU,MAAM,GAAGI,QAAQ;QACvB,OAAO,IAAIR,MAAMC,SAAS,KAAK,SAAS;YACvCF,KAAK,CAACC,MAAME,IAAI,CAAC,GAAGF,MAAMG,QAAQ,GAC/BT,EAAEU,MAAM,GAAGK,KAAK,CAAC;gBAAEH,SAAS;YAAgB,KAC5CZ,EAAEU,MAAM,GAAGK,KAAK,CAAC;gBAAEH,SAAS;YAAgB,GAAGE,QAAQ;QAC3D,OAAO,IAAIR,MAAMC,SAAS,KAAK,UAAU;YACxCF,KAAK,CAACC,MAAME,IAAI,CAAC,GAAGF,MAAMG,QAAQ,GAAGT,EAAEgB,MAAM,KAAKhB,EAAEgB,MAAM,GAAGF,QAAQ;QACtE,OAAO,IAAIR,MAAMC,SAAS,KAAK,YAAY;YAC1CF,KAAK,CAACC,MAAME,IAAI,CAAC,GAAGF,MAAMG,QAAQ,GAC/BT,EAAEiB,OAAO,GAAGC,MAAM,CAAC,CAACC,MAAQA,QAAQ,MAAM;gBAC1CP,SAAS,GAAGN,MAAMO,KAAK,IAAIP,MAAME,IAAI,CAAC,gBAAgB,CAAC;YACxD,KACCR,EAAEiB,OAAO,GAAGH,QAAQ;QACxB;IACD;IAEA,OAAOd,EAAEI,MAAM,CAACC;AACjB,EAAE"}

package/dist/utils/forms/schema.test.js

@@ -0,0 +1,115 @@
+import { describe, expect, test } from 'vitest';
+import { z } from 'zod';
+import { generateFormSchema } from './schema';
+describe('generateFormSchema', ()=>{
+    test('returns empty object schema when no fields provided', ()=>{
+        const schema = generateFormSchema(null);
+        expect(schema).toBeInstanceOf(z.ZodObject);
+        expect(schema.shape).toEqual({});
+    });
+    test('returns empty object schema for empty array', ()=>{
+        const schema = generateFormSchema([]);
+        expect(schema).toBeInstanceOf(z.ZodObject);
+        expect(schema.shape).toEqual({});
+    });
+    test('generates required text field schema', ()=>{
+        const fields = [
+            {
+                blockType: 'text',
+                name: 'firstName',
+                label: 'First Name',
+                required: true
+            }
+        ];
+        const schema = generateFormSchema(fields);
+        const result = schema.safeParse({
+            firstName: ''
+        });
+        expect(result.success).toBe(false);
+        const validResult = schema.safeParse({
+            firstName: 'John'
+        });
+        expect(validResult.success).toBe(true);
+    });
+    test('generates optional text field schema', ()=>{
+        const fields = [
+            {
+                blockType: 'text',
+                name: 'middleName',
+                label: 'Middle Name',
+                required: false
+            }
+        ];
+        const schema = generateFormSchema(fields);
+        const result = schema.safeParse({});
+        expect(result.success).toBe(true);
+    });
+    test('generates required email field schema', ()=>{
+        const fields = [
+            {
+                blockType: 'email',
+                name: 'email',
+                label: 'Email',
+                required: true
+            }
+        ];
+        const schema = generateFormSchema(fields);
+        const invalidResult = schema.safeParse({
+            email: 'not-an-email'
+        });
+        expect(invalidResult.success).toBe(false);
+        const validResult = schema.safeParse({
+            email: 'test@example.com'
+        });
+        expect(validResult.success).toBe(true);
+    });
+    test('generates required checkbox field schema', ()=>{
+        const fields = [
+            {
+                blockType: 'checkbox',
+                name: 'terms',
+                label: 'Accept Terms',
+                required: true
+            }
+        ];
+        const schema = generateFormSchema(fields);
+        const falseResult = schema.safeParse({
+            terms: false
+        });
+        expect(falseResult.success).toBe(false);
+        const trueResult = schema.safeParse({
+            terms: true
+        });
+        expect(trueResult.success).toBe(true);
+    });
+    test('generates schema with multiple fields', ()=>{
+        const fields = [
+            {
+                blockType: 'text',
+                name: 'name',
+                label: 'Name',
+                required: true
+            },
+            {
+                blockType: 'email',
+                name: 'email',
+                label: 'Email',
+                required: true
+            },
+            {
+                blockType: 'textarea',
+                name: 'message',
+                label: 'Message',
+                required: false
+            }
+        ];
+        const schema = generateFormSchema(fields);
+        const result = schema.safeParse({
+            name: 'John',
+            email: 'john@example.com'
+        });
+        expect(result.success).toBe(true);
+    });
+});
+
+//# sourceMappingURL=schema.test.js.map

package/dist/utils/forms/schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/forms/schema.test.ts"],"sourcesContent":["import { describe, expect, test } from 'vitest';\nimport { z } from 'zod';\n\nimport { generateFormSchema } from './schema';\n\ndescribe('generateFormSchema', () => {\n\ttest('returns empty object schema when no fields provided', () => {\n\t\tconst schema = generateFormSchema(null);\n\t\texpect(schema).toBeInstanceOf(z.ZodObject);\n\t\texpect(schema.shape).toEqual({});\n\t});\n\n\ttest('returns empty object schema for empty array', () => {\n\t\tconst schema = generateFormSchema([]);\n\t\texpect(schema).toBeInstanceOf(z.ZodObject);\n\t\texpect(schema.shape).toEqual({});\n\t});\n\n\ttest('generates required text field schema', () => {\n\t\tconst fields = [\n\t\t\t{\n\t\t\t\tblockType: 'text' as const,\n\t\t\t\tname: 'firstName',\n\t\t\t\tlabel: 'First Name',\n\t\t\t\trequired: true,\n\t\t\t},\n\t\t];\n\n\t\tconst schema = generateFormSchema(fields);\n\t\tconst result = schema.safeParse({ firstName: '' });\n\t\texpect(result.success).toBe(false);\n\n\t\tconst validResult = schema.safeParse({ firstName: 'John' });\n\t\texpect(validResult.success).toBe(true);\n\t});\n\n\ttest('generates optional text field schema', () => {\n\t\tconst fields = [\n\t\t\t{\n\t\t\t\tblockType: 'text' as const,\n\t\t\t\tname: 'middleName',\n\t\t\t\tlabel: 'Middle Name',\n\t\t\t\trequired: false,\n\t\t\t},\n\t\t];\n\n\t\tconst schema = generateFormSchema(fields);\n\t\tconst result = schema.safeParse({});\n\t\texpect(result.success).toBe(true);\n\t});\n\n\ttest('generates required email field schema', () => {\n\t\tconst fields = [\n\t\t\t{\n\t\t\t\tblockType: 'email' as const,\n\t\t\t\tname: 'email',\n\t\t\t\tlabel: 'Email',\n\t\t\t\trequired: true,\n\t\t\t},\n\t\t];\n\n\t\tconst schema = generateFormSchema(fields);\n\t\tconst invalidResult = schema.safeParse({ email: 'not-an-email' });\n\t\texpect(invalidResult.success).toBe(false);\n\n\t\tconst validResult = schema.safeParse({ email: 'test@example.com' });\n\t\texpect(validResult.success).toBe(true);\n\t});\n\n\ttest('generates required checkbox field schema', () => {\n\t\tconst fields = [\n\t\t\t{\n\t\t\t\tblockType: 'checkbox' as const,\n\t\t\t\tname: 'terms',\n\t\t\t\tlabel: 'Accept Terms',\n\t\t\t\trequired: true,\n\t\t\t},\n\t\t];\n\n\t\tconst schema = generateFormSchema(fields);\n\t\tconst falseResult = schema.safeParse({ terms: false });\n\t\texpect(falseResult.success).toBe(false);\n\n\t\tconst trueResult = schema.safeParse({ terms: true });\n\t\texpect(trueResult.success).toBe(true);\n\t});\n\n\ttest('generates schema with multiple fields', () => {\n\t\tconst fields = [\n\t\t\t{\n\t\t\t\tblockType: 'text' as const,\n\t\t\t\tname: 'name',\n\t\t\t\tlabel: 'Name',\n\t\t\t\trequired: true,\n\t\t\t},\n\t\t\t{\n\t\t\t\tblockType: 'email' as const,\n\t\t\t\tname: 'email',\n\t\t\t\tlabel: 'Email',\n\t\t\t\trequired: true,\n\t\t\t},\n\t\t\t{\n\t\t\t\tblockType: 'textarea' as const,\n\t\t\t\tname: 'message',\n\t\t\t\tlabel: 'Message',\n\t\t\t\trequired: false,\n\t\t\t},\n\t\t];\n\n\t\tconst schema = generateFormSchema(fields);\n\t\tconst result = schema.safeParse({\n\t\t\tname: 'John',\n\t\t\temail: 'john@example.com',\n\t\t});\n\t\texpect(result.success).toBe(true);\n\t});\n});\n"],"names":["describe","expect","test","z","generateFormSchema","schema","toBeInstanceOf","ZodObject","shape","toEqual","fields","blockType","name","label","required","result","safeParse","firstName","success","toBe","validResult","invalidResult","email","falseResult","terms","trueResult"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,IAAI,QAAQ,SAAS;AAChD,SAASC,CAAC,QAAQ,MAAM;AAExB,SAASC,kBAAkB,QAAQ,WAAW;AAE9CJ,SAAS,sBAAsB;IAC9BE,KAAK,uDAAuD;QAC3D,MAAMG,SAASD,mBAAmB;QAClCH,OAAOI,QAAQC,cAAc,CAACH,EAAEI,SAAS;QACzCN,OAAOI,OAAOG,KAAK,EAAEC,OAAO,CAAC,CAAC;IAC/B;IAEAP,KAAK,+CAA+C;QACnD,MAAMG,SAASD,mBAAmB,EAAE;QACpCH,OAAOI,QAAQC,cAAc,CAACH,EAAEI,SAAS;QACzCN,OAAOI,OAAOG,KAAK,EAAEC,OAAO,CAAC,CAAC;IAC/B;IAEAP,KAAK,wCAAwC;QAC5C,MAAMQ,SAAS;YACd;gBACCC,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;SACA;QAED,MAAMT,SAASD,mBAAmBM;QAClC,MAAMK,SAASV,OAAOW,SAAS,CAAC;YAAEC,WAAW;QAAG;QAChDhB,OAAOc,OAAOG,OAAO,EAAEC,IAAI,CAAC;QAE5B,MAAMC,cAAcf,OAAOW,SAAS,CAAC;YAAEC,WAAW;QAAO;QACzDhB,OAAOmB,YAAYF,OAAO,EAAEC,IAAI,CAAC;IAClC;IAEAjB,KAAK,wCAAwC;QAC5C,MAAMQ,SAAS;YACd;gBACCC,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;SACA;QAED,MAAMT,SAASD,mBAAmBM;QAClC,MAAMK,SAASV,OAAOW,SAAS,CAAC,CAAC;QACjCf,OAAOc,OAAOG,OAAO,EAAEC,IAAI,CAAC;IAC7B;IAEAjB,KAAK,yCAAyC;QAC7C,MAAMQ,SAAS;YACd;gBACCC,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;SACA;QAED,MAAMT,SAASD,mBAAmBM;QAClC,MAAMW,gBAAgBhB,OAAOW,SAAS,CAAC;YAAEM,OAAO;QAAe;QAC/DrB,OAAOoB,cAAcH,OAAO,EAAEC,IAAI,CAAC;QAEnC,MAAMC,cAAcf,OAAOW,SAAS,CAAC;YAAEM,OAAO;QAAmB;QACjErB,OAAOmB,YAAYF,OAAO,EAAEC,IAAI,CAAC;IAClC;IAEAjB,KAAK,4CAA4C;QAChD,MAAMQ,SAAS;YACd;gBACCC,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;SACA;QAED,MAAMT,SAASD,mBAAmBM;QAClC,MAAMa,cAAclB,OAAOW,SAAS,CAAC;YAAEQ,OAAO;QAAM;QACpDvB,OAAOsB,YAAYL,OAAO,EAAEC,IAAI,CAAC;QAEjC,MAAMM,aAAapB,OAAOW,SAAS,CAAC;YAAEQ,OAAO;QAAK;QAClDvB,OAAOwB,WAAWP,OAAO,EAAEC,IAAI,CAAC;IACjC;IAEAjB,KAAK,yCAAyC;QAC7C,MAAMQ,SAAS;YACd;gBACCC,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;YACA;gBACCH,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;YACA;gBACCH,WAAW;gBACXC,MAAM;gBACNC,OAAO;gBACPC,UAAU;YACX;SACA;QAED,MAAMT,SAASD,mBAAmBM;QAClC,MAAMK,SAASV,OAAOW,SAAS,CAAC;YAC/BJ,MAAM;YACNU,OAAO;QACR;QACArB,OAAOc,OAAOG,OAAO,EAAEC,IAAI,CAAC;IAC7B;AACD"}

package/dist/utils/strings/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates an alphanumeric random string.
+ *
+ * @param length - The length of the string to generate.
+ * @returns The generated random string.
+ *
+ * @example
+ * ```typescript
+ * const id = generateRandomString(10)
+ * // Returns something like: "a3k9mxp2q1"
+ * ```
+ */
+export declare const generateRandomString: (length: number) => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/strings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MAMrD,CAAC"}

package/dist/utils/strings/index.js

@@ -0,0 +1,20 @@
+/**
+ * Generates an alphanumeric random string.
+ *
+ * @param length - The length of the string to generate.
+ * @returns The generated random string.
+ *
+ * @example
+ * ```typescript
+ * const id = generateRandomString(10)
+ * // Returns something like: "a3k9mxp2q1"
+ * ```
+ */ export const generateRandomString = (length)=>{
+    let result = '';
+    while(result.length < length){
+        result += (Math.random() + 1).toString(36).substring(2);
+    }
+    return result.substring(0, length);
+};
+
+//# sourceMappingURL=index.js.map

package/dist/utils/strings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/strings/index.ts"],"sourcesContent":["/**\n * Generates an alphanumeric random string.\n *\n * @param length - The length of the string to generate.\n * @returns The generated random string.\n *\n * @example\n * ```typescript\n * const id = generateRandomString(10)\n * // Returns something like: \"a3k9mxp2q1\"\n * ```\n */\nexport const generateRandomString = (length: number): string => {\n\tlet result = '';\n\twhile (result.length < length) {\n\t\tresult += (Math.random() + 1).toString(36).substring(2);\n\t}\n\treturn result.substring(0, length);\n};\n"],"names":["generateRandomString","length","result","Math","random","toString","substring"],"mappings":"AAAA;;;;;;;;;;;CAWC,GACD,OAAO,MAAMA,uBAAuB,CAACC;IACpC,IAAIC,SAAS;IACb,MAAOA,OAAOD,MAAM,GAAGA,OAAQ;QAC9BC,UAAU,AAACC,CAAAA,KAAKC,MAAM,KAAK,CAAA,EAAGC,QAAQ,CAAC,IAAIC,SAAS,CAAC;IACtD;IACA,OAAOJ,OAAOI,SAAS,CAAC,GAAGL;AAC5B,EAAE"}

package/dist/utils/strings/index.test.js

@@ -0,0 +1,28 @@
+import { describe, expect, test } from 'vitest';
+import { generateRandomString } from './index';
+describe('generateRandomString', ()=>{
+    test('generates a string of the specified length', ()=>{
+        const length = 10;
+        const result = generateRandomString(length);
+        expect(result).toHaveLength(length);
+    });
+    test('generates alphanumeric characters only', ()=>{
+        const result = generateRandomString(100);
+        expect(result).toMatch(/^[a-z0-9]+$/);
+    });
+    test('generates different strings on multiple calls', ()=>{
+        const first = generateRandomString(20);
+        const second = generateRandomString(20);
+        expect(first).not.toBe(second);
+    });
+    test('handles length of 0', ()=>{
+        const result = generateRandomString(0);
+        expect(result).toBe('');
+    });
+    test('handles length of 1', ()=>{
+        const result = generateRandomString(1);
+        expect(result).toHaveLength(1);
+    });
+});
+
+//# sourceMappingURL=index.test.js.map

package/dist/utils/strings/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/strings/index.test.ts"],"sourcesContent":["import { describe, expect, test } from 'vitest';\n\nimport { generateRandomString } from './index';\n\ndescribe('generateRandomString', () => {\n\ttest('generates a string of the specified length', () => {\n\t\tconst length = 10;\n\t\tconst result = generateRandomString(length);\n\t\texpect(result).toHaveLength(length);\n\t});\n\n\ttest('generates alphanumeric characters only', () => {\n\t\tconst result = generateRandomString(100);\n\t\texpect(result).toMatch(/^[a-z0-9]+$/);\n\t});\n\n\ttest('generates different strings on multiple calls', () => {\n\t\tconst first = generateRandomString(20);\n\t\tconst second = generateRandomString(20);\n\t\texpect(first).not.toBe(second);\n\t});\n\n\ttest('handles length of 0', () => {\n\t\tconst result = generateRandomString(0);\n\t\texpect(result).toBe('');\n\t});\n\n\ttest('handles length of 1', () => {\n\t\tconst result = generateRandomString(1);\n\t\texpect(result).toHaveLength(1);\n\t});\n});\n"],"names":["describe","expect","test","generateRandomString","length","result","toHaveLength","toMatch","first","second","not","toBe"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,IAAI,QAAQ,SAAS;AAEhD,SAASC,oBAAoB,QAAQ,UAAU;AAE/CH,SAAS,wBAAwB;IAChCE,KAAK,8CAA8C;QAClD,MAAME,SAAS;QACf,MAAMC,SAASF,qBAAqBC;QACpCH,OAAOI,QAAQC,YAAY,CAACF;IAC7B;IAEAF,KAAK,0CAA0C;QAC9C,MAAMG,SAASF,qBAAqB;QACpCF,OAAOI,QAAQE,OAAO,CAAC;IACxB;IAEAL,KAAK,iDAAiD;QACrD,MAAMM,QAAQL,qBAAqB;QACnC,MAAMM,SAASN,qBAAqB;QACpCF,OAAOO,OAAOE,GAAG,CAACC,IAAI,CAACF;IACxB;IAEAP,KAAK,uBAAuB;QAC3B,MAAMG,SAASF,qBAAqB;QACpCF,OAAOI,QAAQM,IAAI,CAAC;IACrB;IAEAT,KAAK,uBAAuB;QAC3B,MAAMG,SAASF,qBAAqB;QACpCF,OAAOI,QAAQC,YAAY,CAAC;IAC7B;AACD"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@ainsleydev/sveltekit-helper",
+  "version": "0.1.0",
+  "description": "SvelteKit utilities, components and helpers for ainsley.dev builds",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "sveltekit",
+    "svelte",
+    "utilities",
+    "components",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ainsleydev/webkit.git",
+    "directory": "packages/sveltekit-helper"
+  },
+  "author": {
+    "name": "ainsley.dev",
+    "email": "hello@ainsley.dev",
+    "url": "https://ainsley.dev"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./components/Grid": {
+      "types": "./dist/components/Grid/index.d.ts",
+      "import": "./dist/components/Grid/index.js"
+    },
+    "./components/payload": {
+      "types": "./dist/components/payload/index.d.ts",
+      "import": "./dist/components/payload/index.js"
+    },
+    "./utils/forms": {
+      "types": "./dist/utils/forms/index.d.ts",
+      "import": "./dist/utils/forms/index.js"
+    },
+    "./utils/strings": {
+      "types": "./dist/utils/strings/index.d.ts",
+      "import": "./dist/utils/strings/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@sveltejs/kit": "^2.0.0",
+    "svelte": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "payload": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@sveltejs/kit": "^2.0.0",
+    "@sveltejs/package": "^2.0.0",
+    "@swc/cli": "^0.7.8",
+    "@swc/core": "^1.7.2",
+    "@types/node": "^24.10.1",
+    "payload": "3.63.0",
+    "rimraf": "6.1.0",
+    "svelte": "^5.0.0",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5",
+    "zod": "^3.24.3",
+    "@ainsleydev/eslint-config": "0.0.9"
+  },
+  "engines": {
+    "node": ">=18",
+    "pnpm": ">=9"
+  },
+  "scripts": {
+    "build": "pnpm clean && pnpm build:types && pnpm build:swc",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "format": "biome check --write --unsafe .",
+    "lint": "biome lint --write .",
+    "clean": "rimraf {dist,*.tsbuildinfo}",
+    "test": "vitest run"
+  }
+}