@remoteoss/remote-json-schema-form-kit 0.0.10

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+#### 0.0.10 (2026-03-19)
+
+#### New features
+
+- bump `@remoteoss/json-schema-form` to 1.2.11
+
+#### 0.0.9 (2026-03-10)
+
+#### Bug fixes
+
+- Fixes `modify` calls not working correctly with `nextVersion` option
+
+#### 0.0.8 (2026-03-09)
+
+#### New features
+
+- Adds new `date_difference_in_weeks` json-logic operator
+- Adds `dateWithoutTimezoneOffset` util and all date related json-logic operators now use it. This guarantees that server-side validations match client side validations by removing timezone offsets from dates
+- Adds tests
+
+#### 0.0.7 (2026-02-19)
+
+#### New features
+
+- Add `date_format` json-logic operator [5449a70cf09132b02ba63ff5cf872e2fb993de20](https://github.com/remoteoss/remote-json-schema-form-kit/commit/5449a70cf09132b02ba63ff5cf872e2fb993de20)
+
+#### 0.0.6 (2026-02-12)
+
+#### New features
+
+- Add `date_add_months` json-logic operator [3f16cc2d8aa28578c75f0bcd2661f1f3eae12ab1](https://github.com/remoteoss/remote-json-schema-form-kit/commit/3f16cc2d8aa28578c75f0bcd2661f1f3eae12ab1)
+
+#### 0.0.5 (2026-01-21)
+
+#### New features
+
+- Export `ModifyConfig`, `ValidationResult` and `FormErrors` types [44a70c3cdb9f6ca4d2f6bcffe99d345d70bab2eb](https://github.com/remoteoss/remote-json-schema-form-kit/commit/44a70c3cdb9f6ca4d2f6bcffe99d345d70bab2eb)
+
+#### 0.0.4 (2026-01-20)
+
+#### New features
+
+- bump `@remoteoss/json-schema-form` to 1.2.9 [15d767a57589d82c8f2fb80df9324e0827ea6acf](https://github.com/remoteoss/remote-json-schema-form-kit/commit/5683e829f4c6acb7ab04b21d2fd49c89f5a18c2c)
+
+#### 0.0.3
+
+#### New features
+
+- bump `@remoteoss/json-schema-form` to 1.2.8 [b8ba9bf8b9ae8ad5d9d81ce1f8160d5cba3e1f5c](https://github.com/remoteoss/remote-json-schema-form-kit/commit/b8ba9bf8b9ae8ad5d9d81ce1f8160d5cba3e1f5c)
+
+#### 0.0.2 (2025-11-21)
+
+#### New features
+
+- Add types definition ([5683e829f4c6acb7ab04b21d2fd49c89f5a18c2c](https://github.com/remoteoss/remote-json-schema-form-kit/commit/5683e829f4c6acb7ab04b21d2fd49c89f5a18c2c))
+
+#### 0.0.1 (2025-11-14)
+
+##### New features
+
+- release package ([98b069a1285ac5c809aac5747cf5de34b426be62](https://github.com/remoteoss/remote-json-schema-form-kit/commit/98b069a1285ac5c809aac5747cf5de34b426be62))

package/README.md

@@ -0,0 +1,56 @@
+# remote-json-schema-form-kit
+
+Remote's wrapper around [`@remoteoss/json-schema-form`](https://github.com/remoteoss/json-schema-form) (JSF) with added JSON logic operators.
+
+This package exposes the two JSF versions v0 (legacy) and v1 (new).
+
+## Installation
+
+```bash
+npm install @remoteoss/remote-json-schema-form-kit
+```
+
+## Usage
+
+```ts
+import { createHeadlessForm, modify } from '@remoteoss/remote-json-schema-form-kit';
+```
+
+## How version routing works
+
+This package exposes the two JSF versions we use:
+
+- **v0 (legacy)** — `@remoteoss/json-schema-form@0.x`
+- **v1** — `@remoteoss/json-schema-form@1.x`
+
+When you call `createHeadlessForm(schema, options)` or `modify(schema, options)`, the kit checks:
+
+1. `schema["x-rmt-meta"].jsfVersion === "1"` (schema-level marker set when consuming schemas via API)
+2. `options.nextVersion === true` (explicit caller override)
+
+If either condition is true, the call is forwarded to the **v1** implementation. Otherwise it falls back to the **v0** implementation.
+
+**For v1**, the kit also injects:
+
+- **Custom JSON Logic operators** via `customJsonLogicOps`
+- **Legacy compatibility options** (`treatNullAsUndefined`, `allowForbiddenValues`)
+
+**⚠️** In the next major version of this kit, the default JSF will be `v1`, unless callers opt out explicitly.
+
+### TypeScript types (v0 vs v1)
+
+The kit already disambiguates some overlapping concepts. All types are v1 by default. Some types for `v0` has a `*Legacy` suffix, for example `ModifyConfigLegacy`, `FieldLegacy`, etc.
+
+## CONTRIBUTING
+
+This project was previously [in Github](https://github.com/remoteoss/remote-json-schema-form-kit), but it has moved to our internal private monorepo to improve the DX when updating JSF. We might consider doing a new mirror on Github for transparency. If you need it, let us know!
+
+### Adding a new custom JSON Logic operator
+
+1. Create a new file in `src/json-logic-operators/` and write tests (follow the existing pattern, e.g. `dateAddDays.ts`)
+2. Export it from `src/json-logic-operators/index.ts` in the `operators` object
+3. The key in the `operators` object is the operator name used in JSON Schemas (e.g. `date_add_days`)
+
+### Deploy
+
+Read [README_internal.md](./README_internal.md) for more info.

package/dist/dateUtils.d.ts

@@ -0,0 +1,11 @@
+export declare function parseISODate(date: unknown): Date;
+/**
+ * Formats a local-noon Date (as produced by parseISODate + date-fns arithmetic)
+ * back to a "YYYY-MM-DD" string using local calendar parts.
+ *
+ * Uses getFullYear/getMonth/getDate (local getters) rather than date-fns format
+ * to avoid pulling in an extra dependency for a trivial operation and to make the
+ * local-noon ↔ local-getter pairing explicit.
+ */
+export declare function formatISODate(date: Date): string;
+//# sourceMappingURL=dateUtils.d.ts.map

package/dist/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.d.ts","sourceRoot":"","sources":["../src/dateUtils.ts"],"names":[],"mappings":"AA8FA,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAUhD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKhD"}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { createHeadlessForm as createHeadlessFormNext, modify as modifyNext } from '@remoteoss/json-schema-form';
+import { type Field as FieldNext, type CreateHeadlessFormOptions, type FormErrors as FormErrorsNext } from '@remoteoss/json-schema-form';
+import { createHeadlessForm as createHeadlessFormV0, modify as modifyV0 } from '@remoteoss/json-schema-form-v0-deprecated';
+export { buildCompleteYupSchema, pickXKey } from '@remoteoss/json-schema-form-v0-deprecated';
+/**
+ * Re-exported from v0 today. When `@remoteoss/json-schema-form` (v1) publishes the same names
+ * (`Fields`, `FieldAttrs`, `JSONSchemaObjectType`, `HeadlessFormOutput`, …), there will be a name clash.
+ * We'll rename v0 types with `*Legacy` aliases, eg FieldsLegacy. We already do that with ModifyConfigLegacy.
+ */
+export type { Fields, FieldAttrs, JSONSchemaObjectType, HeadlessFormOutput, } from '@remoteoss/json-schema-form-v0-deprecated';
+type FormSchemaNext = Parameters<typeof createHeadlessFormNext>[0];
+type FormSchemaLegacy = Parameters<typeof createHeadlessFormV0>[0];
+type FormSchema = FormSchemaNext | FormSchemaLegacy;
+type FormResultNext = ReturnType<typeof createHeadlessFormNext>;
+type FormResultLegacy = ReturnType<typeof createHeadlessFormV0>;
+type FormResultForVersion<TNextVersion extends boolean> = TNextVersion extends true ? FormResultNext : FormResultLegacy;
+type ModifyResultNext = ReturnType<typeof modifyNext>;
+type ModifyResultLegacy = ReturnType<typeof modifyV0>;
+type ModifyResultForVersion<TNextVersion extends boolean> = TNextVersion extends true ? ModifyResultNext : ModifyResultLegacy;
+export type ModifyConfig = Parameters<typeof modifyNext>[1];
+export type ModifyConfigLegacy = Parameters<typeof modifyV0>[1];
+type ModifyConfigForVersion<TNextVersion extends boolean> = TNextVersion extends true ? ModifyConfig & {
+    nextVersion?: TNextVersion;
+} : ModifyConfigLegacy & {
+    nextVersion?: TNextVersion;
+};
+export type FormErrors = FormErrorsNext;
+export type FormErrorsLegacy = ReturnType<typeof createHeadlessFormV0>['handleValidation'];
+export type Field = FieldNext;
+export type FieldLegacy = FormResultLegacy['fields'];
+export type { CreateHeadlessFormOptions } from '@remoteoss/json-schema-form';
+/**
+ * Wrapper around @remoteoss/json-schema-form that does 2 things:
+ * - Decides to load v0 or v1 of JSF.
+ * - Includes addon for json-logic operators
+ */
+export declare function createHeadlessForm<TNextVersion extends boolean = false>(formSchema: FormSchema, jsfOptions?: CreateHeadlessFormOptions & {
+    nextVersion?: TNextVersion;
+}): FormResultForVersion<TNextVersion>;
+export declare function modify<TNextVersion extends boolean = false>(formSchema: FormSchema, options?: ModifyConfigForVersion<TNextVersion>): ModifyResultForVersion<TNextVersion>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,IAAI,sBAAsB,EAC5C,MAAM,IAAI,UAAU,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,KAAK,IAAI,SAAS,EACvB,KAAK,yBAAyB,EAC9B,KAAK,UAAU,IAAI,cAAc,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,IAAI,oBAAoB,EAC1C,MAAM,IAAI,QAAQ,EACnB,MAAM,2CAA2C,CAAC;AAInD,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAC;AAE7F;;;;GAIG;AACH,YAAY,EACV,MAAM,EACN,UAAU,EACV,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2CAA2C,CAAC;AAEnD,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AAGnE,KAAK,UAAU,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEpD,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAChE,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEhE,KAAK,oBAAoB,CAAC,YAAY,SAAS,OAAO,IAAI,YAAY,SAAS,IAAI,GAC/E,cAAc,GACd,gBAAgB,CAAC;AAErB,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AACtD,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEtD,KAAK,sBAAsB,CAAC,YAAY,SAAS,OAAO,IAAI,YAAY,SAAS,IAAI,GACjF,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE,KAAK,sBAAsB,CAAC,YAAY,SAAS,OAAO,IAAI,YAAY,SAAS,IAAI,GACjF,YAAY,GAAG;IAAE,WAAW,CAAC,EAAE,YAAY,CAAA;CAAE,GAC7C,kBAAkB,GAAG;IAAE,WAAW,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AACxC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAC3F,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC;AAC9B,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACrD,YAAY,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAM7E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EACrE,UAAU,EAAE,UAAU,EACtB,UAAU,GAAE,yBAAyB,GAAG;IAEtC,WAAW,CAAC,EAAE,YAAY,CAAC;CACvB,GACL,oBAAoB,CAAC,YAAY,CAAC,CAkBpC;AAED,wBAAgB,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EACzD,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,sBAAsB,CAAC,YAAY,CAA8C,GACzF,sBAAsB,CAAC,YAAY,CAAC,CAStC"}