attaform 0.25.0 → 0.27.0

package/dist/shared/attaform.C3Doa9Pt.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"attaform.C3Doa9Pt.mjs","sources":["../../src/core/webpack-family-plugin.ts"],"sourcesContent":["/**\n * Shared webpack/rspack plugin body. Rspack mirrors webpack's plugin API\n * for the resolve hooks attaform taps, so one implementation backs both\n * `attaform/webpack` and `attaform/rspack`; only the diagnostic `tag`\n * differs.\n *\n * The plugin taps `normalModuleFactory.beforeResolve` and rewrites the\n * `attaform/zod` request to the matching adapter subpath, the same effect\n * as webpack's own `NormalModuleReplacementPlugin` but tapping the hook\n * directly so the plugin imports nothing from webpack/rspack (keeping\n * attaform dependency-free). The bundler injects the hook API at the\n * consumer's build, so the minimal structural types below are all the\n * plugin needs to compile.\n *\n * Build-time only: never part of a consumer's browser bundle.\n */\nimport { resolveZodAliasTarget, ZOD_UNIFIED_SPECIFIER } from './detect-zod-major'\n\nexport interface WebpackFamilyPluginOptions {\n  /**\n   * Rewrite `attaform/zod` imports at build time to the matching adapter\n   * subpath, based on the consumer's installed Zod major. Default `true`.\n   * Set to `false` to keep the runtime-dispatch unified entry (ships both\n   * adapters) when a project intentionally mixes Zod versions or resolves\n   * Zod in a non-standard way.\n   */\n  resolveZodAlias?: boolean\n  /**\n   * Project root to resolve the installed Zod from. Defaults to the\n   * compiler's `context`, falling back to `process.cwd()`. Set this when\n   * the build runs from a directory other than the project that owns the\n   * Zod dependency (some monorepo layouts).\n   */\n  root?: string\n}\n\ninterface WebpackTapable<T> {\n  tap(name: string, fn: (arg: T) => void): void\n}\ninterface WebpackResolveData {\n  request: string\n}\ninterface WebpackNormalModuleFactory {\n  hooks: { beforeResolve: WebpackTapable<WebpackResolveData> }\n}\ninterface WebpackCompiler {\n  context?: string\n  hooks: { normalModuleFactory: WebpackTapable<WebpackNormalModuleFactory> }\n}\n\n/** The structural shape webpack/rspack require of a plugin: an object\n * with an `apply(compiler)` method. */\nexport interface WebpackFamilyPlugin {\n  apply(compiler: WebpackCompiler): void\n}\n\nconst TAP_NAME = 'attaform'\n\nexport function createWebpackFamilyPlugin(\n  tag: string,\n  options: WebpackFamilyPluginOptions\n): WebpackFamilyPlugin {\n  const resolveZodAlias = options.resolveZodAlias !== false\n  const warnState = { warned: false }\n  return {\n    apply(compiler) {\n      const root = compiler.context ?? options.root ?? process.cwd()\n      const target = resolveZodAliasTarget(root, tag, resolveZodAlias, warnState)\n      if (target === null) return\n      compiler.hooks.normalModuleFactory.tap(TAP_NAME, (factory) => {\n        factory.hooks.beforeResolve.tap(TAP_NAME, (data) => {\n          if (data.request === ZOD_UNIFIED_SPECIFIER) {\n            data.request = target\n          }\n        })\n      })\n    },\n  }\n}\n"],"names":[],"mappings":";;AAwDA,MAAM,QAAA,GAAW,UAAA;AAEV,SAAS,yBAAA,CACd,KACA,OAAA,EACqB;AACrB,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,KAAoB,KAAA;AACpD,EAAA,MAAM,SAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,EAAM;AAClC,EAAA,OAAO;AAAA,IACL,MAAM,QAAA,EAAU;AACd,MAAA,MAAM,OAAO,QAAA,CAAS,OAAA,IAAW,OAAA,CAAQ,IAAA,IAAQ,QAAQ,GAAA,EAAI;AAC7D,MAAA,MAAM,MAAA,GAAS,qBAAA,CAAsB,IAAA,EAAM,GAAA,EAAK,iBAAiB,SAAS,CAAA;AAC1E,MAAA,IAAI,WAAW,IAAA,EAAM;AACrB,MAAA,QAAA,CAAS,KAAA,CAAM,mBAAA,CAAoB,GAAA,CAAI,QAAA,EAAU,CAAC,OAAA,KAAY;AAC5D,QAAA,OAAA,CAAQ,KAAA,CAAM,aAAA,CAAc,GAAA,CAAI,QAAA,EAAU,CAAC,IAAA,KAAS;AAClD,UAAA,IAAI,IAAA,CAAK,YAAY,qBAAA,EAAuB;AAC1C,YAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,UACjB;AAAA,QACF,CAAC,CAAA;AAAA,MACH,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;;"}

