@kent-tokyo/chematic 1.0.33 → 1.0.35

package/README.md

@@ -4,7 +4,7 @@ WebAssembly bindings for [chematic](https://github.com/kent-tokyo/chematic), a p
 
 Published to npm as [`@kent-tokyo/chematic`](https://www.npmjs.com/package/@kent-tokyo/chematic).
 
-The current workspace line is 1.0.33. The binding keeps bounded parsing,
+The current workspace line is 1.0.35. The binding keeps bounded parsing,
 typed failures, and opt-in `embed_pipeline_v2_json`; 3D/MMFF94 behavior remains
 Experimental and is not a claim of full RDKit parity.
 

package/chematic_wasm.d.ts

@@ -1746,6 +1746,13 @@ export function mol_block_from_smiles(smiles: string): string;
  */
 export function mol_block_stereo_diagnostics_json(mol_block: string): string;
 
+/**
+ * The stereo [`to_mol_block`] does not carry, as JSON:
+ * `{"centres": [atom...], "double_bonds": [bond...],
+ * "non_tetrahedral_centres": [atom...], "stereo_groups_dropped": bool}`.
+ */
+export function mol_block_stereo_loss_json(mol: MolHandle): string;
+
 /**
  * Only the first molecular fragment in the document is returned.
  * Returns a JS error if the document cannot be parsed.
@@ -2458,10 +2465,12 @@ export function run_reactants(smirks: string, reactants_smiles: string): string;
  * Apply a SMIRKS template with explicit outcome accounting as a JSON string.
  *
  * `reactants_smiles` is pipe-separated, as for [`run_reactants`]. With
- * `rdkit_compat = true`, tetrahedral reactant-side `@`/`@@` templates that
- * differ from pinned RDKit 2026.03.6 return `typed_unsupported` and a stable
- * reason code instead of an apparently compatible product. Native semantics
- * and the existing [`run_reactants`] API are unchanged. Product graph/origin/
+ * `rdkit_compat = true`, matching and product stereochemistry follow pinned
+ * RDKit 2026.03.6; inputs it cannot reproduce return `typed_unsupported` and
+ * a stable reason code (`ambiguous_stereo_bond_order`,
+ * `ez_reactant_template_semantics`, `chiral_reactant_template_semantics`)
+ * instead of an apparently compatible product. Native semantics and the
+ * existing [`run_reactants`] API are unchanged. Product graph/origin/
  * template-map parity remains a separate oracle gate. Source indices and
  * product-template map labels are returned alongside the product SMILES;
  * their atom positions match the canonical SMILES parse order.
@@ -2825,9 +2834,20 @@ export function to_extxyz_json(mol: MolHandle, coords_json: string, options_json
  *
  * Atom positions are computed via the same layout engine used for SVG depiction
  * and converted to Ångström units (`1.5 Å` per bond).
+ *
+ * A molecule with stereo gets the MOL writer's stereo layout (E/Z set by
+ * the geometry, one checked wedge per centre); a centre or E/Z bond that
+ * layout cannot express is lost silently here. Use [`to_mol_block_strict`]
+ * to get an error instead, or [`mol_block_stereo_loss_json`] for the list.
  */
 export function to_mol_block(mol: MolHandle): string;
 
+/**
+ * [`to_mol_block`] that fails, naming the lost centres and bonds, when the
+ * block would not carry all of the molecule's stereo.
+ */
+export function to_mol_block_strict(mol: MolHandle): string;
+
 /**
  * Serialise a `MolHandle` to MOL V3000 format with 2D coordinates.
  */
@@ -3180,6 +3200,7 @@ export interface InitOutput {
     readonly mol_block_coords_json: (a: number, b: number) => [number, number, number, number];
     readonly mol_block_from_smiles: (a: number, b: number) => [number, number, number, number];
     readonly mol_block_stereo_diagnostics_json: (a: number, b: number) => [number, number, number, number];
+    readonly mol_block_stereo_loss_json: (a: number) => [number, number];
     readonly mol_from_cdxml: (a: number, b: number) => [number, number, number];
     readonly mol_from_cjson: (a: number, b: number) => [number, number, number];
     readonly mol_from_cml: (a: number, b: number) => [number, number, number];
@@ -3391,6 +3412,7 @@ export interface InitOutput {
     readonly to_cml: (a: number) => [number, number];
     readonly to_extxyz_json: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly to_mol_block: (a: number) => [number, number];
+    readonly to_mol_block_strict: (a: number) => [number, number, number, number];
     readonly to_mol_v3000_block: (a: number) => [number, number];
     readonly to_moljson: (a: number) => [number, number];
     readonly to_qcschema_molecule_json: (a: number, b: number, c: number, d: number, e: bigint) => [number, number, number, number];

package/chematic_wasm.js

@@ -4424,6 +4424,27 @@ export function mol_block_stereo_diagnostics_json(mol_block) {
     }
 }
 
+/**
+ * The stereo [`to_mol_block`] does not carry, as JSON:
+ * `{"centres": [atom...], "double_bonds": [bond...],
+ * "non_tetrahedral_centres": [atom...], "stereo_groups_dropped": bool}`.
+ * @param {MolHandle} mol
+ * @returns {string}
+ */
+export function mol_block_stereo_loss_json(mol) {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        _assertClass(mol, MolHandle);
+        const ret = wasm.mol_block_stereo_loss_json(mol.__wbg_ptr);
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+
 /**
  * Only the first molecular fragment in the document is returned.
  * Returns a JS error if the document cannot be parsed.
@@ -6315,10 +6336,12 @@ export function run_reactants(smirks, reactants_smiles) {
  * Apply a SMIRKS template with explicit outcome accounting as a JSON string.
  *
  * `reactants_smiles` is pipe-separated, as for [`run_reactants`]. With
- * `rdkit_compat = true`, tetrahedral reactant-side `@`/`@@` templates that
- * differ from pinned RDKit 2026.03.6 return `typed_unsupported` and a stable
- * reason code instead of an apparently compatible product. Native semantics
- * and the existing [`run_reactants`] API are unchanged. Product graph/origin/
+ * `rdkit_compat = true`, matching and product stereochemistry follow pinned
+ * RDKit 2026.03.6; inputs it cannot reproduce return `typed_unsupported` and
+ * a stable reason code (`ambiguous_stereo_bond_order`,
+ * `ez_reactant_template_semantics`, `chiral_reactant_template_semantics`)
+ * instead of an apparently compatible product. Native semantics and the
+ * existing [`run_reactants`] API are unchanged. Product graph/origin/
  * template-map parity remains a separate oracle gate. Source indices and
  * product-template map labels are returned alongside the product SMILES;
  * their atom positions match the canonical SMILES parse order.
@@ -7425,6 +7448,11 @@ export function to_extxyz_json(mol, coords_json, options_json) {
  *
  * Atom positions are computed via the same layout engine used for SVG depiction
  * and converted to Ångström units (`1.5 Å` per bond).
+ *
+ * A molecule with stereo gets the MOL writer's stereo layout (E/Z set by
+ * the geometry, one checked wedge per centre); a centre or E/Z bond that
+ * layout cannot express is lost silently here. Use [`to_mol_block_strict`]
+ * to get an error instead, or [`mol_block_stereo_loss_json`] for the list.
  * @param {MolHandle} mol
  * @returns {string}
  */
@@ -7442,6 +7470,32 @@ export function to_mol_block(mol) {
     }
 }
 
+/**
+ * [`to_mol_block`] that fails, naming the lost centres and bonds, when the
+ * block would not carry all of the molecule's stereo.
+ * @param {MolHandle} mol
+ * @returns {string}
+ */
+export function to_mol_block_strict(mol) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        _assertClass(mol, MolHandle);
+        const ret = wasm.to_mol_block_strict(mol.__wbg_ptr);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
 /**
  * Serialise a `MolHandle` to MOL V3000 format with 2D coordinates.
  * @param {MolHandle} mol

package/package.json

@@ -5,7 +5,7 @@
     "Kentaro Tanabe (kent-tokyo) <kent-tokyo@users.noreply.github.com>"
   ],
   "description": "WebAssembly bindings for chematic — use chematic from JavaScript/TypeScript",
-  "version": "1.0.33",
+  "version": "1.0.35",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",