@thomasfosterau/effect-rdf 0.0.0 → 0.1.0

package/dist/Photoshop-udKZ0I3N.d.mts

@@ -0,0 +1,204 @@
+import { c as Setter, o as Metadata } from "./Metadata-nzS7QKRj.mjs";
+import * as Option from "effect/Option";
+import * as DateTime from "effect/DateTime";
+declare namespace Photoshop_d_exports {
+  export { authorsPosition, captionWriter, category, city, country, credit, dateCreated, headline, instructions, setAuthorsPosition, setCaptionWriter, setCategory, setCity, setCountry, setCredit, setDateCreated, setHeadline, setInstructions, setSource, setState, setSupplementalCategories, setTransmissionReference, setUrgency, source, state, supplementalCategories, transmissionReference, urgency };
+}
+/**
+ * The by-line title of the creator (`photoshop:AuthorsPosition`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const authorsPosition: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the by-line title of the creator (`photoshop:AuthorsPosition`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setAuthorsPosition: Setter<string>;
+/**
+ * Who wrote the caption (`photoshop:CaptionWriter`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const captionWriter: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets who wrote the caption (`photoshop:CaptionWriter`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setCaptionWriter: Setter<string>;
+/**
+ * The IPTC category (`photoshop:Category`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const category: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the IPTC category (`photoshop:Category`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setCategory: Setter<string>;
+/**
+ * The city the image was taken in (`photoshop:City`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const city: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the city the image was taken in (`photoshop:City`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setCity: Setter<string>;
+/**
+ * The country the image was taken in (`photoshop:Country`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const country: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the country the image was taken in (`photoshop:Country`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setCountry: Setter<string>;
+/**
+ * The provider credit line (`photoshop:Credit`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const credit: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the provider credit line (`photoshop:Credit`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setCredit: Setter<string>;
+/**
+ * When the intellectual content was created (`photoshop:DateCreated`). An ISO 8601 date, as XMP stores it; the setter takes a `DateTime` or a string.
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const dateCreated: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets when the intellectual content was created (`photoshop:DateCreated`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setDateCreated: Setter<DateTime.DateTime | string>;
+/**
+ * A short synopsis of the content (`photoshop:Headline`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const headline: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets a short synopsis of the content (`photoshop:Headline`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setHeadline: Setter<string>;
+/**
+ * Special instructions for using the resource (`photoshop:Instructions`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const instructions: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets special instructions for using the resource (`photoshop:Instructions`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setInstructions: Setter<string>;
+/**
+ * The original owner of the copyright (`photoshop:Source`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const source: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the original owner of the copyright (`photoshop:Source`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setSource: Setter<string>;
+/**
+ * The province or state the image was taken in (`photoshop:State`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const state: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the province or state the image was taken in (`photoshop:State`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setState: Setter<string>;
+/**
+ * The supplemental IPTC categories (`photoshop:SupplementalCategories`). An unordered array.
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const supplementalCategories: (self: Metadata) => Option.Option<ReadonlyArray<string>>;
+/**
+ * Sets the supplemental IPTC categories (`photoshop:SupplementalCategories`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setSupplementalCategories: Setter<Iterable<string>>;
+/**
+ * The original transmission reference (`photoshop:TransmissionReference`).
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const transmissionReference: (self: Metadata) => Option.Option<string>;
+/**
+ * Sets the original transmission reference (`photoshop:TransmissionReference`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setTransmissionReference: Setter<string>;
+/**
+ * The editorial urgency, 1 (high) to 8 (low) (`photoshop:Urgency`). An integer.
+ *
+ * @since 0.1.0
+ * @category getters
+ */
+declare const urgency: (self: Metadata) => Option.Option<number>;
+/**
+ * Sets the editorial urgency, 1 (high) to 8 (low) (`photoshop:Urgency`).
+ *
+ * @since 0.1.0
+ * @category setters
+ */
+declare const setUrgency: Setter<number>;
+export { setTransmissionReference as C, supplementalCategories as D, state as E, transmissionReference as O, setSupplementalCategories as S, source as T, setDateCreated as _, city as a, setSource as b, dateCreated as c, setAuthorsPosition as d, setCaptionWriter as f, setCredit as g, setCountry as h, category as i, urgency as k, headline as l, setCity as m, authorsPosition as n, country as o, setCategory as p, captionWriter as r, credit as s, Photoshop_d_exports as t, instructions as u, setHeadline as v, setUrgency as w, setState as x, setInstructions as y };
+//# sourceMappingURL=Photoshop-udKZ0I3N.d.mts.map

