@pubid/pubid 0.1.40 → 0.1.41

package/README.md

@@ -110,6 +110,31 @@ ships per flavor where the Ruby reference implements a URN parser
 (oiml today; the remaining flavors throw a clear "not yet supported"
 error naming this issue until their ports land).
 
+## Worker-safe registration: the pubid-scheme URN codec
+
+The package root (and the grammar barrel `dist/flavors/index.js` it
+re-exports) statically reaches `dist/parg/runtime.js`, whose module
+scope walks up to a `package.json` through `node:fs` — impossible in a
+worker bundle. Identifier-type *registration* carries no such
+dependency, so the worker entry composes the per-flavor registration
+manifest (`src/flavors/register-types.ts`) with the codec, and one
+import registers every flavor:
+
+```ts
+import { PubidUrn } from "@pubid/pubid/dist/register-types.js";
+
+const id = PubidUrn.fromSlug("iso/is/9001/year-2015"); // resolves
+```
+
+With the manifest loaded, `PubidUrn.fromSlug` covers all 41 flavors
+that resolve identifier types (nist, ieee and oiml included — the three
+the barrel could not reach from a worker). `grammarImplementation`
+(open-ended parse routing) deliberately stays behind the node-only
+barrel: it cannot load in a worker today. The invariants are pinned by
+`test/register-types.test.ts`: the manifest registers exactly the
+barrel's type set, and no node-only module is reachable from the worker
+entry's import graph.
+
 ## Development
 
 ```sh

package/dist/flavors/register-types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The identifier-type registration manifest (pubid/pubid-ts#169): the
+ * parg-free subset of the flavor graph, as side-effect imports only.
+ *
+ * Every flavor registers its model classes into the global type
+ * registry ({@linkcode import("../model/identifier.js").registerType},
+ * the *_TYPE_MAP role) from exactly one of its modules: the model
+ * module when the flavor has one, the implementation entry otherwise.
+ * The grammar barrel (`./index.js`) reaches the same modules
+ * transitively — but it also statically imports the nist, ieee and
+ * doi_pfs implementations, which pull `../parg/runtime.js`, whose
+ * module scope walks up to a package.json through node:fs. That is
+ * impossible in a worker bundle, so a worker cannot import the barrel
+ * to populate the registry.
+ *
+ * This manifest imports the registration modules DIRECTLY, bypassing
+ * every parg-tainted path:
+ *
+ * - model-registrant flavors: `<flavor>/model.js` — pure model
+ *   declarations, no grammar wiring. (cen_cenelec, csa, gost, bsi and
+ *   oiml entry modules import the barrel for co-publisher routing, so
+ *   their model module is the only clean registration path.)
+ * - index-registrant flavors: `<flavor>/index.js` — the class lives on
+ *   the implementation entry; none of these statically reaches the
+ *   parg runtime (the conformance gate is
+ *   test/register-types.test.ts's import-graph walk).
+ *
+ * doi_pfs registers nothing by design ("one scheme, one `_type`, one
+ * global resolution" — its canonical tag routes to the coded doi
+ * class), so it has no entry here.
+ *
+ * The worker entry is dist/register-types.js (src/register-types.ts):
+ * one import registers every flavor and exposes the pubid-scheme URN
+ * codec with no node-only module in the graph.
+ */
+import "./amca/model.js";
+import "./api/model.js";
+import "./ashrae/model.js";
+import "./asme/model.js";
+import "./astm/model.js";
+import "./bsi/model.js";
+import "./cen_cenelec/model.js";
+import "./cie/model.js";
+import "./csa/model.js";
+import "./evs/model.js";
+import "./gost/model.js";
+import "./idf/model.js";
+import "./iec/model.js";
+import "./ieee/model.js";
+import "./iso/model.js";
+import "./itu/model.js";
+import "./nist/model.js";
+import "./oiml/model.js";
+import "./ansi/index.js";
+import "./bipm/index.js";
+import "./calconnect/index.js";
+import "./doi/index.js";
+import "./easc/index.js";
+import "./ecma/index.js";
+import "./etsi/index.js";
+import "./gb/index.js";
+import "./iala/index.js";
+import "./iana/index.js";
+import "./ietf/index.js";
+import "./iho/index.js";
+import "./isbn/index.js";
+import "./jcgm/index.js";
+import "./jis/index.js";
+import "./ogc/index.js";
+import "./oasis/index.js";
+import "./omg/index.js";
+import "./plateau/index.js";
+import "./tgpp/index.js";
+import "./un/index.js";
+import "./w3c/index.js";
+import "./xsf/index.js";

package/dist/flavors/register-types.js

@@ -0,0 +1,78 @@
+/**
+ * The identifier-type registration manifest (pubid/pubid-ts#169): the
+ * parg-free subset of the flavor graph, as side-effect imports only.
+ *
+ * Every flavor registers its model classes into the global type
+ * registry ({@linkcode import("../model/identifier.js").registerType},
+ * the *_TYPE_MAP role) from exactly one of its modules: the model
+ * module when the flavor has one, the implementation entry otherwise.
+ * The grammar barrel (`./index.js`) reaches the same modules
+ * transitively — but it also statically imports the nist, ieee and
+ * doi_pfs implementations, which pull `../parg/runtime.js`, whose
+ * module scope walks up to a package.json through node:fs. That is
+ * impossible in a worker bundle, so a worker cannot import the barrel
+ * to populate the registry.
+ *
+ * This manifest imports the registration modules DIRECTLY, bypassing
+ * every parg-tainted path:
+ *
+ * - model-registrant flavors: `<flavor>/model.js` — pure model
+ *   declarations, no grammar wiring. (cen_cenelec, csa, gost, bsi and
+ *   oiml entry modules import the barrel for co-publisher routing, so
+ *   their model module is the only clean registration path.)
+ * - index-registrant flavors: `<flavor>/index.js` — the class lives on
+ *   the implementation entry; none of these statically reaches the
+ *   parg runtime (the conformance gate is
+ *   test/register-types.test.ts's import-graph walk).
+ *
+ * doi_pfs registers nothing by design ("one scheme, one `_type`, one
+ * global resolution" — its canonical tag routes to the coded doi
+ * class), so it has no entry here.
+ *
+ * The worker entry is dist/register-types.js (src/register-types.ts):
+ * one import registers every flavor and exposes the pubid-scheme URN
+ * codec with no node-only module in the graph.
+ */
+// Model-registrant flavors: registration lives in <flavor>/model.js.
+import "./amca/model.js";
+import "./api/model.js";
+import "./ashrae/model.js";
+import "./asme/model.js";
+import "./astm/model.js";
+import "./bsi/model.js";
+import "./cen_cenelec/model.js";
+import "./cie/model.js";
+import "./csa/model.js";
+import "./evs/model.js";
+import "./gost/model.js";
+import "./idf/model.js";
+import "./iec/model.js";
+import "./ieee/model.js";
+import "./iso/model.js";
+import "./itu/model.js";
+import "./nist/model.js";
+import "./oiml/model.js";
+// Index-registrant flavors: registration lives in <flavor>/index.js.
+import "./ansi/index.js";
+import "./bipm/index.js";
+import "./calconnect/index.js";
+import "./doi/index.js";
+import "./easc/index.js";
+import "./ecma/index.js";
+import "./etsi/index.js";
+import "./gb/index.js";
+import "./iala/index.js";
+import "./iana/index.js";
+import "./ietf/index.js";
+import "./iho/index.js";
+import "./isbn/index.js";
+import "./jcgm/index.js";
+import "./jis/index.js";
+import "./ogc/index.js";
+import "./oasis/index.js";
+import "./omg/index.js";
+import "./plateau/index.js";
+import "./tgpp/index.js";
+import "./un/index.js";
+import "./w3c/index.js";
+import "./xsf/index.js";

package/dist/register-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The worker-safe entry (pubid/pubid-ts#169): one import registers
+ * every flavor's identifier types and exposes the pubid-scheme URN
+ * codec — with no node-only module in the import graph.
+ *
+ * `dist/pubid-urn/index.js` alone decodes nothing on a worker ("unknown
+ * identifier type …"), because the type registry lives in
+ * {@linkcode import("./model/identifier.js").resolveType} and is
+ * populated by importing flavor modules; every existing path to those
+ * modules (the grammar barrel `dist/flavors/index.js`, or the root
+ * `dist/index.js`) drags `dist/parg/runtime.js`, whose module scope
+ * walks up to a package.json through node:fs — impossible in a worker
+ * bundle. This entry composes the parg-free registration manifest
+ * (./flavors/register-types.js) with the codec, so
+ *
+ *     import { PubidUrn } from "@pubid/pubid/register-types.js";
+ *
+ * covers every flavor in a worker. The grammar-backed
+ * `grammarImplementation` (open-ended parse routing) deliberately stays
+ * behind the node-only barrel: it cannot load in a worker today.
+ */
+import "./flavors/register-types.js";
+export * as PubidUrn from "./pubid-urn/index.js";

package/dist/register-types.js

@@ -0,0 +1,23 @@
+/**
+ * The worker-safe entry (pubid/pubid-ts#169): one import registers
+ * every flavor's identifier types and exposes the pubid-scheme URN
+ * codec — with no node-only module in the import graph.
+ *
+ * `dist/pubid-urn/index.js` alone decodes nothing on a worker ("unknown
+ * identifier type …"), because the type registry lives in
+ * {@linkcode import("./model/identifier.js").resolveType} and is
+ * populated by importing flavor modules; every existing path to those
+ * modules (the grammar barrel `dist/flavors/index.js`, or the root
+ * `dist/index.js`) drags `dist/parg/runtime.js`, whose module scope
+ * walks up to a package.json through node:fs — impossible in a worker
+ * bundle. This entry composes the parg-free registration manifest
+ * (./flavors/register-types.js) with the codec, so
+ *
+ *     import { PubidUrn } from "@pubid/pubid/register-types.js";
+ *
+ * covers every flavor in a worker. The grammar-backed
+ * `grammarImplementation` (open-ended parse routing) deliberately stays
+ * behind the node-only barrel: it cannot load in a worker today.
+ */
+import "./flavors/register-types.js";
+export * as PubidUrn from "./pubid-urn/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pubid/pubid",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "TypeScript PubID identifiers: resolution, normalization and canonical hashes for every identifier in the pubid-testsuite corpus (41 standards bodies), with a conformance runner mirroring the Ruby reference",
   "type": "module",
   "license": "MIT",