@effected/yaml 0.11.0 → 0.12.0

package/README.md

@@ -193,10 +193,29 @@ The `requoteScalars: true` half of the `singleQuote` row is what buys full parit
 
 Multi-document streams — a Kubernetes manifest, or the two-document `pnpm-lock.yaml` pnpm 11 writes under `configDependencies` — format whole: every document is re-emitted in order with its own `---`/`...` framing and comments, so no document is ever dropped. Document detection is CST-level, so a `---` inside a block scalar or quoted string is content and formats normally. The formatter leaves input byte-identical rather than corrupting it in exactly two cases: a fatal parse error in any document, and a stream carrying `%YAML`/`%TAG` directives (which the emitter cannot re-emit faithfully). Validate a whole stream with `Yaml.parseAllResult`, which fails typed when any document carries a fatal diagnostic; `YamlFormat.modify` stays single-document, since a path names no particular document of a stream.
 
+## Emitting for a YAML 1.1 consumer
+
+YAML 1.2's Core Schema resolves fewer plain scalars to non-strings than YAML 1.1 does. A plain `on` or `yes` round-trips as a string under this package's own parser but becomes a boolean the moment a YAML 1.1 consumer — js-yaml, PyYAML, libyaml, the `yaml` npm package's YAML 1.1 schema, most CI systems' native YAML support — reads it back: the "Norway problem". `quoteCompat: "yaml-1.1"` closes that gap on the way out, quoting every plain scalar a 1.1 resolver would re-type: the extended booleans (`y`/`yes`/`no`/`on`/`off` and case variants), 1.1 timestamps, sexagesimal numbers (`1:30`), underscore-grouped numbers (`1_000`) and the octal/hex/binary integer forms (`0777`, `0x_FF`, `0b1010_0111`). It is strictly additive — nothing the 1.2 rules already quote loses a quote, and no string outside that list gains one — and composes with `quoteStyle` for the quote character and `lineWidth` for folding:
+
+```ts
+import { Yaml, YamlStringifyOptions } from "@effected/yaml";
+import { Effect } from "effect";
+
+const frontmatter = { node: "on", released: "2024-01-15", port: "yes" };
+const options = YamlStringifyOptions.make({ lineWidth: 0, quoteCompat: "yaml-1.1", quoteStyle: "double" });
+
+Effect.runPromise(Yaml.stringify(frontmatter, options)).then(console.log);
+// node: "on"
+// released: "2024-01-15"
+// port: "yes"
+```
+
+That combination — `lineWidth: 0` (no folding), `quoteCompat: "yaml-1.1"`, `quoteStyle: "double"` — is the shape to reach for when stringifying frontmatter destined for YAML-1.1 tooling: Markdown frontmatter parsers and most static-site generators still resolve on the older rules. The option applies on both the value path (`Yaml.stringify`, `Yaml.stringifyResult`) and the node path (`YamlDocument#stringify`, `YamlFormat`), and scalars carrying an explicit tag are exempt, exactly like the 1.2 type-conflict check it extends.
+
 ## Features
 
 - `Yaml.parse` / `Yaml.parseAll` — error-recovery parsing of a single document or a `---`-separated stream into plain values, resolving anchors and aliases and aggregating every diagnostic into one `YamlParseError`.
-- `Yaml.stringify` — serialize a plain value back to YAML, failing typed with `YamlStringifyError` on circular references or on excessively deep nesting; a block-mapping key too long to render on one line spills into explicit-key form (`? key` / `: value`) so strict parsers still accept the output.
+- `Yaml.stringify` — serialize a plain value back to YAML, failing typed with `YamlStringifyError` on circular references or on excessively deep nesting; a block-mapping key too long to render on one line spills into explicit-key form (`? key` / `: value`) so strict parsers still accept the output; `quoteCompat: "yaml-1.1"` additionally quotes plain scalars a YAML 1.1 resolver would re-type.
 - `Yaml.parseResult` / `Yaml.parseAllResult` / `Yaml.stringifyResult` — the pure synchronous counterparts, returning a `Result` instead of an `Effect` for config-time callers that cannot await; each runs the same engine call as its `Effect` variant, so the two forms cannot diverge, and a fatal diagnostic, a duplicate key, an alias bomb or a circular reference still fails typed rather than throwing. `parseAllResult` doubles as a whole-stream validity check: it fails when any document in the stream is invalid.
 - `Yaml.stripComments` — quote-aware comment removal that keeps line numbers stable, or every byte offset stable when given a replacement character.
 - `Yaml.equals` / `Yaml.equalsValue` — semantic equality that ignores comments, whitespace, formatting and mapping key order while keeping sequence order significant.