package/dist/PrefixMap-BHFPDLO-.mjs

@@ -0,0 +1,103 @@
+import { t as __exportAll } from "./rolldown-runtime-D8jQpDG7.mjs";
+import { c as NamedNode } from "./Term-CFLG1qu4.mjs";
+import { n as commonPrefixes } from "./Vocab-DceKywpq.mjs";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Record from "effect/Record";
+// src/PrefixMap.ts
+/**
+* Immutable prefix ↔ namespace mappings used to expand and compact IRIs.
+*
+* @since 0.1.0
+*/
+var PrefixMap_exports = /* @__PURE__ */ __exportAll({
+	common: () => common,
+	compact: () => compact,
+	empty: () => empty,
+	expand: () => expand,
+	get: () => get,
+	make: () => make,
+	merge: () => merge,
+	set: () => set
+});
+/**
+* The `prefixes` of a prefix map: a native `ReadonlyMap`, as the public
+* field is typed; a later entry for a prefix replaces an earlier one.
+*/
+function prefixMap(entries) {
+	return new Map(entries);
+}
+/**
+* @since 0.1.0
+* @category constructors
+*/
+const empty = { prefixes: prefixMap([]) };
+/**
+* @since 0.1.0
+* @category constructors
+*/
+const make = (prefixes) => ({ prefixes: prefixMap(Symbol.iterator in prefixes ? prefixes : Record.toEntries(prefixes)) });
+/**
+* A prefix map containing `rdf`, `rdfs`, `xsd` and `owl`.
+*
+* @since 0.1.0
+* @category constructors
+*/
+const common = make(commonPrefixes);
+/**
+* @since 0.1.0
+* @category combinators
+*/
+const set = (self, prefix, namespace) => {
+	return { prefixes: prefixMap([...self.prefixes, [prefix, namespace]]) };
+};
+/**
+* Merges two prefix maps; entries in `that` win.
+*
+* @since 0.1.0
+* @category combinators
+*/
+const merge = (self, that) => ({ prefixes: prefixMap([...self.prefixes, ...that.prefixes]) });
+/**
+* @since 0.1.0
+* @category getters
+*/
+const get = (self, prefix) => Option.fromNullishOr(self.prefixes.get(prefix));
+/**
+* Expands a prefixed name (`prefix:local`) to an IRI.
+*
+* @since 0.1.0
+* @category combinators
+*/
+const expand = (self, curie) => {
+	const i = curie.indexOf(":");
+	if (i === -1) return Option.none();
+	const ns = self.prefixes.get(curie.slice(0, i));
+	return ns === void 0 ? Option.none() : Option.some(new NamedNode(ns + curie.slice(i + 1)));
+};
+const PN_LOCAL_SIMPLE = /^(?:[A-Za-z0-9_À-�:]|%[0-9A-Fa-f]{2})(?:(?:[A-Za-z0-9_\-.·À-�:]|%[0-9A-Fa-f]{2})*(?:[A-Za-z0-9_\-·À-�:]|%[0-9A-Fa-f]{2}))?$/;
+/**
+* Compacts an IRI to `[prefix, local]` using the longest matching namespace,
+* if the local part is a valid Turtle/SPARQL `PN_LOCAL` without escapes.
+*
+* @since 0.1.0
+* @category combinators
+*/
+const compact = (self, iri) => {
+	const value = Predicate.isString(iri) ? iri : iri.value;
+	let best = Option.none();
+	let bestLength = -1;
+	self.prefixes.forEach((ns, prefix) => {
+		if (ns.length > bestLength && value.startsWith(ns)) {
+			const local = value.slice(ns.length);
+			if (local === "" || PN_LOCAL_SIMPLE.test(local)) {
+				best = Option.some([prefix, local]);
+				bestLength = ns.length;
+			}
+		}
+	});
+	return best;
+};
+export { expand as a, merge as c, empty as i, set as l, common as n, get as o, compact as r, make as s, PrefixMap_exports as t };
+
+//# sourceMappingURL=PrefixMap-BHFPDLO-.mjs.map

