@kontsedal/olas-core 0.0.1-rc.0

package/src/forms/validators.ts

@@ -0,0 +1,70 @@
+import type { Validator } from './types'
+
+const isEmpty = (value: unknown): boolean => {
+  if (value === undefined || value === null) return true
+  if (typeof value === 'string') return value.length === 0
+  if (Array.isArray(value)) return value.length === 0
+  return false
+}
+
+/** Reject empty values (undefined, null, empty string, empty array). */
+export const required =
+  <T>(message = 'Required'): Validator<T> =>
+  (value) =>
+    isEmpty(value) ? message : null
+
+/** Reject strings / arrays shorter than `n`. Allows null/undefined (use with `required` to forbid). */
+export const minLength =
+  (n: number, message?: string): Validator<string | readonly unknown[]> =>
+  (value) => {
+    if (value == null) return null
+    if (value.length >= n) return null
+    return message ?? `Must be at least ${n} characters`
+  }
+
+/** Reject strings / arrays longer than `n`. */
+export const maxLength =
+  (n: number, message?: string): Validator<string | readonly unknown[]> =>
+  (value) => {
+    if (value == null) return null
+    if (value.length <= n) return null
+    return message ?? `Must be no more than ${n} characters`
+  }
+
+/** Reject numbers less than `n`. */
+export const min =
+  (n: number, message?: string): Validator<number> =>
+  (value) => {
+    if (value == null) return null
+    if (value >= n) return null
+    return message ?? `Must be at least ${n}`
+  }
+
+/** Reject numbers greater than `n`. */
+export const max =
+  (n: number, message?: string): Validator<number> =>
+  (value) => {
+    if (value == null) return null
+    if (value <= n) return null
+    return message ?? `Must be no more than ${n}`
+  }
+
+// RFC-5322-light. Pragmatic, not exhaustive — production forms should
+// rely on server-side validation for definitive answers.
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+
+/** Reject strings that don't look like an email. Empty / null pass (use with `required` to forbid). */
+export const email =
+  (message = 'Invalid email address'): Validator<string> =>
+  (value) => {
+    if (value == null || value === '') return null
+    return EMAIL_RE.test(value) ? null : message
+  }
+
+/** Reject strings that don't match the supplied `RegExp`. */
+export const pattern =
+  (re: RegExp, message = 'Invalid format'): Validator<string> =>
+  (value) => {
+    if (value == null || value === '') return null
+    return re.test(value) ? null : message
+  }

package/src/index.ts

@@ -0,0 +1,89 @@
+// Signals
+
+// Controller container
+export type {
+  AmbientDeps,
+  ControllerDef,
+  CtrlApi,
+  CtrlProps,
+  Ctx,
+  Field,
+  Root,
+  RootOptions,
+} from './controller'
+export { createRoot, defineController } from './controller'
+// Errors & devtools
+export type { DebugBus, DebugCacheEntry, DebugEvent } from './devtools'
+
+// Emitter
+export type { Emitter } from './emitter'
+export { createEmitter } from './emitter'
+export type { ErrorContext } from './errors'
+// Forms — stdlib validators + debouncedValidator
+export type { Validator } from './forms'
+export { email, max, maxLength, min, minLength, pattern, required } from './forms'
+export { debouncedValidator } from './forms/field'
+export type {
+  DeepPartial,
+  FieldArray,
+  FieldArrayItemErrors,
+  FieldArrayOptions,
+  FieldArrayValidator,
+  FieldArrayValue,
+  Form,
+  FormErrors,
+  FormOptions,
+  FormSchema,
+  FormValidator,
+  FormValue,
+  ItemInitial,
+} from './forms/form-types'
+export { defineInfiniteQuery, defineQuery } from './query/define'
+export type {
+  InfiniteQuery,
+  InfiniteQuerySpec,
+  InfiniteQuerySubscription,
+} from './query/infinite'
+export type {
+  Mutation,
+  MutationConcurrency,
+  MutationSpec,
+} from './query/mutation'
+// Query-client plugins (§13.2)
+export type {
+  GcEvent,
+  InvalidateEvent,
+  QueryClientPlugin,
+  QueryClientPluginApi,
+  RegisteredQuery,
+  SetDataEvent,
+} from './query/plugin'
+export { lookupRegisteredQuery } from './query/plugin'
+// Query primitives
+export type {
+  AsyncState,
+  AsyncStatus,
+  DehydratedEntry,
+  DehydratedState,
+  LocalCache,
+  Query,
+  QuerySpec,
+  QuerySubscription,
+  RetryDelay,
+  RetryPolicy,
+  Snapshot,
+  UseOptions,
+} from './query/types'
+// Scopes — typed cross-tree data (§10.3)
+export type { Scope, ScopeOptions } from './scope'
+export { defineScope } from './scope'
+// Selection — multi-select with shift/meta-click semantics (§17.5)
+export type { Selection } from './selection'
+export { selection } from './selection'
+export type { Computed, ReadSignal, Signal } from './signals'
+export { batch, computed, effect, signal, untracked } from './signals'
+// Timing
+export { debounced, throttled } from './timing'
+
+// Utilities
+export { isAbortError } from './utils'