package/Yaml.js

@@ -1,4 +1,4 @@
-import { AliasExpansionBudgetExceeded, CollectionStyle, QuoteStyle, ScalarStyle, nodeToJsValue } from "./YamlNode.js";
+import { AliasExpansionBudgetExceeded, CollectionStyle, QuoteCompat, QuoteStyle, ScalarStyle, nodeToJsValue } from "./YamlNode.js";
 import { composeAllDocuments, composeFirstDocument } from "./internal/composer/document.js";
 import { isFatalCode } from "./internal/diagnostics.js";
 import { StringifyDepthExceeded, StringifyFailure, stringifyValue } from "./internal/stringifier.js";
@@ -35,8 +35,9 @@ var YamlParseOptions = class extends Schema.Class("YamlParseOptions")({
 * Options controlling stringify behavior. All fields are omissible; absent
 * fields resolve to `indent` `2`, `lineWidth` `0`, `defaultScalarStyle`
 * `"plain"`, `defaultCollectionStyle` `"block"`, `sortKeys` `false`,
-* `indentSequences` `false`, `quoteStyle` `"single"`, `finalNewline` `true`
-* and `forceDefaultStyles` `false`.
+* `indentSequences` `false`, `quoteStyle` `"single"`, `quoteCompat` absent
+* (no dialect-compat quoting), `finalNewline` `true` and `forceDefaultStyles`
+* `false`.
 *
 * `lineWidth` controls column-based scalar folding. The default `0` (and any
 * value `<= 0`) never wraps, emitting byte-identical output to the historic
@@ -114,6 +115,33 @@ var YamlStringifyOptions = class extends Schema.Class("YamlStringifyOptions")({
 	* `"double-quoted"` is unaffected.
 	*/
 	quoteStyle: Schema.optionalKey(QuoteStyle),
+	/**
+	* Additionally quote plain scalars a foreign resolution dialect would
+	* coerce to a non-string. Absent (the default) adds no quoting beyond the
+	* YAML 1.2 Core Schema rules — byte-identical to the released output.
+	*
+	* `"yaml-1.1"` quotes every plain scalar a YAML 1.1 parser (js-yaml,
+	* PyYAML, libyaml, and the `yaml` npm package's YAML 1.1 schema, whose
+	* lenient resolvers set the outer bound) would implicitly resolve to a
+	* non-string: the extended
+	* boolean spellings (`y`/`yes`/`on`/`off` and case variants — the "Norway
+	* problem"), timestamps (`2024-01-15`, `2001-12-15T02:59:43.1Z`, the
+	* space-separated 1.1 forms), sexagesimal numbers (`1:30`,
+	* `190:20:30.15`), underscore-separated numbers (`1_000`) and the
+	* base-2/8/16 integer forms (`0b1010_0111`, `0777`, `0x_FF`). Use it when
+	* emitted output is parsed downstream by a YAML 1.1 consumer and blanket
+	* `defaultScalarStyle` quoting is too noisy.
+	*
+	* Strictly additive: it never un-quotes anything the 1.2 rules require
+	* quoted, strings no 1.1 parser coerces stay plain, and the quote
+	* character stays governed by `quoteStyle`. Scalars carrying an explicit
+	* tag are exempt, exactly like the 1.2 type-conflict check. Applies
+	* wherever the plain fallback renders — values, mapping keys, flow items —
+	* on both the value path ({@link Yaml.stringify},
+	* {@link Yaml.stringifyResult}) and the node path (`YamlDocument#stringify`
+	* and the `YamlFormat` helpers).
+	*/
+	quoteCompat: Schema.optionalKey(QuoteCompat),
 	finalNewline: Schema.optionalKey(Schema.Boolean),
 	forceDefaultStyles: Schema.optionalKey(Schema.Boolean)
 }) {};
@@ -167,6 +195,7 @@ const toStringifyInput = (options) => options === void 0 ? {} : {
 	sortKeys: options.sortKeys,
 	indentSequences: options.indentSequences,
 	quoteStyle: options.quoteStyle,
+	quoteCompat: options.quoteCompat,
 	finalNewline: options.finalNewline,
 	forceDefaultStyles: options.forceDefaultStyles
 };

package/YamlDocument.js

@@ -163,6 +163,8 @@ const toStringifyInput = (options) => options === void 0 ? {} : {
 	defaultCollectionStyle: options.defaultCollectionStyle,
 	sortKeys: options.sortKeys,
 	indentSequences: options.indentSequences,
+	quoteStyle: options.quoteStyle,
+	quoteCompat: options.quoteCompat,
 	finalNewline: options.finalNewline,
 	forceDefaultStyles: options.forceDefaultStyles
 };

package/YamlFormat.js

@@ -12,8 +12,8 @@ import { Effect, Schema } from "effect";
 //#region src/YamlFormat.ts
 /**
 * Options controlling formatting behavior: every {@link YamlStringifyOptions}
-* field (derived, not hand-duplicated — including `indentSequences` and
-* `quoteStyle`) plus
+* field (derived, not hand-duplicated — including `indentSequences`,
+* `quoteStyle` and `quoteCompat`) plus
 * `preserveComments` (default `true`), `range` (restrict edits to a
 * region; see the module-level remarks on the `range` parameter vs. this
 * field) and `requoteScalars` (default `false`).
@@ -105,6 +105,7 @@ const toStringifyInput = (options) => options === void 0 ? {} : {
 	sortKeys: options.sortKeys,
 	indentSequences: options.indentSequences,
 	quoteStyle: options.quoteStyle,
+	quoteCompat: options.quoteCompat,
 	finalNewline: options.finalNewline,
 	forceDefaultStyles: options.forceDefaultStyles
 };

package/YamlNode.js

@@ -30,6 +30,21 @@ const CollectionStyle = Schema.Literals(["block", "flow"]);
 */
 const QuoteStyle = Schema.Literals(["single", "double"]);
 /**
+* Foreign resolution dialects the stringifier's plain-scalar fallback can
+* defend against: setting the `quoteCompat` field of `YamlStringifyOptions`
+* to `"yaml-1.1"` additionally quotes every plain scalar a YAML 1.1 parser
+* (js-yaml, PyYAML, libyaml, and the `yaml` npm package's YAML 1.1 schema,
+* whose lenient resolvers set the outer bound) would implicitly resolve to a
+* non-string —
+* `yes`/`no`/`on`/`off` booleans, ISO 8601 and space-separated timestamps,
+* sexagesimal `1:30`, underscored `1_000` and base-2/8/16 numbers. Like
+* `QuoteStyle` it is a stringify-option vocabulary, never a property of a
+* composed node.
+*
+* @public
+*/
+const QuoteCompat = Schema.Literals(["yaml-1.1"]);
+/**
 * Block-scalar chomping indicators (`-` strip, default clip, `+` keep).
 * Referenced by the {@link YamlScalar} `chomp` field schema.
 *
@@ -442,4 +457,4 @@ function nodeToValue(node, anchors, budget, counting = false) {
 }
 
 //#endregion
-export { AliasExpansionBudgetExceeded, CollectionStyle, QuoteStyle, ScalarChomp, ScalarStyle, YamlAlias, YamlMap, YamlNode, YamlPair, YamlScalar, YamlSeq, aliasExpansionLimit, nodeToJsValue };
+export { AliasExpansionBudgetExceeded, CollectionStyle, QuoteCompat, QuoteStyle, ScalarChomp, ScalarStyle, YamlAlias, YamlMap, YamlNode, YamlPair, YamlScalar, YamlSeq, aliasExpansionLimit, nodeToJsValue };

package/index.d.ts

@@ -175,6 +175,33 @@ declare const YamlStringifyOptions_base: Schema.Class<YamlStringifyOptions, Sche
    * `"double-quoted"` is unaffected.
    */
   readonly quoteStyle: Schema.optionalKey<Schema.Literals<readonly ["single", "double"]>>;
+  /**
+   * Additionally quote plain scalars a foreign resolution dialect would
+   * coerce to a non-string. Absent (the default) adds no quoting beyond the
+   * YAML 1.2 Core Schema rules — byte-identical to the released output.
+   *
+   * `"yaml-1.1"` quotes every plain scalar a YAML 1.1 parser (js-yaml,
+   * PyYAML, libyaml, and the `yaml` npm package's YAML 1.1 schema, whose
+   * lenient resolvers set the outer bound) would implicitly resolve to a
+   * non-string: the extended
+   * boolean spellings (`y`/`yes`/`on`/`off` and case variants — the "Norway
+   * problem"), timestamps (`2024-01-15`, `2001-12-15T02:59:43.1Z`, the
+   * space-separated 1.1 forms), sexagesimal numbers (`1:30`,
+   * `190:20:30.15`), underscore-separated numbers (`1_000`) and the
+   * base-2/8/16 integer forms (`0b1010_0111`, `0777`, `0x_FF`). Use it when
+   * emitted output is parsed downstream by a YAML 1.1 consumer and blanket
+   * `defaultScalarStyle` quoting is too noisy.
+   *
+   * Strictly additive: it never un-quotes anything the 1.2 rules require
+   * quoted, strings no 1.1 parser coerces stay plain, and the quote
+   * character stays governed by `quoteStyle`. Scalars carrying an explicit
+   * tag are exempt, exactly like the 1.2 type-conflict check. Applies
+   * wherever the plain fallback renders — values, mapping keys, flow items —
+   * on both the value path ({@link Yaml.stringify},
+   * {@link Yaml.stringifyResult}) and the node path (`YamlDocument#stringify`
+   * and the `YamlFormat` helpers).
+   */
+  readonly quoteCompat: Schema.optionalKey<Schema.Literals<readonly ["yaml-1.1"]>>;
   readonly finalNewline: Schema.optionalKey<Schema.Boolean>;
   readonly forceDefaultStyles: Schema.optionalKey<Schema.Boolean>;
 }>, {}>;
@@ -182,8 +209,9 @@ declare const YamlStringifyOptions_base: Schema.Class<YamlStringifyOptions, Sche
  * Options controlling stringify behavior. All fields are omissible; absent
  * fields resolve to `indent` `2`, `lineWidth` `0`, `defaultScalarStyle`
  * `"plain"`, `defaultCollectionStyle` `"block"`, `sortKeys` `false`,
- * `indentSequences` `false`, `quoteStyle` `"single"`, `finalNewline` `true`
- * and `forceDefaultStyles` `false`.
+ * `indentSequences` `false`, `quoteStyle` `"single"`, `quoteCompat` absent
+ * (no dialect-compat quoting), `finalNewline` `true` and `forceDefaultStyles`
+ * `false`.
  *
  * `lineWidth` controls column-based scalar folding. The default `0` (and any
  * value `<= 0`) never wraps, emitting byte-identical output to the historic
@@ -641,6 +669,27 @@ declare const QuoteStyle: Schema.Literals<readonly ["single", "double"]>;
  * @public
  */
 type QuoteStyle = typeof QuoteStyle.Type;
+/**
+ * Foreign resolution dialects the stringifier's plain-scalar fallback can
+ * defend against: setting the `quoteCompat` field of `YamlStringifyOptions`
+ * to `"yaml-1.1"` additionally quotes every plain scalar a YAML 1.1 parser
+ * (js-yaml, PyYAML, libyaml, and the `yaml` npm package's YAML 1.1 schema,
+ * whose lenient resolvers set the outer bound) would implicitly resolve to a
+ * non-string —
+ * `yes`/`no`/`on`/`off` booleans, ISO 8601 and space-separated timestamps,
+ * sexagesimal `1:30`, underscored `1_000` and base-2/8/16 numbers. Like
+ * `QuoteStyle` it is a stringify-option vocabulary, never a property of a
+ * composed node.
+ *
+ * @public
+ */
+declare const QuoteCompat: Schema.Literals<readonly ["yaml-1.1"]>;
+/**
+ * The union of all quote-compat dialect string literals.
+ *
+ * @public
+ */
+type QuoteCompat = typeof QuoteCompat.Type;
 /**
  * Block-scalar chomping indicators (`-` strip, default clip, `+` keep).
  * Referenced by the {@link YamlScalar} `chomp` field schema.
@@ -1005,6 +1054,7 @@ declare const YamlFormattingOptions_base: Schema.Class<YamlFormattingOptions, Sc
   readonly sortKeys: Schema.optionalKey<Schema.Boolean>;
   readonly indentSequences: Schema.optionalKey<Schema.Boolean>;
   readonly quoteStyle: Schema.optionalKey<Schema.Literals<readonly ["single", "double"]>>;
+  readonly quoteCompat: Schema.optionalKey<Schema.Literals<readonly ["yaml-1.1"]>>;
   readonly finalNewline: Schema.optionalKey<Schema.Boolean>;
   readonly forceDefaultStyles: Schema.optionalKey<Schema.Boolean>;
   readonly preserveComments: Schema.optionalKey<Schema.Boolean>;
@@ -1013,8 +1063,8 @@ declare const YamlFormattingOptions_base: Schema.Class<YamlFormattingOptions, Sc
 }>, {}>;
 /**
  * Options controlling formatting behavior: every {@link YamlStringifyOptions}
- * field (derived, not hand-duplicated — including `indentSequences` and
- * `quoteStyle`) plus
+ * field (derived, not hand-duplicated — including `indentSequences`,
+ * `quoteStyle` and `quoteCompat`) plus
  * `preserveComments` (default `true`), `range` (restrict edits to a
  * region; see the module-level remarks on the `range` parameter vs. this
  * field) and `requoteScalars` (default `false`).
@@ -2294,5 +2344,5 @@ declare class YamlVisitor {
   static visit(text: string, options?: YamlParseOptions): Stream.Stream<YamlVisitorEvent>;
 }
 //#endregion
-export { CollectionStyle, type LintContext, type LintLine, QuoteStyle, ScalarChomp, ScalarStyle, StyleConflict, StyleEvidence, StyleFloor, StyleFloorTally, type StyleObservation, StyleVote, StyleVoteTally, Yaml, YamlAlias, type YamlAliasEncoded, type YamlBoundCodec, YamlComposerErrorCode, YamlDiagnostic, YamlDirective, YamlDocument, YamlEdit, YamlErrorCode, YamlFormat, YamlFormattingOptions, YamlLexErrorCode, YamlLint, YamlLintConfig, YamlLintDiagnostic, type YamlLintInference, YamlLintRuleSetting, YamlLintSeverity, YamlMap, type YamlMapEncoded, YamlModificationError, YamlModifyErrorCode, YamlNode, YamlPair, YamlParseError, YamlParseErrorCode, YamlParseOptions, type YamlPath, YamlRange, type YamlRangeLike, type YamlRule, YamlScalar, type YamlScalarEncoded, type YamlSegment, YamlSeq, type YamlSeqEncoded, YamlStringifyError, YamlStringifyErrorCode, YamlStringifyOptions, YamlStyleConflictError, YamlToken, YamlTokenKind, YamlTokens, YamlVisitor, YamlVisitorEvent };
+export { CollectionStyle, type LintContext, type LintLine, QuoteCompat, QuoteStyle, ScalarChomp, ScalarStyle, StyleConflict, StyleEvidence, StyleFloor, StyleFloorTally, type StyleObservation, StyleVote, StyleVoteTally, Yaml, YamlAlias, type YamlAliasEncoded, type YamlBoundCodec, YamlComposerErrorCode, YamlDiagnostic, YamlDirective, YamlDocument, YamlEdit, YamlErrorCode, YamlFormat, YamlFormattingOptions, YamlLexErrorCode, YamlLint, YamlLintConfig, YamlLintDiagnostic, type YamlLintInference, YamlLintRuleSetting, YamlLintSeverity, YamlMap, type YamlMapEncoded, YamlModificationError, YamlModifyErrorCode, YamlNode, YamlPair, YamlParseError, YamlParseErrorCode, YamlParseOptions, type YamlPath, YamlRange, type YamlRangeLike, type YamlRule, YamlScalar, type YamlScalarEncoded, type YamlSegment, YamlSeq, type YamlSeqEncoded, YamlStringifyError, YamlStringifyErrorCode, YamlStringifyOptions, YamlStyleConflictError, YamlToken, YamlTokenKind, YamlTokens, YamlVisitor, YamlVisitorEvent };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,4 +1,4 @@
-import { CollectionStyle, QuoteStyle, ScalarChomp, ScalarStyle, YamlAlias, YamlMap, YamlNode, YamlPair, YamlScalar, YamlSeq } from "./YamlNode.js";
+import { CollectionStyle, QuoteCompat, QuoteStyle, ScalarChomp, ScalarStyle, YamlAlias, YamlMap, YamlNode, YamlPair, YamlScalar, YamlSeq } from "./YamlNode.js";
 import { YamlComposerErrorCode, YamlDiagnostic, YamlErrorCode, YamlLexErrorCode, YamlModifyErrorCode, YamlParseErrorCode, YamlStringifyErrorCode } from "./YamlDiagnostic.js";
 import { Yaml, YamlParseError, YamlParseOptions, YamlStringifyError, YamlStringifyOptions } from "./Yaml.js";
 import { YamlDirective, YamlDocument } from "./YamlDocument.js";
@@ -9,4 +9,4 @@ import { YamlToken, YamlTokenKind, YamlTokens } from "./YamlToken.js";
 import { StyleConflict, StyleEvidence, StyleFloorTally, StyleVoteTally, YamlLint, YamlLintConfig, YamlLintRuleSetting, YamlStyleConflictError } from "./YamlLint.js";
 import { YamlVisitor, YamlVisitorEvent } from "./YamlVisitor.js";
 
-export { CollectionStyle, QuoteStyle, ScalarChomp, ScalarStyle, StyleConflict, StyleEvidence, StyleFloor, StyleFloorTally, StyleVote, StyleVoteTally, Yaml, YamlAlias, YamlComposerErrorCode, YamlDiagnostic, YamlDirective, YamlDocument, YamlEdit, YamlErrorCode, YamlFormat, YamlFormattingOptions, YamlLexErrorCode, YamlLint, YamlLintConfig, YamlLintDiagnostic, YamlLintRuleSetting, YamlLintSeverity, YamlMap, YamlModificationError, YamlModifyErrorCode, YamlNode, YamlPair, YamlParseError, YamlParseErrorCode, YamlParseOptions, YamlRange, YamlScalar, YamlSeq, YamlStringifyError, YamlStringifyErrorCode, YamlStringifyOptions, YamlStyleConflictError, YamlToken, YamlTokenKind, YamlTokens, YamlVisitor, YamlVisitorEvent };
+export { CollectionStyle, QuoteCompat, QuoteStyle, ScalarChomp, ScalarStyle, StyleConflict, StyleEvidence, StyleFloor, StyleFloorTally, StyleVote, StyleVoteTally, Yaml, YamlAlias, YamlComposerErrorCode, YamlDiagnostic, YamlDirective, YamlDocument, YamlEdit, YamlErrorCode, YamlFormat, YamlFormattingOptions, YamlLexErrorCode, YamlLint, YamlLintConfig, YamlLintDiagnostic, YamlLintRuleSetting, YamlLintSeverity, YamlMap, YamlModificationError, YamlModifyErrorCode, YamlNode, YamlPair, YamlParseError, YamlParseErrorCode, YamlParseOptions, YamlRange, YamlScalar, YamlSeq, YamlStringifyError, YamlStringifyErrorCode, YamlStringifyOptions, YamlStyleConflictError, YamlToken, YamlTokenKind, YamlTokens, YamlVisitor, YamlVisitorEvent };

package/internal/stringifier.js

@@ -105,6 +105,23 @@ function wouldBeResolved(s) {
 	if (FLOAT_RE.test(s)) return true;
 	return false;
 }
+const BOOL_11_RE = /^(?:y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF)$/;
+const INT_11_RE = /^[-+]?(?:0b[0-1_]+|0o?[0-7_]+|[0-9][0-9_]*|0x[0-9a-fA-F_]+|[1-9][0-9_]*(?::[0-5]?[0-9])+)$/;
+const FLOAT_11_RE = /^[-+]?(?:[0-9][0-9_]*(?:\.[0-9_]*(?:[eE][-+]?[0-9]+)?|[eE][-+]?[0-9]+)|\.[0-9_]+(?:[eE][-+]?[0-9]+)?|[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*)$/;
+const TIMESTAMP_11_RE = /^[0-9][0-9][0-9][0-9]-[0-9][0-9]?-[0-9][0-9]?(?:(?:[Tt]|[ \t]+)[0-9][0-9]?:[0-9][0-9]:[0-9][0-9](?:\.[0-9]*)?(?:[ \t]*(?:Z|[-+][0-9][0-9]?(?::?[0-9][0-9])?))?)?$/;
+/**
+* Returns true if a string value would be resolved as a non-string type by a
+* YAML 1.1 parser. The delta over {@link wouldBeResolved}: null spellings are
+* identical in both editions (and already covered), so only the boolean,
+* integer, float and timestamp families are tested here.
+*/
+function wouldBeResolved11(s) {
+	if (BOOL_11_RE.test(s)) return true;
+	if (INT_11_RE.test(s)) return true;
+	if (FLOAT_11_RE.test(s)) return true;
+	if (TIMESTAMP_11_RE.test(s)) return true;
+	return false;
+}
 /**
 * Returns true if a string requires quoting to be safely represented as a plain scalar.
 *
@@ -112,11 +129,16 @@ function wouldBeResolved(s) {
 * embedded newlines, leading indicator characters or whitespace, and inline
 * comment/mapping-value patterns (`: `, ` #`). This is the single gate that
 * decides whether a plain scalar is safe or must be wrapped in quotes.
+*
+* `quoteCompat` is strictly additive: `"yaml-1.1"` additionally quotes
+* strings a YAML 1.1 parser would coerce ({@link wouldBeResolved11}) and can
+* never un-quote anything the 1.2 rules require quoted.
 */
-function requiresQuoting(s, ignoreType = false) {
+function requiresQuoting(s, ignoreType = false, quoteCompat) {
 	if (s === "") return true;
 	if (s.includes("\n")) return true;
 	if (!ignoreType && wouldBeResolved(s)) return true;
+	if (!ignoreType && quoteCompat === "yaml-1.1" && wouldBeResolved11(s)) return true;
 	const first = s[0];
 	if (first === " " || first === "	") return true;
 	if (first !== void 0 && INDICATOR_CHARS.has(first)) {
@@ -197,7 +219,7 @@ function renderSingleQuoted(s) {
 * Block literal and block folded styles are always accepted for single-line
 * strings even though the output is unusual.
 */
-function renderString(s, style, indent, ignoreType = false, canonical = false, explicitChomp, parentPosition, quoteStyle = "single", explicitIndent) {
+function renderString(s, style, indent, ignoreType = false, canonical = false, explicitChomp, parentPosition, quoteStyle = "single", explicitIndent, quoteCompat) {
 	const fidelity = !canonical;
 	const fidelityIndent = fidelity ? explicitIndent : void 0;
 	if (s.includes("\n")) {
@@ -230,7 +252,7 @@ function renderString(s, style, indent, ignoreType = false, canonical = false, e
 	if (s === "" && (style === "block-literal" || style === "block-folded")) return renderDoubleQuoted(s, canonical);
 	switch (style) {
 		case "plain":
-			if (requiresQuoting(s, ignoreType)) {
+			if (requiresQuoting(s, ignoreType, quoteCompat)) {
 				if (s.includes("	") || s.includes("\r")) return renderDoubleQuoted(s, canonical);
 				for (let i = 0; i < s.length; i++) if (isControlChar(s.charCodeAt(i))) return renderDoubleQuoted(s, canonical);
 				return quoteStyle === "double" ? renderDoubleQuoted(s, canonical) : renderSingleQuoted(s);
@@ -289,6 +311,7 @@ function createContext(options) {
 		sortKeys: options?.sortKeys ?? false,
 		indentSequences: options?.indentSequences ?? false,
 		quoteStyle: options?.quoteStyle ?? "single",
+		quoteCompat: options?.quoteCompat,
 		forceDefaultStyles: options?.forceDefaultStyles ?? false,
 		seen: /* @__PURE__ */ new Set()
 	};
@@ -308,7 +331,7 @@ function stringifyLines(value, ctx, depth, allowFold = true) {
 	if (typeof value === "bigint") return [value.toString()];
 	if (typeof value === "string") {
 		const indentStr = " ".repeat(ctx.indent);
-		const rendered = renderString(value, ctx.defaultScalarStyle, indentStr, false, ctx.forceDefaultStyles, void 0, void 0, ctx.quoteStyle);
+		const rendered = renderString(value, ctx.defaultScalarStyle, indentStr, false, ctx.forceDefaultStyles, void 0, void 0, ctx.quoteStyle, void 0, ctx.quoteCompat);
 		return (allowFold && ctx.lineWidth > 0 ? foldRenderedScalar(rendered, indentStr, ctx.lineWidth) : rendered).split("\n");
 	}
 	if (Array.isArray(value)) {
@@ -373,7 +396,7 @@ function stringifyObjectLines(obj, ctx, depth) {
 	const keys = Object.keys(obj);
 	if (keys.length === 0) return ["{}"];
 	if (ctx.sortKeys) keys.sort();
-	const renderPlainKey = (k) => renderString(k, "plain", "", false, false, void 0, void 0, ctx.quoteStyle);
+	const renderPlainKey = (k) => renderString(k, "plain", "", false, false, void 0, void 0, ctx.quoteStyle, void 0, ctx.quoteCompat);
 	if (ctx.defaultCollectionStyle === "flow") return [`{${keys.map((k) => {
 		return `${renderPlainKey(k)}: ${stringifyLines(obj[k], ctx, depth + 1, false).join(" ")}`;
 	}).join(", ")}}`];
@@ -584,7 +607,7 @@ function stringifyScalarNodeLines(node, ctx) {
 		else lines = ["null"];
 	} else if (typeof val === "boolean") lines = [val ? "true" : "false"];
 	else if (typeof val === "number") lines = [node.raw !== void 0 ? node.raw : renderNumber(val)];
-	else if (typeof val === "string") lines = renderString(val, style, " ".repeat(ctx.indent), !!node.tag, ctx.forceDefaultStyles, node.chomp, ctx.parentPosition, ctx.quoteStyle, node.blockIndent).split("\n");
+	else if (typeof val === "string") lines = renderString(val, style, " ".repeat(ctx.indent), !!node.tag, ctx.forceDefaultStyles, node.chomp, ctx.parentPosition, ctx.quoteStyle, node.blockIndent, ctx.quoteCompat).split("\n");
 	else lines = [renderDoubleQuoted(String(val))];
 	if (node.tag) lines[0] = `${node.tag} ${lines[0]}`;
 	if (node.anchor) lines[0] = `&${node.anchor} ${lines[0]}`;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/yaml",
-	"version": "0.11.0",
+	"version": "0.12.0",
 	"private": false,
 	"description": "Zero-dependency YAML parsing, editing, formatting and linting as Effect schemas.",
 	"keywords": [