package/dist/PrefixMap-BHFPDLO-.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefixMap-BHFPDLO-.mjs","names":[],"sources":["../src/PrefixMap.ts"],"sourcesContent":["/**\n * Immutable prefix ↔ namespace mappings used to expand and compact IRIs.\n *\n * @since 0.1.0\n */\nimport * as Option from 'effect/Option';\nimport { NamedNode } from './Term.ts';\nimport { commonPrefixes } from './Vocab.ts';\nimport * as Predicate from 'effect/Predicate';\nimport * as Record from 'effect/Record';\n\n/**\n * @since 0.1.0\n * @category models\n */\nexport interface PrefixMap {\n  readonly prefixes: ReadonlyMap<string, string>;\n}\n\n/**\n * The `prefixes` of a prefix map: a native `ReadonlyMap`, as the public\n * field is typed; a later entry for a prefix replaces an earlier one.\n */\nfunction prefixMap(entries: Iterable<readonly [string, string]>): ReadonlyMap<string, string> {\n  return new Map(entries);\n}\n\n/**\n * @since 0.1.0\n * @category constructors\n */\nexport const empty: PrefixMap = { prefixes: prefixMap([]) };\n\n/**\n * @since 0.1.0\n * @category constructors\n */\nexport const make = (\n  prefixes: Record.ReadonlyRecord<string, string> | Iterable<readonly [string, string]>,\n): PrefixMap => ({\n  prefixes: prefixMap(Symbol.iterator in prefixes ? prefixes : Record.toEntries(prefixes)),\n});\n\n/**\n * A prefix map containing `rdf`, `rdfs`, `xsd` and `owl`.\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const common: PrefixMap = make(commonPrefixes);\n\n/**\n * @since 0.1.0\n * @category combinators\n */\nexport const set = (self: PrefixMap, prefix: string, namespace: string): PrefixMap => {\n  return { prefixes: prefixMap([...self.prefixes, [prefix, namespace]]) };\n};\n\n/**\n * Merges two prefix maps; entries in `that` win.\n *\n * @since 0.1.0\n * @category combinators\n */\nexport const merge = (self: PrefixMap, that: PrefixMap): PrefixMap => ({\n  prefixes: prefixMap([...self.prefixes, ...that.prefixes]),\n});\n\n/**\n * @since 0.1.0\n * @category getters\n */\nexport const get = (self: PrefixMap, prefix: string): Option.Option<string> =>\n  Option.fromNullishOr(self.prefixes.get(prefix));\n\n/**\n * Expands a prefixed name (`prefix:local`) to an IRI.\n *\n * @since 0.1.0\n * @category combinators\n */\nexport const expand = (self: PrefixMap, curie: string): Option.Option<NamedNode> => {\n  const i = curie.indexOf(':');\n  if (i === -1) return Option.none();\n  const ns = self.prefixes.get(curie.slice(0, i));\n  return ns === undefined ? Option.none() : Option.some(new NamedNode(ns + curie.slice(i + 1)));\n};\n\nconst PN_LOCAL_SIMPLE =\n  /^(?:[A-Za-z0-9_À-�:]|%[0-9A-Fa-f]{2})(?:(?:[A-Za-z0-9_\\-.·À-�:]|%[0-9A-Fa-f]{2})*(?:[A-Za-z0-9_\\-·À-�:]|%[0-9A-Fa-f]{2}))?$/;\n\n/**\n * Compacts an IRI to `[prefix, local]` using the longest matching namespace,\n * if the local part is a valid Turtle/SPARQL `PN_LOCAL` without escapes.\n *\n * @since 0.1.0\n * @category combinators\n */\nexport const compact = (\n  self: PrefixMap,\n  iri: string | NamedNode,\n): Option.Option<readonly [string, string]> => {\n  const value = Predicate.isString(iri) ? iri : iri.value;\n  let best: Option.Option<readonly [string, string]> = Option.none();\n  let bestLength = -1;\n  self.prefixes.forEach((ns, prefix) => {\n    if (ns.length > bestLength && value.startsWith(ns)) {\n      const local = value.slice(ns.length);\n      if (local === '' || PN_LOCAL_SIMPLE.test(local)) {\n        best = Option.some([prefix, local]);\n        bestLength = ns.length;\n      }\n    }\n  });\n  return best;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAS,UAAU,SAA2E;CAC5F,OAAO,IAAI,IAAI,OAAO;AACxB;;;;;AAMA,MAAa,QAAmB,EAAE,UAAU,UAAU,CAAC,CAAC,EAAE;;;;;AAM1D,MAAa,QACX,cACe,EACf,UAAU,UAAU,OAAO,YAAY,WAAW,WAAW,OAAO,UAAU,QAAQ,CAAC,EACzF;;;;;;;AAQA,MAAa,SAAoB,KAAK,cAAc;;;;;AAMpD,MAAa,OAAO,MAAiB,QAAgB,cAAiC;CACpF,OAAO,EAAE,UAAU,UAAU,CAAC,GAAG,KAAK,UAAU,CAAC,QAAQ,SAAS,CAAC,CAAC,EAAE;AACxE;;;;;;;AAQA,MAAa,SAAS,MAAiB,UAAgC,EACrE,UAAU,UAAU,CAAC,GAAG,KAAK,UAAU,GAAG,KAAK,QAAQ,CAAC,EAC1D;;;;;AAMA,MAAa,OAAO,MAAiB,WACnC,OAAO,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC;;;;;;;AAQhD,MAAa,UAAU,MAAiB,UAA4C;CAClF,MAAM,IAAI,MAAM,QAAQ,GAAG;CAC3B,IAAI,MAAM,IAAI,OAAO,OAAO,KAAK;CACjC,MAAM,KAAK,KAAK,SAAS,IAAI,MAAM,MAAM,GAAG,CAAC,CAAC;CAC9C,OAAO,OAAO,KAAA,IAAY,OAAO,KAAK,IAAI,OAAO,KAAK,IAAI,UAAU,KAAK,MAAM,MAAM,IAAI,CAAC,CAAC,CAAC;AAC9F;AAEA,MAAM,kBACJ;;;;;;;;AASF,MAAa,WACX,MACA,QAC6C;CAC7C,MAAM,QAAQ,UAAU,SAAS,GAAG,IAAI,MAAM,IAAI;CAClD,IAAI,OAAiD,OAAO,KAAK;CACjE,IAAI,aAAa;CACjB,KAAK,SAAS,SAAS,IAAI,WAAW;EACpC,IAAI,GAAG,SAAS,cAAc,MAAM,WAAW,EAAE,GAAG;GAClD,MAAM,QAAQ,MAAM,MAAM,GAAG,MAAM;GACnC,IAAI,UAAU,MAAM,gBAAgB,KAAK,KAAK,GAAG;IAC/C,OAAO,OAAO,KAAK,CAAC,QAAQ,KAAK,CAAC;IAClC,aAAa,GAAG;GAClB;EACF;CACF,CAAC;CACD,OAAO;AACT"}

package/dist/PrefixMap-BMlXrWNd.d.mts

@@ -0,0 +1,64 @@
+import { d as NamedNode } from "./Term-B_4ezyXq.mjs";
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+declare namespace PrefixMap_d_exports {
+  export { PrefixMap, common, compact, empty, expand, get, make, merge, set };
+}
+/**
+ * @since 0.1.0
+ * @category models
+ */
+interface PrefixMap {
+  readonly prefixes: ReadonlyMap<string, string>;
+}
+/**
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const empty: PrefixMap;
+/**
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const make: (prefixes: Record.ReadonlyRecord<string, string> | Iterable<readonly [string, string]>) => PrefixMap;
+/**
+ * A prefix map containing `rdf`, `rdfs`, `xsd` and `owl`.
+ *
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const common: PrefixMap;
+/**
+ * @since 0.1.0
+ * @category combinators
+ */
+declare const set: (self: PrefixMap, prefix: string, namespace: string) => PrefixMap;
+/**
+ * Merges two prefix maps; entries in `that` win.
+ *
+ * @since 0.1.0
+ * @category combinators
+ */
+declare const merge: (self: PrefixMap, that: PrefixMap) => PrefixMap;
+/**
+ * @since 0.1.0
+ * @category getters
+ */
+declare const get: (self: PrefixMap, prefix: string) => Option.Option<string>;
+/**
+ * Expands a prefixed name (`prefix:local`) to an IRI.
+ *
+ * @since 0.1.0
+ * @category combinators
+ */
+declare const expand: (self: PrefixMap, curie: string) => Option.Option<NamedNode>;
+/**
+ * Compacts an IRI to `[prefix, local]` using the longest matching namespace,
+ * if the local part is a valid Turtle/SPARQL `PN_LOCAL` without escapes.
+ *
+ * @since 0.1.0
+ * @category combinators
+ */
+declare const compact: (self: PrefixMap, iri: string | NamedNode) => Option.Option<readonly [string, string]>;
+export { empty as a, make as c, compact as i, merge as l, PrefixMap_d_exports as n, expand as o, common as r, get as s, PrefixMap as t, set as u };
+//# sourceMappingURL=PrefixMap-BMlXrWNd.d.mts.map

package/dist/PrefixMap.d.mts

@@ -0,0 +1,2 @@
+import { a as empty, c as make, i as compact, l as merge, o as expand, r as common, s as get, t as PrefixMap, u as set } from "./PrefixMap-BMlXrWNd.mjs";
+export { PrefixMap, common, compact, empty, expand, get, make, merge, set };

package/dist/PrefixMap.mjs

@@ -0,0 +1 @@
+export { n as common, r as compact, i as empty, a as expand, o as get, s as make, c as merge, l as set } from "./PrefixMap-BHFPDLO-.mjs";

package/dist/Processor-CMmecFsb.mjs

@@ -0,0 +1,198 @@
+import { t as __exportAll } from "./rolldown-runtime-D8jQpDG7.mjs";
+import { u as withoutFragment } from "./Iri-Cr92gsQV.mjs";
+import { d as warning, u as make } from "./Report-XHs8htzK.mjs";
+import { A as normalize, C as dialectOfTable, S as describes, j as resolve, s as MetadataError, y as decode } from "./Metadata-D4HsQNXr.mjs";
+import { c as validateKeys, i as checkForeignKeyTargets, l as expand, r as annotate } from "./Table-BGgm9nbM.mjs";
+import * as Arr from "effect/Array";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as Effect from "effect/Effect";
+import * as Record from "effect/Record";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+// src/csvw/Processor.ts
+/**
+* CSVW processing (Tabular Data Model §Processing Tables): from a tabular
+* data file or a metadata file to an annotated table group and its
+* validation report. Tables and metadata documents are read through the
+* `Loader` service, which hands back already-parsed rows (this package has no
+* CSV scanner of its own).
+*
+* Metadata is taken from, in order: the user's metadata, the default
+* locations (`{+url}-metadata.json`, `csv-metadata.json`) through the
+* `Loader`, and the embedded metadata. HTTP `Link` headers and a site-wide
+* `/.well-known/csvm` configuration are not consulted.
+*
+* @since 0.1.0
+*/
+var Processor_exports = /* @__PURE__ */ __exportAll({
+	LoadError: () => LoadError,
+	Loader: () => Loader,
+	defaultLocations: () => defaultLocations,
+	fromMetadata: () => fromMetadata,
+	fromTabular: () => fromTabular,
+	layerSources: () => layerSources,
+	makeLoader: () => makeLoader,
+	processGroup: () => processGroup
+});
+/**
+* A table or metadata document that could not be read.
+*
+* @since 0.1.0
+* @category errors
+*/
+var LoadError = class extends Schema.TaggedError()("LoadError", {
+	message: Schema.String,
+	url: Schema.String
+}) {};
+/**
+* Reads the resources CSVW processing needs: a table's rows, parsed with its
+* dialect, and a metadata document's text (`None` when there is none at that
+* URL, as when probing default locations).
+*
+* @since 0.1.0
+* @category services
+*/
+var Loader = class extends Context.Service()("@thomasfosterau/effect-rdf/csvw/Loader") {};
+/**
+* A `Loader` over already-parsed tables and metadata documents held in
+* memory, keyed by URL (a table's dialect is not used: its rows are already
+* split).
+*
+* @since 0.1.0
+* @category constructors
+*/
+const makeLoader = (sources, documents = {}) => Loader.of({
+	table: (url) => Option.match(Arr.findFirst(sources, (s) => normalize(s.url) === normalize(url)), {
+		onNone: () => Effect.fail(new LoadError({
+			message: `no table at ${url}`,
+			url
+		})),
+		onSome: (s) => Effect.succeed(s.rows)
+	}),
+	document: (url) => Effect.succeed(Record.get(documents, url))
+});
+/**
+* `makeLoader` as a layer.
+*
+* @since 0.1.0
+* @category layers
+*/
+const layerSources = (sources, documents = {}) => Layer.succeed(Loader, makeLoader(sources, documents));
+/**
+* The default metadata locations for a tabular data file
+* (`{+url}-metadata.json`, then `csv-metadata.json`), resolved against it.
+*
+* @since 0.1.0
+* @category locating
+*/
+const defaultLocations = (url) => {
+	const base = withoutFragment(url);
+	return Arr.map(["{+url}-metadata.json", "csv-metadata.json"], (template) => resolve(expand(template, { url: base }), base));
+};
+const fetchWith = (loader) => (url) => loader.document(url).pipe(Effect.mapError((e) => new MetadataError({
+	message: e.message,
+	url
+})), Effect.flatMap(Option.match({
+	onNone: () => Effect.fail(new MetadataError({
+		message: `no document at ${url}`,
+		url
+	})),
+	onSome: Effect.succeed
+})));
+/**
+* Annotates every table of a normalized table group, reading each through
+* the `Loader`, and checks its keys.
+*
+* @since 0.1.0
+* @category processing
+*/
+const processGroup = Effect.fnUntraced(function* (metadata, warnings, options = {}) {
+	const loader = yield* Loader;
+	const annotated = yield* Effect.forEach(metadata.tables, (table) => Effect.map(loader.table(table.url, dialectOfTable(metadata, table)), (rows) => annotate(metadata, table, {
+		url: table.url,
+		rows
+	}, options)), { concurrency: 1 });
+	const tables = Arr.map(annotated, (a) => a.table);
+	const targetErrors = checkForeignKeyTargets(tables);
+	if (Arr.isReadonlyArrayNonEmpty(targetErrors)) return yield* new MetadataError({ message: targetErrors[0] });
+	const keys = options.validate === true ? validateKeys(tables) : [];
+	return {
+		group: {
+			id: Option.fromNullishOr(metadata.id),
+			notes: metadata.notes,
+			common: metadata.common,
+			tables
+		},
+		metadata,
+		report: make([
+			...warnings,
+			...Arr.flatMap(annotated, (a) => a.issues),
+			...keys
+		])
+	};
+});
+/**
+* Processes starting from a metadata document: decodes it (fetching any
+* referenced schemas and dialects through the `Loader`) and annotates every
+* table it describes.
+*
+* @since 0.1.0
+* @category processing
+*/
+const fromMetadata = Effect.fn("Processor.fromMetadata")(function* (url, text, options = {}) {
+	const loader = yield* Loader;
+	const decoded = yield* decode(text, url, fetchWith(loader));
+	return yield* processGroup(decoded.group, decoded.warnings, options);
+});
+const embeddedOnly = (url) => ({
+	tables: [{
+		url,
+		notes: [],
+		isSuppressed: false,
+		transformations: [],
+		inherited: {},
+		common: {}
+	}],
+	notes: [],
+	transformations: [],
+	inherited: {},
+	common: {}
+});
+/**
+* Processes starting from a tabular data file: uses the user's metadata if
+* given, else the first metadata document at a default location that
+* describes the file, else the file's embedded metadata.
+*
+* @since 0.1.0
+* @category processing
+*/
+const fromTabular = Effect.fn("Processor.fromTabular")(function* (url, options = {}) {
+	const loader = yield* Loader;
+	const fetch = fetchWith(loader);
+	if (options.metadata !== void 0) {
+		const decoded = yield* decode(options.metadata.text, options.metadata.url, fetch);
+		return yield* processGroup(decoded.group, decoded.warnings, options);
+	}
+	const candidates = options.locate === false ? [] : defaultLocations(url);
+	const located = yield* Effect.reduce(candidates, () => ({
+		found: Option.none(),
+		warnings: []
+	}), (acc, candidate) => Option.isSome(acc.found) ? Effect.succeed(acc) : Effect.flatMap(loader.document(candidate), (doc) => Option.match(doc, {
+		onNone: () => Effect.succeed(acc),
+		onSome: (text) => Effect.map(decode(text, candidate, fetch), (decoded) => describes(decoded.group, url) ? {
+			found: Option.some(decoded),
+			warnings: acc.warnings
+		} : {
+			found: Option.none(),
+			warnings: Arr.append(acc.warnings, warning(`${candidate} does not describe ${url}`, { table: candidate }))
+		})
+	})));
+	return yield* Option.match(located.found, {
+		onNone: () => processGroup(embeddedOnly(url), located.warnings, options),
+		onSome: (decoded) => processGroup(decoded.group, [...located.warnings, ...decoded.warnings], options)
+	});
+});
+export { fromMetadata as a, makeLoader as c, defaultLocations as i, processGroup as l, Loader as n, fromTabular as o, Processor_exports as r, layerSources as s, LoadError as t };
+
+//# sourceMappingURL=Processor-CMmecFsb.mjs.map

package/dist/Processor-CMmecFsb.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Processor-CMmecFsb.mjs","names":["Url.normalize","Iri.withoutFragment","Url.resolve","UriTemplate.expand","Metadata.MetadataError","Metadata.dialectOfTable","Table.annotate","Table.checkForeignKeyTargets","Table.validateKeys","Report.make","Metadata.decode","Metadata.describes","Report.warning"],"sources":["../src/csvw/Processor.ts"],"sourcesContent":["/**\n * CSVW processing (Tabular Data Model §Processing Tables): from a tabular\n * data file or a metadata file to an annotated table group and its\n * validation report. Tables and metadata documents are read through the\n * `Loader` service, which hands back already-parsed rows (this package has no\n * CSV scanner of its own).\n *\n * Metadata is taken from, in order: the user's metadata, the default\n * locations (`{+url}-metadata.json`, `csv-metadata.json`) through the\n * `Loader`, and the embedded metadata. HTTP `Link` headers and a site-wide\n * `/.well-known/csvm` configuration are not consulted.\n *\n * @since 0.1.0\n */\nimport { Iri } from '../index.ts';\nimport * as Arr from 'effect/Array';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as Option from 'effect/Option';\nimport * as Record from 'effect/Record';\nimport * as Schema from 'effect/Schema';\nimport * as Metadata from './Metadata.ts';\nimport * as Report from './Report.ts';\nimport * as Table from './Table.ts';\nimport * as UriTemplate from './internal/uriTemplate.ts';\nimport * as Url from './internal/url.ts';\n\n/**\n * A table or metadata document that could not be read.\n *\n * @since 0.1.0\n * @category errors\n */\nexport class LoadError extends Schema.TaggedError<LoadError>()('LoadError', {\n  message: Schema.String,\n  url: Schema.String,\n}) {}\n\n/**\n * Reads the resources CSVW processing needs: a table's rows, parsed with its\n * dialect, and a metadata document's text (`None` when there is none at that\n * URL, as when probing default locations).\n *\n * @since 0.1.0\n * @category services\n */\nexport class Loader extends Context.Service<\n  Loader,\n  {\n    readonly table: (\n      url: string,\n      dialect: Metadata.Dialect,\n    ) => Effect.Effect<ReadonlyArray<ReadonlyArray<string>>, LoadError>;\n    readonly document: (url: string) => Effect.Effect<Option.Option<string>, LoadError>;\n  }\n>()('@thomasfosterau/effect-rdf/csvw/Loader') {}\n\n/**\n * A `Loader` over already-parsed tables and metadata documents held in\n * memory, keyed by URL (a table's dialect is not used: its rows are already\n * split).\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const makeLoader = (\n  sources: ReadonlyArray<Table.Source>,\n  documents: Readonly<Record<string, string>> = {},\n): Loader['Service'] =>\n  Loader.of({\n    table: (url) =>\n      Option.match(\n        Arr.findFirst(sources, (s) => Url.normalize(s.url) === Url.normalize(url)),\n        {\n          onNone: () => Effect.fail(new LoadError({ message: `no table at ${url}`, url })),\n          onSome: (s) => Effect.succeed(s.rows),\n        },\n      ),\n    document: (url) => Effect.succeed(Record.get(documents, url)),\n  });\n\n/**\n * `makeLoader` as a layer.\n *\n * @since 0.1.0\n * @category layers\n */\nexport const layerSources = (\n  sources: ReadonlyArray<Table.Source>,\n  documents: Readonly<Record<string, string>> = {},\n): Layer.Layer<Loader> => Layer.succeed(Loader, makeLoader(sources, documents));\n\n/**\n * Options for processing.\n *\n * @since 0.1.0\n * @category models\n */\nexport interface Options extends Table.Options {\n  /** User-supplied (overriding) metadata: its URL and text. */\n  readonly metadata?: { readonly url: string; readonly text: string } | undefined;\n  /** Look for metadata at the default locations (default `true`). */\n  readonly locate?: boolean | undefined;\n}\n\n/**\n * The result of processing: the annotated group, the metadata it was\n * annotated with and the validation report.\n *\n * @since 0.1.0\n * @category models\n */\nexport interface Processed {\n  readonly group: Table.TableGroup;\n  readonly metadata: Metadata.TableGroup;\n  readonly report: Report.Report;\n}\n\n/**\n * The default metadata locations for a tabular data file\n * (`{+url}-metadata.json`, then `csv-metadata.json`), resolved against it.\n *\n * @since 0.1.0\n * @category locating\n */\nexport const defaultLocations = (url: string): ReadonlyArray<string> => {\n  const base = Iri.withoutFragment(url);\n  return Arr.map(['{+url}-metadata.json', 'csv-metadata.json'], (template) =>\n    Url.resolve(UriTemplate.expand(template, { url: base }), base),\n  );\n};\n\nconst fetchWith =\n  (loader: Loader['Service']): Metadata.Fetch =>\n  (url) =>\n    loader.document(url).pipe(\n      Effect.mapError((e) => new Metadata.MetadataError({ message: e.message, url })),\n      Effect.flatMap(\n        Option.match({\n          onNone: () =>\n            Effect.fail(new Metadata.MetadataError({ message: `no document at ${url}`, url })),\n          onSome: Effect.succeed,\n        }),\n      ),\n    );\n\n/**\n * Annotates every table of a normalized table group, reading each through\n * the `Loader`, and checks its keys.\n *\n * @since 0.1.0\n * @category processing\n */\nexport const processGroup = Effect.fnUntraced(function* (\n  metadata: Metadata.TableGroup,\n  warnings: ReadonlyArray<Report.Issue>,\n  options: Table.Options = {},\n): Effect.fn.Return<Processed, Metadata.MetadataError | LoadError, Loader> {\n  const loader = yield* Loader;\n  const annotated = yield* Effect.forEach(\n    metadata.tables,\n    (table) =>\n      Effect.map(loader.table(table.url, Metadata.dialectOfTable(metadata, table)), (rows) =>\n        Table.annotate(metadata, table, { url: table.url, rows }, options),\n      ),\n    { concurrency: 1 },\n  );\n  const tables = Arr.map(annotated, (a) => a.table);\n  const targetErrors = Table.checkForeignKeyTargets(tables);\n  if (Arr.isReadonlyArrayNonEmpty(targetErrors))\n    return yield* new Metadata.MetadataError({ message: targetErrors[0] });\n  const keys = options.validate === true ? Table.validateKeys(tables) : [];\n  return {\n    group: {\n      id: Option.fromNullishOr(metadata.id),\n      notes: metadata.notes,\n      common: metadata.common,\n      tables,\n    },\n    metadata,\n    report: Report.make([...warnings, ...Arr.flatMap(annotated, (a) => a.issues), ...keys]),\n  };\n});\n\n/**\n * Processes starting from a metadata document: decodes it (fetching any\n * referenced schemas and dialects through the `Loader`) and annotates every\n * table it describes.\n *\n * @since 0.1.0\n * @category processing\n */\nexport const fromMetadata = Effect.fn('Processor.fromMetadata')(function* (\n  url: string,\n  text: string,\n  options: Table.Options = {},\n): Effect.fn.Return<Processed, Metadata.MetadataError | LoadError, Loader> {\n  const loader = yield* Loader;\n  const decoded = yield* Metadata.decode(text, url, fetchWith(loader));\n  return yield* processGroup(decoded.group, decoded.warnings, options);\n});\n\ninterface Located {\n  readonly found: Option.Option<Metadata.Decoded>;\n  readonly warnings: ReadonlyArray<Report.Issue>;\n}\n\nconst embeddedOnly = (url: string): Metadata.TableGroup => ({\n  tables: [\n    {\n      url,\n      notes: [],\n      isSuppressed: false,\n      transformations: [],\n      inherited: {},\n      common: {},\n    },\n  ],\n  notes: [],\n  transformations: [],\n  inherited: {},\n  common: {},\n});\n\n/**\n * Processes starting from a tabular data file: uses the user's metadata if\n * given, else the first metadata document at a default location that\n * describes the file, else the file's embedded metadata.\n *\n * @since 0.1.0\n * @category processing\n */\nexport const fromTabular = Effect.fn('Processor.fromTabular')(function* (\n  url: string,\n  options: Options = {},\n): Effect.fn.Return<Processed, Metadata.MetadataError | LoadError, Loader> {\n  const loader = yield* Loader;\n  const fetch = fetchWith(loader);\n  if (options.metadata !== undefined) {\n    const decoded = yield* Metadata.decode(options.metadata.text, options.metadata.url, fetch);\n    return yield* processGroup(decoded.group, decoded.warnings, options);\n  }\n  const candidates = options.locate === false ? [] : defaultLocations(url);\n  const located = yield* Effect.reduce(\n    candidates,\n    (): Located => ({ found: Option.none(), warnings: [] }),\n    (acc, candidate): Effect.Effect<Located, Metadata.MetadataError | LoadError> =>\n      Option.isSome(acc.found)\n        ? Effect.succeed(acc)\n        : Effect.flatMap(loader.document(candidate), (doc) =>\n            Option.match(doc, {\n              onNone: () => Effect.succeed(acc),\n              onSome: (text) =>\n                Effect.map(Metadata.decode(text, candidate, fetch), (decoded) =>\n                  Metadata.describes(decoded.group, url)\n                    ? { found: Option.some(decoded), warnings: acc.warnings }\n                    : {\n                        found: Option.none(),\n                        warnings: Arr.append(\n                          acc.warnings,\n                          Report.warning(`${candidate} does not describe ${url}`, {\n                            table: candidate,\n                          }),\n                        ),\n                      },\n                ),\n            }),\n          ),\n  );\n  return yield* Option.match(located.found, {\n    onNone: () => processGroup(embeddedOnly(url), located.warnings, options),\n    onSome: (decoded) =>\n      processGroup(decoded.group, [...located.warnings, ...decoded.warnings], options),\n  });\n});\n"],"mappings":"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"}