Entrypoints & subpaths

Tree-shakeable imports for @jayoncode/form-intelligence. Prefer the narrowest entry that exports what you need.

Previous: Capabilities · Next: Validation

Playground

Sandbox — explore features live; import paths below apply in app code.

Quick rule

Need	Import from
createForm, when, validators, most instance APIs	@jayoncode/form-intelligence (main)
Phone/currency masks, formatSlug, trim, composeFormatters	@jayoncode/form-intelligence/format
DevTools inspector	@jayoncode/form-intelligence/devtools
Derived UI projection (showError, canSubmit, status, …)	@jayoncode/form-intelligence/ui
CAPTCHA Security Stage (captcha, providers)	@jayoncode/form-intelligence/captcha
Browser-lifecycle / keyboard plugins	@jayoncode/form-intelligence/plugins
Error helpers (toNormalizedErrors, …)	@jayoncode/form-intelligence/validation

Main-entry phone / currency are validators (phone(), currency(opts?) — “is this valid?”).
Formatter masks use a format* prefix on /format only (formatPhone, formatCurrency, … — “mask while typing”).
trim stays trim. See Formatters and Validation.

Subpath map

Import	Use for	Also on main?
@jayoncode/form-intelligence	createForm, when, validators, calculate, dependencies, transform/presentation/middleware helpers, createFormController, computeFieldAria	—
…/validation	Pipeline helpers, mergeValidatorsByKind, matchesField, requiredWhen, re-exported validators — Validation (HTML constraints attach via core DOM, not a subpath)	Validators yes; helpers prefer this path
…/format	Formatters / parsers (formatPhone, formatSlug, formatCreditCard, …), advanced (formatForDisplay, FormatterRegistry)	No (validators like phone() stay on main)
…/rules	when, evaluateFormRules, runDependencyRules, runCalculations, rule types	when also on main; prefer form rules for apps — Rules → evaluateFormRules
…/workflow	Low-level autosave/draft/wizard internals	Prefer createForm({ workflow })
…/draft	Draft storage primitives, createIndexedDbDraftStorage — Workflow → IndexedDB drafts	Prefer workflow.draft
…/wizard	Wizard graph helpers (getStepGraph, listVisibleStepIds, …) — Workflow → wizard graph helpers	Prefer workflow.wizard
…/submission	Submit orchestrator / offline queue classes, evaluateSubmissionGuard, Security Stage API — Submission	Prefer form.submit() + workflow.offlineQueue
…/offline	Offline module service	Prefer workflow config
…/history	History stack primitives	Prefer form.undo() / form.redo()
…/state	Store / selectors (selectValues, selectFieldValue, …) — State → selectors	Prefer form.state
…/fields	Field registry / array helpers (pushArrayItem, removeArrayItem, …) — State → array field helpers	Prefer form.field() / form.pushField()
…/plugins	createBrowserLifecyclePlugin, createKeyboardPlugin, pluginAsModule, …	Plugins: this path
…/devtools	enableFormDevTools, getFormDevTools	DevTools: this path only
…/ui	Derived UI projection: ui(), createUiProjection, showError, canSubmit, status, explain() — UI projection → free helpers	Projection: this path
…/captcha	CAPTCHA Security Stage: captcha(), turnstile(), recaptcha(), hcaptcha(), mockCaptcha()	CAPTCHA: this path only
…/analytics	FormAnalyticsTracker, createAnalyticsPlugin — Integrations → analytics module API	Prefer workflow.analytics
…/adapters	Adapter types, createFormController	Controller also on main
…/dependency	Dependency engine, detectDependencyCycles	dependencies also on main
…/transform	Inbound transform pipeline helpers (createTransformPipeline, runTransformInbound, TRANSFORM_INBOUND_ORDER)	Also on main
…/presentation	Field UI / presentation helpers	Also on main
…/middleware	Middleware pipeline / stages (composeMiddleware, runMiddlewareChain, MiddlewarePipeline)	Also on main / plugins
…/accessibility	computeFieldAria	Also on main

Instance API vs low-level import

Most apps only need:

import { createForm, when, required, email } from "@jayoncode/form-intelligence";

Use subpaths when you want an explicit dependency, a slimmer entry, or symbols that are not on main (formatters, DevTools, lifecycle plugins).

Related

• Formatters — format vs transform
• Integrations — plugins + DevTools
• Performance — budgets and tree-shaking
• API (TypeDoc)