form0-core 0.1.0 → 0.1.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 paqu.io
+Copyright (c) 2025-present paqu.io
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,28 +2,27 @@
 
 [![NPM Version](https://img.shields.io/npm/v/form0-core)](https://www.npmjs.com/package/form0-core)
 [![NPM Downloads](https://img.shields.io/npm/dt/form0-core)](https://www.npmjs.com/package/form0-core)
-[![License](https://img.shields.io/npm/l/form0-core)](LICENSE)
+![NPM License](https://img.shields.io/npm/l/form0-core)
 [![Docs](https://img.shields.io/badge/docs-docs.form0.dev-2563eb)](https://docs.form0.dev)
 [![Website](https://img.shields.io/badge/site-form0.dev-0f172a)](https://form0.dev)
+![NPM Last Update](https://img.shields.io/npm/last-update/form0-core)
 
 > [!WARNING]
 > form0 is in active, very early development. Do not use in production. Expect breaking
 > changes and unstable behavior.
 
-form0-core is the schema-driven engine that powers form0 ecosystem. It is framework-agnostic and runs in any JavaScript runtime (Node.js, browsers, React Native, etc.)
+form0-core is the schema-driven engine that powers [form0 open-source ecosystem](https://form0.dev). It is framework-agnostic and runs in any JavaScript runtime (Node.js, browsers, React Native, etc.)
 
 ## 🚀 Start with the CLI (recommended)
 
-The entry point for most users is form0-cli. Follow the quickstart to create a project and preview
-your schema:
-- https://docs.form0.dev/getting-started/quickstart
+The entry point for most users is [form0-cli](https://github.com/paqu-io/form0-cli). Follow the [quickstart](https://docs.form0.dev/getting-started/quickstart) to create a project and preview
+your schema.
 
 ## 🗂️ Documentation
 
-- Docs home: https://docs.form0.dev
-- form0-core overview: https://docs.form0.dev/core/overview
-- form0-core concepts: https://docs.form0.dev/core/concepts
-- Main site: https://form0.dev
+- Overview: https://docs.form0.dev/core/overview
+- Concepts: https://docs.form0.dev/core/concepts
+- Full docs: https://docs.form0.dev
 
 ## Direct usage (advanced)
 
@@ -36,3 +35,17 @@ npm install form0-core
 ## Security
 
 See `SECURITY.md` for security modes and configuration.
+
+## Requirements
+
+- Node.js 18+
+
+## Related repositories
+
+- [form0-cli](https://github.com/paqu-io/form0-cli) - Command-line interface
+- [form0-react](https://github.com/paqu-io/form0-react) - React components
+- [form0-react-native](https://github.com/paqu-io/form0-react-native) - React Native components
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit [issues](https://github.com/paqu-io/form0-core/issues) and [pull requests](https://github.com/paqu-io/form0-core/pulls).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "form0-core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
@@ -43,7 +43,7 @@
   "bugs": {
     "url": "https://github.com/paqu-io/form0-core/issues"
   },
-  "homepage": "https://form0.dev/",
+  "homepage": "https://form0.dev",
   "engines": {
     "node": ">=18.0.0"
   },

package/src/utilities/record-transformer.js

@@ -199,6 +199,12 @@ export function createStructuredRecord(state, fields = null, options = {}, id =
     sectionFields,
   } = buildRepeatableMetadata(elementsSource);
 
+  const hasStructuredRepeatableState =
+    state &&
+    Object.prototype.hasOwnProperty.call(state, 'repeatable') &&
+    state.repeatable &&
+    typeof state.repeatable === 'object';
+
   // Transform the values object using the preferred keys
   for (const [dataName, value] of Object.entries(state.values)) {
     // Skip flattened choice fields (created by form renderer for allow_other fields)
@@ -292,7 +298,9 @@ export function createStructuredRecord(state, fields = null, options = {}, id =
     const childIds = getNestedChildIds([...currentPath, pathKey]);
 
     // Structured RepeatableSection state supplied (new format)
-    if (Array.isArray(structuredInstances) && structuredInstances.length > 0) {
+    // Empty arrays are treated as explicit "no instances" and must not fall back
+    // to legacy flattened behavior, which can emit phantom records.
+    if (Array.isArray(structuredInstances)) {
       const recordCount = Math.max(structuredInstances.length, childIds.length);
       const childRecords = [];
 
@@ -360,16 +368,20 @@ export function createStructuredRecord(state, fields = null, options = {}, id =
         }
 
         for (const [, childRepInfo] of repInfo.children) {
-          const nestedInstances = instanceRepeatable[childRepInfo.preferredKey] || [];
+          const rawNestedInstances = Object.prototype.hasOwnProperty.call(
+            instanceRepeatable,
+            childRepInfo.preferredKey
+          )
+            ? instanceRepeatable[childRepInfo.preferredKey]
+            : [];
+          const nestedInstances = Array.isArray(rawNestedInstances) ? rawNestedInstances : [];
           const childRepeatableArray = processRepeatableSection(
             childRepInfo,
             [...currentPath, pathKey],
             nestedInstances
           );
-          if (childRepeatableArray.length > 0) {
-            const childOutputKey = resolveRepeatableOutputKey(childRepInfo);
-            childRecord.form_values[childOutputKey] = childRepeatableArray;
-          }
+          const childOutputKey = resolveRepeatableOutputKey(childRepInfo);
+          childRecord.form_values[childOutputKey] = childRepeatableArray;
         }
 
         if (hasMeaningfulRecord(childRecord)) {
@@ -501,14 +513,23 @@ export function createStructuredRecord(state, fields = null, options = {}, id =
   for (const [, repInfo] of repeatableSectionTree) {
     if (repInfo.parentPath.length === 0) {
       // This is a top-level RepeatableSection
-      const structuredInstances =
-        state.repeatable && state.repeatable[repInfo.preferredKey]
+      const rawStructuredInstances = hasStructuredRepeatableState
+        ? Object.prototype.hasOwnProperty.call(state.repeatable, repInfo.preferredKey)
           ? state.repeatable[repInfo.preferredKey]
-          : null;
+          : []
+        : null;
+      const structuredInstances = hasStructuredRepeatableState
+        ? Array.isArray(rawStructuredInstances)
+          ? rawStructuredInstances
+          : []
+        : null;
 
       const childRecords = processRepeatableSection(repInfo, [], structuredInstances);
-      if (childRecords.length > 0) {
-        const repeatableOutputKey = resolveRepeatableOutputKey(repInfo);
+      const repeatableOutputKey = resolveRepeatableOutputKey(repInfo);
+      if (hasStructuredRepeatableState) {
+        // In structured mode keep explicit repeatable keys, even when empty.
+        form_values[repeatableOutputKey] = childRecords;
+      } else if (childRecords.length > 0) {
         form_values[repeatableOutputKey] = childRecords;
       }
     }