package/dist/shared/attaform.CO0e7YVY.d.cts

@@ -1,94 +0,0 @@
-/**
- * Typed error classes thrown by the form library. Each one signals a
- * distinct misuse so calling code can branch on `instanceof` instead
- * of pattern-matching error messages.
- *
- * Every class extends `AttaformError`, so consumers can write a single
- * polymorphic catch (`catch (e) { if (e instanceof AttaformError) ... }`)
- * instead of OR-chaining checks for each subclass. `AttaformError` itself
- * extends the standard `Error`, so existing `instanceof Error` usage
- * keeps working.
- */
-/**
- * Base for every error class thrown by `attaform`. Sets
- * `this.name` from the constructor's `new.target.name`, so subclasses
- * don't have to redeclare their own name override.
- */
-declare class AttaformError extends Error {
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Thrown when a path string is malformed — typically a dotted path
- * with empty segments (e.g. `'a..b'`, leading or trailing dots).
- * Use array form (`['a', 'b']`) for keys that contain literal dots.
- */
-declare class InvalidPathError extends AttaformError {
-}
-/**
- * Thrown when `useForm` receives an invalid configuration — most often
- * a schema passed directly as the first argument, or no argument at
- * all. The configuration is an options bag; the schema is one of
- * several fields, even when it's the only one in use.
- *
- * ```ts
- * // ✗ Crashes deep inside the validator with an opaque message:
- * const form = useForm(z.object({ ... }))
- * // ✗ Same:
- * const form = useForm()
- * // ✓ Pass the schema as the `schema` field:
- * const form = useForm({ schema: z.object({ ... }) })
- * ```
- *
- * The same shape applies to every entry point: `attaform/zod`,
- * `attaform/zod-v3`, `attaform/zod-v4`, and the schema-agnostic
- * `attaform` root.
- */
-declare class InvalidUseFormConfigError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when a `handleSubmit`-supplied `onError` callback itself
- * throws or rejects. Wraps the inner failure so both the original
- * cause (via `error.cause`) and the propagation site are visible.
- */
-declare class SubmitErrorHandlerError extends AttaformError {
-}
-/**
- * Thrown when an `attaform` API needs the registry attached to a Vue
- * app but it isn't there yet. Component-level entry points (`useForm`,
- * `injectForm`, `useRegister`) lazy-install the registry on first use,
- * so this error is mostly reached by SSR helpers — `renderAttaformState`
- * and `hydrateAttaformState` — which run outside a setup context and
- * have no current instance to install against.
- *
- * Fix: add `app.use(createAttaform())` (or `app.use(createAttaform({
- * ssr: true }))` on the server) to your SSR entry, before
- * `renderToString` / hydration. Under Nuxt, `attaform/nuxt` already
- * does this; the error usually points at a non-Nuxt SSR setup that
- * hasn't installed explicitly.
- */
-declare class RegistryNotInstalledError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when `useForm` / `injectForm` is called outside of a
- * Vue `setup()` function — typically from an event handler, watcher,
- * or async callback that runs after mount.
- *
- * Fix: move the call into `setup()`, or trigger it from a child
- * component whose `setup()` runs the composable.
- */
-declare class OutsideSetupError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when a `useForm({ key })` call uses a key starting with
- * `__atta:`. That prefix is reserved for keys the library generates
- * internally (e.g. for anonymous `useForm()` calls without an
- * explicit key). Pick a different prefix for your form.
- */
-declare class ReservedFormKeyError extends AttaformError {
-    constructor(key: string);
-}
-
-export { AttaformError as A, InvalidPathError as I, OutsideSetupError as O, RegistryNotInstalledError as R, SubmitErrorHandlerError as S, InvalidUseFormConfigError as a, ReservedFormKeyError as b };

package/dist/shared/attaform.CO0e7YVY.d.mts

@@ -1,94 +0,0 @@
-/**
- * Typed error classes thrown by the form library. Each one signals a
- * distinct misuse so calling code can branch on `instanceof` instead
- * of pattern-matching error messages.
- *
- * Every class extends `AttaformError`, so consumers can write a single
- * polymorphic catch (`catch (e) { if (e instanceof AttaformError) ... }`)
- * instead of OR-chaining checks for each subclass. `AttaformError` itself
- * extends the standard `Error`, so existing `instanceof Error` usage
- * keeps working.
- */
-/**
- * Base for every error class thrown by `attaform`. Sets
- * `this.name` from the constructor's `new.target.name`, so subclasses
- * don't have to redeclare their own name override.
- */
-declare class AttaformError extends Error {
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Thrown when a path string is malformed — typically a dotted path
- * with empty segments (e.g. `'a..b'`, leading or trailing dots).
- * Use array form (`['a', 'b']`) for keys that contain literal dots.
- */
-declare class InvalidPathError extends AttaformError {
-}
-/**
- * Thrown when `useForm` receives an invalid configuration — most often
- * a schema passed directly as the first argument, or no argument at
- * all. The configuration is an options bag; the schema is one of
- * several fields, even when it's the only one in use.
- *
- * ```ts
- * // ✗ Crashes deep inside the validator with an opaque message:
- * const form = useForm(z.object({ ... }))
- * // ✗ Same:
- * const form = useForm()
- * // ✓ Pass the schema as the `schema` field:
- * const form = useForm({ schema: z.object({ ... }) })
- * ```
- *
- * The same shape applies to every entry point: `attaform/zod`,
- * `attaform/zod-v3`, `attaform/zod-v4`, and the schema-agnostic
- * `attaform` root.
- */
-declare class InvalidUseFormConfigError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when a `handleSubmit`-supplied `onError` callback itself
- * throws or rejects. Wraps the inner failure so both the original
- * cause (via `error.cause`) and the propagation site are visible.
- */
-declare class SubmitErrorHandlerError extends AttaformError {
-}
-/**
- * Thrown when an `attaform` API needs the registry attached to a Vue
- * app but it isn't there yet. Component-level entry points (`useForm`,
- * `injectForm`, `useRegister`) lazy-install the registry on first use,
- * so this error is mostly reached by SSR helpers — `renderAttaformState`
- * and `hydrateAttaformState` — which run outside a setup context and
- * have no current instance to install against.
- *
- * Fix: add `app.use(createAttaform())` (or `app.use(createAttaform({
- * ssr: true }))` on the server) to your SSR entry, before
- * `renderToString` / hydration. Under Nuxt, `attaform/nuxt` already
- * does this; the error usually points at a non-Nuxt SSR setup that
- * hasn't installed explicitly.
- */
-declare class RegistryNotInstalledError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when `useForm` / `injectForm` is called outside of a
- * Vue `setup()` function — typically from an event handler, watcher,
- * or async callback that runs after mount.
- *
- * Fix: move the call into `setup()`, or trigger it from a child
- * component whose `setup()` runs the composable.
- */
-declare class OutsideSetupError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when a `useForm({ key })` call uses a key starting with
- * `__atta:`. That prefix is reserved for keys the library generates
- * internally (e.g. for anonymous `useForm()` calls without an
- * explicit key). Pick a different prefix for your form.
- */
-declare class ReservedFormKeyError extends AttaformError {
-    constructor(key: string);
-}
-
-export { AttaformError as A, InvalidPathError as I, OutsideSetupError as O, RegistryNotInstalledError as R, SubmitErrorHandlerError as S, InvalidUseFormConfigError as a, ReservedFormKeyError as b };

package/dist/shared/attaform.CO0e7YVY.d.ts

@@ -1,94 +0,0 @@
-/**
- * Typed error classes thrown by the form library. Each one signals a
- * distinct misuse so calling code can branch on `instanceof` instead
- * of pattern-matching error messages.
- *
- * Every class extends `AttaformError`, so consumers can write a single
- * polymorphic catch (`catch (e) { if (e instanceof AttaformError) ... }`)
- * instead of OR-chaining checks for each subclass. `AttaformError` itself
- * extends the standard `Error`, so existing `instanceof Error` usage
- * keeps working.
- */
-/**
- * Base for every error class thrown by `attaform`. Sets
- * `this.name` from the constructor's `new.target.name`, so subclasses
- * don't have to redeclare their own name override.
- */
-declare class AttaformError extends Error {
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Thrown when a path string is malformed — typically a dotted path
- * with empty segments (e.g. `'a..b'`, leading or trailing dots).
- * Use array form (`['a', 'b']`) for keys that contain literal dots.
- */
-declare class InvalidPathError extends AttaformError {
-}
-/**
- * Thrown when `useForm` receives an invalid configuration — most often
- * a schema passed directly as the first argument, or no argument at
- * all. The configuration is an options bag; the schema is one of
- * several fields, even when it's the only one in use.
- *
- * ```ts
- * // ✗ Crashes deep inside the validator with an opaque message:
- * const form = useForm(z.object({ ... }))
- * // ✗ Same:
- * const form = useForm()
- * // ✓ Pass the schema as the `schema` field:
- * const form = useForm({ schema: z.object({ ... }) })
- * ```
- *
- * The same shape applies to every entry point: `attaform/zod`,
- * `attaform/zod-v3`, `attaform/zod-v4`, and the schema-agnostic
- * `attaform` root.
- */
-declare class InvalidUseFormConfigError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when a `handleSubmit`-supplied `onError` callback itself
- * throws or rejects. Wraps the inner failure so both the original
- * cause (via `error.cause`) and the propagation site are visible.
- */
-declare class SubmitErrorHandlerError extends AttaformError {
-}
-/**
- * Thrown when an `attaform` API needs the registry attached to a Vue
- * app but it isn't there yet. Component-level entry points (`useForm`,
- * `injectForm`, `useRegister`) lazy-install the registry on first use,
- * so this error is mostly reached by SSR helpers — `renderAttaformState`
- * and `hydrateAttaformState` — which run outside a setup context and
- * have no current instance to install against.
- *
- * Fix: add `app.use(createAttaform())` (or `app.use(createAttaform({
- * ssr: true }))` on the server) to your SSR entry, before
- * `renderToString` / hydration. Under Nuxt, `attaform/nuxt` already
- * does this; the error usually points at a non-Nuxt SSR setup that
- * hasn't installed explicitly.
- */
-declare class RegistryNotInstalledError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when `useForm` / `injectForm` is called outside of a
- * Vue `setup()` function — typically from an event handler, watcher,
- * or async callback that runs after mount.
- *
- * Fix: move the call into `setup()`, or trigger it from a child
- * component whose `setup()` runs the composable.
- */
-declare class OutsideSetupError extends AttaformError {
-    constructor();
-}
-/**
- * Thrown when a `useForm({ key })` call uses a key starting with
- * `__atta:`. That prefix is reserved for keys the library generates
- * internally (e.g. for anonymous `useForm()` calls without an
- * explicit key). Pick a different prefix for your form.
- */
-declare class ReservedFormKeyError extends AttaformError {
-    constructor(key: string);
-}
-
-export { AttaformError as A, InvalidPathError as I, OutsideSetupError as O, RegistryNotInstalledError as R, SubmitErrorHandlerError as S, InvalidUseFormConfigError as a, ReservedFormKeyError as b };