{"_id":"@molecule/app-forms","_rev":"13-f941ee205b3a2fa578028a7c31c49f5f","name":"@molecule/app-forms","dist-tags":{"latest":"2.4.0"},"versions":{"1.0.0":{"name":"@molecule/app-forms","version":"1.0.0","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@1.0.0","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://github.com/molecule-dev/molecule/tree/main/packages/app/core/forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"be15a7c6af7ced9957d1a64a6cfc7193f14eda32","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-1.0.0.tgz","fileCount":26,"integrity":"sha512-HAtNomrKq0Irwz19LP1WasS19nVSg047T5WoIBfwHYEh8hMvtrViPOrMoQ/t9965jsy7Dd9CMY3NbC82LpHBaQ==","signatures":[{"sig":"MEYCIQCe8HMPdjd0RMlUFyw71G7JHww4g3xm2O3mFYiahljiPgIhAKMXddZ5TQ2TwVjSQdK5WOZ+tha1DBIQLEMkMyiGTfH5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63242},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"92623e72a527ca467963169420f4cf07533e4699","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"vialoh","email":"npm@vialoh.me"},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"11.12.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"25.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.10","typescript":"6.0.3","@types/node":"26.1.2","@molecule/app-bond":"1.0.0"},"peerDependencies":{"@molecule/app-bond":"^1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_1.0.0_1785796138427_0.7940809591653053","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@molecule/app-forms","version":"1.0.1","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@1.0.1","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://github.com/molecule-dev/molecule/tree/main/packages/app/core/forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"de8dd457c3a7140161b3fcbc44c4cdfb81fef0a5","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-1.0.1.tgz","fileCount":27,"integrity":"sha512-cQYTFSTpNQ1NraZntB98aCZBQf2XupMEf3d9PS558ssYi7rKt9/LPFNKhDTr1ZieBVufkc4ETaKJRmiDeCMdSQ==","signatures":[{"sig":"MEQCIByxC3Y2H8oNthztUtnSnS4Lw2S/baCZ8cqtg2zQYgx0AiBk0APJk1U0ir1lHBLr61XBabCRGJm+bxqB9P3YNrrckA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":77026},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"8621216fd4c8c9abe863e4e4f41efd2bc866fb09","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"vialoh","email":"npm@vialoh.me"},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.0.2","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.10","typescript":"6.0.3","@types/node":"26.1.2","@molecule/app-bond":"1.0.1"},"peerDependencies":{"@molecule/app-bond":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_1.0.1_1785820974445_0.6689527023278954","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@molecule/app-forms","version":"1.0.2","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@1.0.2","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"6f4e982b1bfbacf87ecb998f467ad7a343ca54c5","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-1.0.2.tgz","fileCount":27,"integrity":"sha512-MEJxbDoNFQmXboaif4dtuE3LRqzIbBtE/NHSDYd3QqJR0YSvqFWBwOq3S14LrmObUTIEzFUtSyBzHRq5ID8lUw==","signatures":[{"sig":"MEUCICswYAI2qR6Z69s0jn4sFq5IN7dBf7mEEHfzBp3tU4KKAiEArPtJN+jadaRzS2k2FifsApldx/l2DzjE6F0Fu3JcO4I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQD/pnedtDRg/KgPyng8P/BC5sOatenjxx2rru5nOAL7awIgO+T4BfY3Tfq9KUvVtEuRNaGAqoQk0Ns2n4QFnFGF5/Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":76995},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"41bbb7d6c46b04d052a6b333e1b18e76ed007d23","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.0.2","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.11","typescript":"6.0.3","@types/node":"26.1.2","@molecule/app-bond":"1.0.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_1.0.2_1789909286795_0.7207944708943113","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@molecule/app-forms","version":"1.0.3","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@1.0.3","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"bb7c4db5abd340335cfb13259217a71a5273c297","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-1.0.3.tgz","fileCount":27,"integrity":"sha512-fCVMs36EBExrZeakS+OrAsRI35mAF34mPSU9nGuKFWfI4830+ivmslsaicmg/7zYKMmKKWwBfHhUjoS0AeXHog==","signatures":[{"sig":"MEUCIQCpUuRiwwXfuepnvZZzsER412utpL4Xh/lJUlyw0UndnAIgUv/Qdi14t5q6yxJRyqGFGUdYD9rwnEmDJnteAOpJKgA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIHA9evMfei8pAXxf4jQg6MxRDPu7kPxCT2OUSBf7n/baAiEA03PPhl3BpRi1qq5AUrqWG7yBcZAeovwY1Chi6bXPWxk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":85058},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"59ea9891a9885fca0519097033520c74fb939ac5","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.1.2","@molecule/app-bond":"1.0.3"},"peerDependencies":{"@molecule/app-bond":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_1.0.3_1792658462764_0.4097260712493209","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@molecule/app-forms","version":"1.0.4","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@1.0.4","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"234f216f4b34790477b4c608f6c1f5dce9341c50","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-1.0.4.tgz","fileCount":27,"integrity":"sha512-8ttuyVcxFIscivGzP5+5Eh07c6LRQ9BIsitHpGuTrm+j/sweqMPQVED2cHoZ1v/MePFyPAD12cyBpqUem9Gohg==","signatures":[{"sig":"MEUCIBuGaGlfMkU6PxCTRHpsvhCsqyhZKB1bYrT4yJH3tzBLAiEAgvnhCXCDrVqd0qM6Ro0rvjFInxacbnbKctloz2Kikzk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIBbbwZNHmflkpNPPzg3q2jbBwmjX0rcUIaHxVESngZCJAiEA0hzmqHn/oms8dSxBkMVpja669yFRJYZoCjMO3UUDqAQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":85058},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f67ed64e3c4227d6b4f01be400011d4c8c2a75ce","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.3"},"peerDependencies":{"@molecule/app-bond":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_1.0.4_1792822501703_0.42665953093819153","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@molecule/app-forms","version":"1.0.5","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@1.0.5","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"5c7453c872d565b65438a5787aa43a1536013655","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-1.0.5.tgz","fileCount":27,"integrity":"sha512-PurApgzTq7wGJTEaFFjxdPMQYhI/O2lXxOfF1OSS58/S8uFh4dDzZR6mI00ynOqLEyaiE4rw3/fIyduuwGD+dg==","signatures":[{"sig":"MEUCIExgf5gjFYrgoKPkT7PMj7wDXk34tqGQZHEFr8VsNL7HAiEAr6sAEoUtsWWjTJXCCyqXLcROSnY7rOGej9SwTcUbCsc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCpWyRPCAHiaKf3IfWyKS6GGOeANoTkRgGCNgZgDSjt5AIhALye1rBbvrZZn/JwxPgrln5GUaPXvPrHSltmJ+7J0rmN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@1.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":85093},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"e65e3f174ceb27fda6175a5188a88349ff629919","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.4"},"peerDependencies":{"@molecule/app-bond":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_1.0.5_1793014010725_0.672209500513953","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@molecule/app-forms","version":"2.0.0","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@2.0.0","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"bde8ecda23e75462b1f76d84f3aea5253bf07f04","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.0.0.tgz","fileCount":27,"integrity":"sha512-SYIhuBJui/48myWjPnsDv+LCZh01rEI4SDjnsV4I1/7lqG/WtvWRpCCovuazVxmGtToMI0v+ftJS5bpsr5QFdA==","signatures":[{"sig":"MEUCIQD4CTe2yoEnvNeFOQTEu3UXMeZ+gBx6Yi8GbPxEiKybdAIgW0GWte1lgbHeSTo7+dWasYD2uR3NHfhewQNHtI4oCfU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCj1dtheS77LNwFt+fzYjqamJxNP524CfTx9gjsXRHQuwIgPnBPoLSRf1buzFbnKwBV/c50Jgxm3relgjLZp3NS5pw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":91432},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"e7a4b90b6ad70feba862d5abd2b682c95871bd84","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.4"},"peerDependencies":{"@molecule/app-bond":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_2.0.0_1793147350547_0.27312175891128676","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@molecule/app-forms","version":"2.1.0","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@2.1.0","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"1b68c46c442a5788d9fba427b97a175a1b3b2572","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.1.0.tgz","fileCount":27,"integrity":"sha512-rfYVwdyb22REbruN7480+8u2TU1L/8EbQx99k/P10Ijw6kYeI1V+VwBGR4Spli/0lJTpzvrQrCgwCaNRgBU+BQ==","signatures":[{"sig":"MEYCIQDHt3wryPbVGRa2Cj5igSH7iF0zTwtlOAbKMXgwiROZWQIhAKQR38k8MCamuRmv/iaAxaE3pxDaPaOzqBKgSCSoc0er","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDCZTK0Zr1xyRJCzAH1cN0AQ1PqH8NxruGFaELiP+QRngIhAMAx6cAJWzBYcjxVBFQlBpvo5tsXl1Yj/fDioA40hVJj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":95036},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"fe38ad3cabab8765e05981104fe0f30eb654a2b5","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.4","@molecule/app-i18n":"1.1.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1","@molecule/app-i18n":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_2.1.0_1793382044616_0.8459048919702804","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@molecule/app-forms","version":"2.1.1","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@2.1.1","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"9f2cf74e93187684c5dcfb7c4137d20943bd99b2","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.1.1.tgz","fileCount":27,"integrity":"sha512-09J2l5XU1IalBJIQV2uwVjv2Ci4oQlSWv6TedHyEXWmn38d4dUsno1hd+JtkhHHjcCNbsgx1ee+NyZUYjkDKsw==","signatures":[{"sig":"MEUCIAW0imI+IlSkJFCTuQb/pWDO+PT5xYbKqjvaE5KxeINmAiEAhnCm399UscuQLKPcPTRf7tE7Pdubh1jYjl+tBUeXid0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCID+MaMdyffBKCmYZspBFDI8iYX85XxqHRI9pviTIMpHJAiABfqRzAnJzaGVI37R41xc/90WVwuBFPv5aeaea/qc5OQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":95036},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"98b8af98054b43cbd70ac27761c8265b967d06bb","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.4","@molecule/app-i18n":"1.1.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1","@molecule/app-i18n":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_2.1.1_1793386718306_0.5364465201586986","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@molecule/app-forms","version":"2.2.0","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@2.2.0","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"133e854f632d50991a3e48e9f2d99ca6608a47bd","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.2.0.tgz","fileCount":31,"integrity":"sha512-kExPi0YtkC1+QL03gM99OgLpvOg6r6cw1ApDfE4cW6Rb/W+zu4ThDxoUu+gDcUEyHCZWkGM/nlvUCBt+Y3FsWQ==","signatures":[{"sig":"MEQCIDNqqi9EsU6iuHYk5bquifkdAmJsDQ7DDItVOHKKeBXhAiBRRXTo8kJGBEpTjMUdA+s88dFpdiHZr/Jr0v9bUCrZ/w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIFDZJQhS9lCwlJZ1ehG9YsQcIQJgR6HcQnXHZ3+irOQiAiBqsZNPV9mYyKwcugJDzXSfL2UYlB9pLLVAEWKb+HvNVQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":127594},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"06d8851e2240141d18c4a34068bdab52ccc3f519","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.1","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.5","@molecule/app-i18n":"1.1.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1","@molecule/app-i18n":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_2.2.0_1793530539257_0.016028035619242265","host":"s3://npm-registry-packages-npm-production"}},"2.3.0":{"name":"@molecule/app-forms","version":"2.3.0","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@2.3.0","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"cacc84938dd7b27e265826f66f6daa760e9ecdc5","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.3.0.tgz","fileCount":31,"integrity":"sha512-NlJyM7d3iGCngCJyCc/SCs0Flf6wWpwJs2rcHMKqjJMaqHqIkRqyk+z1dYGci9cFqFAkxRgbmdPkAxJyLhSHwg==","signatures":[{"sig":"MEUCIQDS9eitx20iD3l5uuhwGwRE0nyOxhDU9/t3eXOZ9T0P/gIgM8aLiWOZf50Avb+axMX+4osFGqwRk4lUlNY6p3QaIL4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIGFeRZDZeE1arBq5dE5RCMLJu3iJi8O799YCO1N0PSY3AiEAiO+TYy6zqUWeQ/iq9PsWjBRZ/L+2E44v5+igi/gQ/ZE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":130427},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1a07eff8383323252eac21964f452a6a88ceb8b3","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.2","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.5","@molecule/app-i18n":"1.1.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1","@molecule/app-i18n":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_2.3.0_1794537973349_0.9342169605047037","host":"s3://npm-registry-packages-npm-production"}},"2.3.1":{"name":"@molecule/app-forms","version":"2.3.1","keywords":["molecule","forms","validation"],"license":"Apache-2.0","_id":"@molecule/app-forms@2.3.1","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"homepage":"https://www.molecule.dev/packages/app-forms","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"392dc495c4b78457c1eedd40f5de7c70c78c11a8","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.3.1.tgz","fileCount":31,"integrity":"sha512-o9x/fO5s7g9dxh9FCTsn0Wz2h317OVzzRn8IgnRORJbPZdgx0eQGO4DXMTyiG63Se33qyvjRbZWhoSF+1/K6Ng==","signatures":[{"sig":"MEQCIBGuq/X3XJ3SNk547ychD/Qzxbk98XmRs1gRM5e9ZBeuAiAddJM7hN4oYd+sT0EPZSYiHKLf8rf2TRf94DnfyUBnzw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCnxOn+ecQ6EpKvES2E/R+ogCxoc9n+7zOqjLdo9/HYKQIgQrDoD4qgxxHZUu5loMdFOK80V2yRTcJyt+373sNpzN8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":136338},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"8dc37a5381ada3606d7127c9f8e3f2403edd23ca","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.2","description":"Form handling interface for molecule.dev","directories":{},"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.5","@molecule/app-i18n":"1.1.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1","@molecule/app-i18n":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/app-forms_2.3.1_1794541221600_0.9170481201671865","host":"s3://npm-registry-packages-npm-production"}},"2.4.0":{"_id":"@molecule/app-forms@2.4.0","bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"dist":{"shasum":"06ec3c81765832c6e1e84ae13ab9e00ad0c3a3f0","tarball":"https://registry.npmjs.org/@molecule/app-forms/-/app-forms-2.4.0.tgz","fileCount":31,"integrity":"sha512-zWnUKu5kz68LoTti1I+wGKyM5gAESyYWU6ej9/Uk7qjtiob09bbP07E1/Yr6CI0X4B02XjQhQ8lc97iVHnMZKg==","signatures":[{"sig":"MEQCIHh2i5+G9R+qhcu041QAMjaepSFOYt3weObYO1vjZ8qzAiBaePwhE0+D11R5stpT+c+6Qra05cmrl2e272+Li8W9PQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGR/n8AKN9EoVC0xbsBAzD+GXPn3Gq4SRHG2t50m9p6+AiEAzkTu3ch0MfjGIdirfMjVARtOq86gfxECO8wMcoeOq3k="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@molecule%2fapp-forms@2.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":145519},"main":"dist/index.js","name":"@molecule/app-forms","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"af1de5e5ec5bbb9bf51b4100a21273849cbb5674","license":"Apache-2.0","scripts":{"test":"vitest run","build":"tsc","test:watch":"vitest"},"version":"2.4.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"39cc2d83-98f9-4365-bf5e-943704980c2a"}},"homepage":"https://www.molecule.dev/packages/app-forms","keywords":["molecule","forms","validation"],"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"_npmVersion":"12.2.2","description":"Form handling interface for molecule.dev","directories":{},"maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"_nodeVersion":"22.23.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.12","typescript":"6.0.3","@types/node":"26.6.5","@molecule/app-bond":"1.0.5","@molecule/app-i18n":"1.2.2"},"peerDependencies":{"@molecule/app-bond":"^1.0.1","@molecule/app-i18n":"^1.1.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/app-forms_2.4.0_1794852095559_0.7461074126074051"}}},"time":{"created":"2026-08-03T22:28:58.271Z","modified":"2026-11-16T18:01:36.041Z","1.0.0":"2026-08-03T22:28:58.561Z","1.0.1":"2026-08-04T05:22:54.615Z","1.0.2":"2026-09-20T13:01:26.873Z","1.0.3":"2026-10-22T08:41:02.846Z","1.0.4":"2026-10-24T06:15:01.805Z","1.0.5":"2026-10-26T11:26:50.808Z","2.0.0":"2026-10-28T00:29:10.645Z","2.1.0":"2026-10-30T17:40:44.848Z","2.1.1":"2026-10-30T18:58:38.390Z","2.2.0":"2026-11-01T10:55:39.335Z","2.3.0":"2026-11-13T02:46:13.463Z","2.3.1":"2026-11-13T03:40:21.733Z","2.4.0":"2026-11-16T18:01:35.669Z"},"bugs":{"url":"https://github.com/molecule-dev/molecule/issues"},"license":"Apache-2.0","homepage":"https://www.molecule.dev/packages/app-forms","keywords":["molecule","forms","validation"],"repository":{"url":"git+https://github.com/molecule-dev/molecule.git","type":"git","directory":"packages/app/core/forms"},"description":"Form handling interface for molecule.dev","maintainers":[{"name":"vialoh","email":"npm@vialoh.me"}],"readme":"<!--\nAUTO-GENERATED — DO NOT EDIT THIS FILE.\nGenerated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.\nEdits here are overwritten on the next commit (molecule's pre-commit hook regenerates).\nTo change this document, edit the module-level JSDoc in src/index.ts.\nGenerated: 2026-11-16T11:26:02.636Z\n-->\n\n# @molecule/app-forms\n\nForm handling interface for molecule.dev.\n\nProvides a unified form management API that works across different\nform libraries (native, React Hook Form, Formik, etc.).\n\n> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.\n> It is written to be read by coding agents as much as by people, and is generated from this\n> package's source — edit `src/index.ts` JSDoc, not this file.\n\n## Quick Start\n\n```typescript\nimport { createForm } from '@molecule/app-forms'\n// (React apps: use `useForm` from `@molecule/app-react` — it takes these same\n// options and creates the controller through the bonded forms provider.)\n\nconst form = createForm<{ email: string; password: string }>({\n  defaultValues: { email: '', password: '' },\n  mode: 'onBlur',\n})\n\nconst email = form.register({\n  name: 'email',\n  required: t('forms.required', undefined, { defaultValue: 'This field is required' }),\n  email: true,\n})\n// Wire email.value / email.onChange / email.onBlur to your input element.\n\nconst onSubmit = form.handleSubmit(async (values) => {\n  await http.post('/signup', values) // relative path via the app HTTP client\n})\n// A rejected submit remains in form.getState().submitError and still rejects\n// for programmatic callers. In React, <Form onSubmit={handleSubmit(save)}>\n// from @molecule/app-ui-react renders the server error list automatically.\n```\n\n## Type\n\n`core`\n\n## Installation\n\n```bash\nnpm install @molecule/app-forms @molecule/app-bond @molecule/app-i18n\n```\n\n## API\n\n### Interfaces\n\n#### `ValidationRule`\n\nField validation rule.\n\n```typescript\ninterface ValidationRule {\n  /**\n   * Rule type.\n   */\n  type:\n    'required' | 'min' | 'max' | 'minLength' | 'maxLength' | 'pattern' | 'email' | 'url' | 'custom'\n\n  /**\n   * Rule value (for rules like min, max, pattern).\n   */\n  value?: unknown\n\n  /**\n   * Error message when validation fails.\n   */\n  message: string\n}\n```\n\n#### `ValidationSchema`\n\nField validation schema.\n\n```typescript\ninterface ValidationSchema {\n  /**\n   * Whether the field is required. A string turns the rule on and is its message; an empty\n   * string (an untranslated `t(...)`) still turns it on and shows the built-in message.\n   */\n  required?: boolean | string\n\n  /**\n   * Minimum value (for numbers).\n   */\n  min?: number | { value: number; message: string }\n\n  /**\n   * Maximum value (for numbers).\n   */\n  max?: number | { value: number; message: string }\n\n  /**\n   * Minimum length (for strings).\n   */\n  minLength?: number | { value: number; message: string }\n\n  /**\n   * Maximum length (for strings).\n   */\n  maxLength?: number | { value: number; message: string }\n\n  /**\n   * Pattern to match (regex).\n   */\n  pattern?: RegExp | { value: RegExp; message: string }\n\n  /**\n   * Validate as email. A string turns the rule on and is its message (empty: the built-in one).\n   */\n  email?: boolean | string\n\n  /**\n   * Validate as URL. A string turns the rule on and is its message (empty: the built-in one).\n   */\n  url?: boolean | string\n\n  /**\n   * Custom validation function. Return `true` to pass; `false` or any string fails, and a\n   * non-empty string is the message shown.\n   */\n  validate?: (value: unknown) => boolean | string | Promise<boolean | string>\n}\n```\n\n#### `FieldState`\n\nReactive state for a single form field (value, validation errors, touched/dirty flags).\n\n```typescript\ninterface FieldState<T = unknown> {\n  /**\n   * Current field value.\n   */\n  value: T\n\n  /**\n   * Error message (if any).\n   */\n  error?: string\n\n  /**\n   * Whether the field has been touched.\n   */\n  touched: boolean\n\n  /**\n   * Whether the field is dirty (value changed from initial).\n   */\n  dirty: boolean\n\n  /**\n   * Whether the field is valid.\n   */\n  valid: boolean\n\n  /**\n   * Whether the field is currently being validated: true while the latest\n   * validation that covers it (the field's own, the whole form's, or a\n   * submission's) is still running.\n   */\n  validating: boolean\n}\n```\n\n#### `FormState`\n\nAggregate state of an entire form (all field values, errors, and submission status).\n\n```typescript\ninterface FormState<T extends FormValuesConstraint<T> = Record<string, unknown>> {\n  /**\n   * Form values.\n   */\n  values: T\n\n  /**\n   * Field errors.\n   */\n  errors: Partial<Record<keyof T, string>>\n\n  /**\n   * Touched fields.\n   */\n  touched: Partial<Record<keyof T, boolean>>\n\n  /**\n   * Whether the form is valid.\n   */\n  isValid: boolean\n\n  /**\n   * Whether the form is dirty.\n   */\n  isDirty: boolean\n\n  /**\n   * Whether the form is submitting.\n   */\n  isSubmitting: boolean\n\n  /**\n   * The latest rejected submission, cleared by a new submit, reset or clearErrors.\n   * Kept separately from client field validation; use the framework Form to render it.\n   */\n  submitError?: unknown\n\n  /**\n   * Number of times the form has been submitted.\n   */\n  submitCount: number\n}\n```\n\n#### `RegisterOptions`\n\nField registration options.\n\n```typescript\ninterface RegisterOptions extends ValidationSchema {\n  /**\n   * Field name.\n   */\n  name: string\n\n  /**\n   * Default value.\n   */\n  defaultValue?: unknown\n\n  /**\n   * Value transformation on change.\n   */\n  transform?: (value: unknown) => unknown\n\n  /**\n   * Dependencies for validation.\n   */\n  deps?: string[]\n}\n```\n\n#### `FieldRegistration`\n\nField registration result (for native inputs).\n\n```typescript\ninterface FieldRegistration {\n  /**\n   * Field name.\n   */\n  name: string\n\n  /**\n   * Field value.\n   */\n  value: unknown\n\n  /**\n   * Change handler.\n   */\n  onChange: (event: { target: { value: unknown; name: string } } | unknown) => void\n\n  /**\n   * Blur handler.\n   */\n  onBlur: () => void\n\n  /**\n   * Reference setter (for DOM elements).\n   */\n  ref?: (element: HTMLElement | null) => void\n}\n```\n\n#### `FormController`\n\nForm controller interface.\n\nAll form providers must implement this interface.\n\n```typescript\ninterface FormController<T extends FormValuesConstraint<T> = Record<string, unknown>> {\n  /**\n   * Gets the current form state.\n   */\n  getState(): FormState<T>\n\n  /**\n   * Gets the value of a specific field.\n   */\n  getValue(name: string): unknown\n  getValue<K extends keyof T>(name: K): T[K]\n\n  /**\n   * Gets all form values.\n   */\n  getValues(): T\n\n  /**\n   * Sets the value of a specific field.\n   */\n  setValue(\n    name: string,\n    value: unknown,\n    options?: { shouldValidate?: boolean; shouldDirty?: boolean; shouldTouch?: boolean },\n  ): void\n\n  /**\n   * Sets multiple values at once.\n   */\n  setValues(values: Partial<T>, options?: { shouldValidate?: boolean }): void\n\n  /**\n   * Gets the error for a specific field.\n   */\n  getError(name: string): string | undefined\n\n  /**\n   * Sets the error for a specific field.\n   */\n  setError(name: string, error: string | undefined): void\n\n  /**\n   * Clears the error for a specific field.\n   */\n  clearError<K extends keyof T>(name: K): void\n\n  /**\n   * Clears all errors.\n   */\n  clearErrors(): void\n\n  /**\n   * Gets the field state for a specific field.\n   */\n  getFieldState<K extends keyof T>(name: K): FieldState<T[K]>\n\n  /**\n   * Registers a field for form management. A `defaultValue` that fills an\n   * empty field is announced to subscribers once, in a microtask, so a field\n   * registered during a render does not update other components mid-render.\n   */\n  register(nameOrOptions: string | RegisterOptions, options?: RegisterOptions): FieldRegistration\n\n  /**\n   * Unregisters a field.\n   */\n  unregister(name: string): void\n\n  /**\n   * Validates a specific field.\n   */\n  validateField<K extends keyof T>(name: K): Promise<boolean>\n\n  /**\n   * Validates all fields.\n   */\n  validate(): Promise<boolean>\n\n  /**\n   * Resets the form and clears errors, touched fields and submission state.\n   *\n   * With no argument it restores the current baseline — the initial\n   * `defaultValues`, or the values a previous `reset(values)` established.\n   * Passing `values` merges them over the current baseline and makes the\n   * result the new baseline, so a form reset to freshly loaded or saved data\n   * reads clean (`isDirty === false`). A changed non-null `id` replaces the\n   * record and cancels a pending submit.\n   */\n  reset(values?: Partial<T>): void\n\n  /**\n   * Applies externally loaded values without clearing submission state.\n   *\n   * The new clean baseline is the original `defaultValues` plus this latest\n   * record, never a merge of earlier records. With `keepDirtyValues`, edited\n   * fields retain their values while pristine fields take the loaded values.\n   * A changed non-null `id` still replaces the record and cancels a pending\n   * submit. Equal-content baselines cause no update. `keepOmittedValues` opts\n   * into incremental top-level field fills using the current clean baseline.\n   */\n  updateValues(values: Partial<T>, resetOptions?: FormUpdateOptions): void\n\n  /**\n   * Handles form submission.\n   */\n  handleSubmit(\n    onSubmit: (values: T) => void | Promise<void>,\n    onError?: (errors: Partial<Record<keyof T, string>>) => void,\n  ): (event?: { preventDefault?: () => void }) => Promise<void>\n\n  /**\n   * Sets focus to a field.\n   */\n  setFocus(name: keyof T): void\n\n  /**\n   * Subscribes to form state changes.\n   */\n  subscribe(callback: (state: FormState<T>) => void): () => void\n\n  /**\n   * Destroys the form controller.\n   */\n  destroy(): void\n}\n```\n\n#### `FormProvider`\n\nForm provider interface.\n\nImplementations create form controllers.\n\n```typescript\ninterface FormProvider {\n  /**\n   * Creates a new form controller.\n   */\n  createForm<T extends FormValuesConstraint<T>>(options: FormOptions<T>): FormController<T>\n}\n```\n\n#### `FormResetOptions`\n\nOptions controlling how externally supplied values replace a form's baseline.\n\n```typescript\ninterface FormResetOptions {\n  /**\n   * Keep fields whose current value differs from their baseline when `values`\n   * changes. Pristine fields still take the new values. False by default, so a\n   * new record can replace edits from the previous record.\n   */\n  keepDirtyValues?: boolean\n}\n```\n\n#### `FormUpdateOptions`\n\nOptions for applying a loaded record or incrementally loaded fields.\n\n```typescript\ninterface FormUpdateOptions extends FormResetOptions {\n  /**\n   * Preserve the current clean baseline for omitted top-level fields. Used for\n   * independent field fills; false by default for whole-record replacements.\n   * A changed non-null record id always starts from the original defaults.\n   */\n  keepOmittedValues?: boolean\n}\n```\n\n#### `FormOptions`\n\nForm creation options.\n\n```typescript\ninterface FormOptions<T extends FormValuesConstraint<T>> {\n  /**\n   * Default values, captured as the form's clean baseline when the controller\n   * is created. Mutating this object afterwards does not change the baseline.\n   */\n  defaultValues?: Partial<T>\n\n  /**\n   * Externally loaded values, merged over `defaultValues` as the clean\n   * baseline. Framework bindings also apply later content changes; use\n   * `resetOptions.keepDirtyValues` to preserve edits while pristine fields fill.\n   */\n  values?: Partial<T>\n\n  /** Controls how framework bindings apply changed `values`. */\n  resetOptions?: FormResetOptions\n\n  /**\n   * Validation mode.\n   */\n  mode?: 'onSubmit' | 'onChange' | 'onBlur' | 'all'\n\n  /**\n   * Revalidation mode.\n   */\n  reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit'\n\n  /**\n   * Whether to focus the first error field on submit.\n   */\n  shouldFocusError?: boolean\n\n  /**\n   * Form-level validation function.\n   */\n  validate?: (\n    values: T,\n  ) => Partial<Record<keyof T, string>> | Promise<Partial<Record<keyof T, string>>>\n}\n```\n\n### Types\n\n#### `FormValuesConstraint`\n\nThe constraint every form entrypoint puts on a values type: an object type of\nnamed fields ({@link FormValuesShape}), and `object` for `any`.\n\nIt exists so an app can name its form fields once, as an ordinary interface,\nand pass that type whole — `interface Fields { name: string; bio: string }`\ncompiles the same as the type literal it replaces, while a primitive, an\narray, a function and a `Date` are still rejected, and `keyof T` still types\nregister/get/set per field.\n\n```typescript\nimport type { FormOptions } from '@molecule/app-forms'\n\ninterface Fields {\n  name: string\n  bio: string\n}\nconst options: FormOptions<Fields> = { defaultValues: { name: '', bio: '' } }\n```\n\nForwarding a values type through your own generic copies this constraint, so\nthe values keep being checked:\n\n```typescript\nimport type { FormOptions, FormValuesConstraint } from '@molecule/app-forms'\n\nexport function makeOptions<T extends FormValuesConstraint<T>>(o: FormOptions<T>) {\n  return o\n}\n```\n\n`T extends object` is not enough: the entrypoints also reject arrays,\nfunctions and `Date`, so a forwarder written that way does not compile. Copy\nthis type instead.\n\n```typescript\ntype FormValuesConstraint<T> = FormValuesIsRejected<T> extends true ? FormValuesRejection : object\n```\n\n### Functions\n\n#### `createNativeFormProvider()`\n\nCreates a native form provider that manages form state, validation,\nand field registration without any external library. This is the\nbuilt-in default used when no form library bond is configured.\n\nDefault validation messages are translated through `@molecule/app-i18n`'s `t` when they\nare produced, so they follow the bonded locale.\n\n```typescript\nfunction createNativeFormProvider(): FormProvider\n```\n\n**Returns:** A `FormProvider` backed by vanilla JavaScript state management.\n\n#### `setProvider(provider)`\n\nRegisters a form provider as the active singleton.\n\n```typescript\nfunction setProvider(provider: FormProvider): void\n```\n\n- `provider` — The form provider implementation to bond.\n\n#### `getProvider()`\n\nRetrieves the bonded form provider. If none is bonded, automatically\ncreates and bonds the built-in native form provider.\n\n```typescript\nfunction getProvider(): FormProvider\n```\n\n**Returns:** The active form provider.\n\n#### `hasProvider()`\n\nChecks whether a form provider has been explicitly bonded.\n\n```typescript\nfunction hasProvider(): boolean\n```\n\n**Returns:** `true` if a form provider is bonded.\n\n#### `createForm(options)`\n\nCreates a new form controller for the given options using the active\nform provider. The controller manages field values, validation, dirty\ntracking, and submission.\n\n```typescript\nfunction createForm<T extends FormValuesConstraint<T>>(options: FormOptions<T>): FormController<T>\n```\n\n- `options` — Form configuration including initial values, validation rules, and submit handler.\n\n**Returns:** A form controller instance for managing the form lifecycle.\n\n#### `snapshotFormValue(value)`\n\nDetach content-comparable form values recursively. Arrays retain holes, plain\nobjects and dates are copied, and opaque objects retain their identity just as\nthey do for `formValuesEqual`.\n\n```typescript\nfunction snapshotFormValue<T>(value: T): T\n```\n\n#### `formValuesEqual(left, right)`\n\nCompare form values recursively by content only for arrays, plain objects and\ndates. Other objects (including files, blobs, maps and class instances) use\nidentity, so two distinct opaque values are never treated as interchangeable.\n\n```typescript\nfunction formValuesEqual(left: unknown, right: unknown): boolean\n```\n\n#### `validateValue(value, schema, t)`\n\nValidates a value against a validation schema.\n\nWhen a translation function `t` is provided, default validation messages\nwill be passed through it for i18n support.\n\n```typescript\nfunction validateValue(\n  value: unknown,\n  schema: ValidationSchema,\n  t?: TranslateFn,\n): Promise<string | undefined>\n```\n\n- `value` — The value to validate (string, number, array, or any type accepted by custom validators).\n- `schema` — The validation rules to check against (required, min/max, pattern, email, etc.).\n- `t` — Optional i18n translation function for localizing error messages.\n\n**Returns:** The first validation error message, or `undefined` if the value passes all checks.\n\n### Constants\n\n#### `nativeProvider`\n\nPre-instantiated native form provider, ready to use without calling `createNativeFormProvider()`.\n\n```typescript\nconst nativeProvider: FormProvider\n```\n\n## Injection Notes\n\n### Requirements\n\nPeer dependencies:\n\n- `@molecule/app-bond` ^1.0.1\n- `@molecule/app-i18n` ^1.1.2\n\n### Runtime Dependencies\n\n- `@molecule/app-bond`\n- `@molecule/app-i18n`\n\nBuild forms with {@link createForm} (or the framework hook), not a direct react-hook-form /\nformik import — that couples you to one library and breaks the swap.\n\n- For independent loaded fields, call `updateValues({ email }, { keepDirtyValues: true,\nkeepOmittedValues: true })`. Omitted fields retain their latest clean baseline,\n  and edited values remain dirty. Framework `asState(field)` fill setters do this\n  automatically. Whole-form fills and ordinary `updateValues` replace the record\n  from its original defaults, so fields omitted by a new record cannot leak.\n- **Client validation is UX, NOT a security boundary.** {@link validateValue} / client rules\n  give instant feedback, but the SERVER must re-validate every field it receives — a request\n  can skip the form entirely (curl, a tampered client). Never trust a value because the\n  client \"validated\" it, and never enforce authorization in the form.\n- The built-in rules' default messages (`required: true`, `email: true`, …) go through the\n  bonded i18n provider's `t` under `forms.*` keys, so bond `@molecule/app-locales-forms` to\n  show them in the active locale. A rule's own message string is shown as written.\n- Keep secrets out of any form state you persist (see `@molecule/app-storage`), and submit\n  through the HTTP client (`@molecule/app-http`) with a relative path — never a hardcoded URL.\n\n## E2E Tests\n\nIntegration checklist — drive the real UI (live preview, no mocks), adapt\neach item to this app's actual screens/flows, and check every box off one\nby one. A box you can't check is an integration bug to fix — not a skip:\n\n- [ ] Typing into each field updates its displayed value — interact_preview\n      into the field's data-mol-id, then read_preview_ui shows the new value in\n      the input (no stuck/blank input, no lag behind what you typed).\n- [ ] Submitting with a required field empty, a malformed email, or an\n      out-of-range number BLOCKS submit and shows that field's own error message\n      beside it — the handler does not run (no navigation, success state, or POST).\n- [ ] Fixing the offending field clears its error, and once every field is\n      valid the same submit succeeds — a valid submit passes the correct current\n      values (confirm the request/next screen carries what you typed, not stale\n      or blank data).\n- [ ] Errors appear at the configured time, not before: with mode onBlur or\n      onSubmit a pristine, untouched field shows NO error on first render — the\n      error only surfaces after you blur/touch it or attempt submit. No field\n      screams before the user has interacted.\n- [ ] Cross-field / form-level rules fire (e.g. a confirm-password mismatch\n      via the form-level validate) and block submit until satisfied, showing the\n      message on the right field.\n- [ ] If the form does async validation (e.g. a username-taken check), submit\n      waits for it to resolve before running the handler, any pending/validating\n      indicator shows while it is in flight, and an async failure blocks submit\n      with its message.\n- [ ] Resetting the form restores the initial default values in the inputs and\n      clears every error and touched state — a previously-shown error is gone and\n      the submit control returns to its initial enabled/disabled state.\n- [ ] Dirty/touched tracking is observable: an unchanged form reads as pristine\n      (no \"unsaved changes\" affordance; save disabled if the app gates on dirty),\n      editing a field flips it to dirty, and an invalid submit focuses the first\n      error field.\n\n## Translations\n\nTranslation strings are provided by `@molecule/app-locales-forms`.\n","readmeFilename":"README.md"}