@crockery/fellowship-components 0.1.0 → 0.4.0

package/README.md

@@ -11,7 +11,7 @@ npm install @crockery/fellowship-components
 pnpm add @crockery/fellowship-components
 ```
 
-The data package is installed automatically. Components import their datasets lazily, while image
+The data package is installed automatically. Components use its shared lazy client, while image
 URLs use the installed data package's version-pinned CDN by default. Your application lockfile
 therefore selects both the exact data and its matching assets.
 
@@ -94,8 +94,10 @@ request. See `THIRD_PARTY_LICENSES.md` for the SIL Open Font License notice.
 
 ## Data and asset versions
 
-The library accepts `@crockery/fellowship-data@^1.0.0`. Commit the consuming application's
-lockfile when reproducible data and image updates matter.
+The next release targets `@crockery/fellowship-data@^2.0.0` and requires manifest schema 2. Until
+Data 2.0 is published, this repository remains installable from the last published Data release;
+the release-dispatch automation updates the dependency and lockfile after publication. Commit a
+consuming application's lockfile when reproducible data and image updates matter.
 
 Dataset JSON stays out of the component library's initial JavaScript path and published tarball.
 Each data-driven component supports:
@@ -106,6 +108,11 @@ Each data-driven component supports:
 
 See the relevant component document for the provider contract.
 
+The legacy component-specific data-source types and package factories remain available as
+deprecated structural adapters for the 0.x release line. New integrations should use
+`createPackageFellowshipDataClient` from `@crockery/fellowship-data/client` and pass the relevant
+client methods through `dataSource`.
+
 ## Development
 
 ```sh

package/RELEASING.md

@@ -8,48 +8,11 @@ pnpm changeset
 ```
 
 The Release workflow maintains a `changeset-release/main` pull request. Merging that pull request
-publishes only when the `NPM_TRUSTED_PUBLISHING_READY` repository variable is `true`.
+publishes the new version to npm automatically through trusted publishing.
 
-## First public release
+## Trusted publishing
 
-Keep `NPM_TRUSTED_PUBLISHING_READY` unset or set to `false` while bootstrapping the package.
-
-1. Enable **Allow GitHub Actions to create and approve pull requests** under **Settings → Actions →
-   General → Workflow permissions**.
-2. Run the Release workflow so Changesets creates or refreshes its version pull request.
-3. Review the version, changelog, package checks, and tarball contents, then merge the version pull
-   request.
-4. From a clean checkout of that exact `main` commit, publish the first release:
-
-   ```sh
-   git pull --ff-only
-   pnpm install --frozen-lockfile
-   pnpm lint
-   pnpm format:check
-   pnpm typecheck
-   pnpm test
-   pnpm test:browser:smoke
-   pnpm ladle:build
-   pnpm pack:check
-   npm login
-   npm whoami
-   npm publish --access public --tag latest
-   ```
-
-5. Verify the published package before tagging it:
-
-   ```sh
-   npm view @crockery/fellowship-components@0.2.0
-   git tag -a "@crockery/fellowship-components@0.2.0" -m "@crockery/fellowship-components@0.2.0"
-   git push origin "@crockery/fellowship-components@0.2.0"
-   ```
-
-Create a matching GitHub release from the generated changelog. The manually bootstrapped release
-does not carry CI provenance.
-
-## Enable trusted publishing
-
-After the package exists on npm, configure its npm trusted publisher with:
+Trusted publishing is enabled on npm with:
 
 - Provider: GitHub Actions
 - Organization or user: `Crockery`
@@ -58,17 +21,18 @@ After the package exists on npm, configure its npm trusted publisher with:
 - Environment: none
 - Allowed action: `npm publish`
 
-Set the GitHub repository variable `NPM_TRUSTED_PUBLISHING_READY` to `true`. Do not add an
-`NPM_TOKEN`; npm authenticates the release job through its GitHub OIDC identity and creates
-provenance automatically.
+The GitHub repository variable `NPM_TRUSTED_PUBLISHING_READY` is set to `true`. Keep it enabled and
+do not add an `NPM_TOKEN`: npm authenticates the release job through its GitHub OIDC identity and
+creates provenance automatically. Maintainers do not need to run `npm login`, `npm publish`, or
+create release tags manually.
 
 ## Routine releases
 
 1. Merge consumer-facing changes and their changesets into `main`.
 2. Review the Changesets version pull request, including its generated changelog.
 3. Merge the version pull request after CI succeeds.
-4. Confirm the Release workflow publishes the expected npm version, tag, GitHub release, and npm
-   provenance statement.
+4. Confirm the Release workflow publishes the expected npm version and creates its tag, GitHub
+   release, and npm provenance statement.
 
 Never reuse a version number. If a release is defective, publish a corrective patch. Deprecate a
 bad version with `npm deprecate` when consumers need an explicit warning; unpublish only when npm's

package/dist/chunks/data-source-XbksqUrw.js

@@ -0,0 +1,9 @@
+import { FellowshipDataError as e } from "@crockery/fellowship-data/client";
+//#region src/data/data-source.ts
+var t = 2, n = (n) => {
+	if (n !== t) throw new e("unsupported-schema", `Unsupported fellowship-data schema version: ${String(n)}.`);
+};
+//#endregion
+export { n, e as t };
+
+//# sourceMappingURL=data-source-XbksqUrw.js.map

package/dist/chunks/data-source-XbksqUrw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-XbksqUrw.js","names":[],"sources":["../../src/data/data-source.ts"],"sourcesContent":["import { FellowshipDataError } from \"@crockery/fellowship-data/client\";\nexport { FellowshipDataError };\nexport type {\n  DungeonMapData,\n  FellowshipDataErrorCode,\n} from \"@crockery/fellowship-data/client\";\n\nimport type { FellowshipDataClient } from \"@crockery/fellowship-data/client\";\n\nconst supportedSchemaVersion = 2;\n\nexport const assertSupportedFellowshipDataSchema = (schemaVersion: number): void => {\n  if (schemaVersion === supportedSchemaVersion) return;\n\n  throw new FellowshipDataError(\n    \"unsupported-schema\",\n    `Unsupported fellowship-data schema version: ${String(schemaVersion)}.`,\n  );\n};\n\n/** @deprecated Use the corresponding `FellowshipDataClient` methods. */\nexport type FellowshipDataSource = Pick<FellowshipDataClient, \"loadDungeon\" | \"resolveAssetUrl\">;\n"],"mappings":";;AASA,IAAM,IAAyB,GAElB,KAAuC,MAAgC;CAC9E,UAAkB,GAEtB,MAAM,IAAI,EACR,sBACA,+CAA+C,OAAO,CAAa,EAAE,EACvE;AACF"}

package/dist/chunks/decorate-B_ZTN9li.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorate-B_ZTN9li.js","names":[],"sources":["../../src/styles/field-manual.styles.ts","../../node_modules/.pnpm/@fontsource+ibm-plex-mono@5.2.7/node_modules/@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-500-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-mono@5.2.7/node_modules/@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-600-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-400-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-500-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-600-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-700-normal.woff2?fellowship-font-url","../../src/styles/field-manual-fonts.ts"],"sourcesContent":["import { css } from \"lit\";\n\n/** Shared internal aliases for the public Expedition Field Manual theme tokens. */\nexport const fieldManualStyles = css`\n  :host {\n    --_fellowship-field-canvas: var(--fellowship-field-canvas, #0b0f13);\n    --_fellowship-field-surface: var(--fellowship-field-surface, #10161c);\n    --_fellowship-field-surface-raised: var(--fellowship-field-surface-raised, #151c23);\n    --_fellowship-field-inset: var(--fellowship-field-inset, #080c10);\n    --_fellowship-field-ink: var(--fellowship-field-ink, #f1eee5);\n    --_fellowship-field-muted: var(--fellowship-field-muted, #b7b4aa);\n    --_fellowship-field-tertiary: var(--fellowship-field-tertiary, #858a8e);\n    --_fellowship-field-border: var(\n      --fellowship-field-border,\n      rgb(241 238 229 / 10%)\n    );\n    --_fellowship-field-border-strong: var(\n      --fellowship-field-border-strong,\n      rgb(241 238 229 / 18%)\n    );\n    --_fellowship-field-accent: var(--fellowship-field-accent, #69c4d4);\n    --_fellowship-field-focus: var(--fellowship-field-focus, #a8e6ee);\n    --_fellowship-field-ember: var(--fellowship-field-ember, #d9784c);\n    --_fellowship-field-brass: var(--fellowship-field-brass, #c1a36a);\n    --_fellowship-field-font-family: var(\n      --fellowship-field-font-family,\n      \"Fellowship Field\",\n      \"Arial Narrow\",\n      sans-serif\n    );\n    --_fellowship-field-mono-font-family: var(\n      --fellowship-field-mono-font-family,\n      \"Fellowship Tactical\",\n      ui-monospace,\n      monospace\n    );\n    --_fellowship-field-radius: var(--fellowship-field-radius, 6px);\n  }\n`;\n","export default import.meta.ROLLUP_FILE_URL_P4DPfwIRieI8P6q8r4JZRw;","export default import.meta.ROLLUP_FILE_URL_VRAku6fjghkApIISiBWPzg;","export default import.meta.ROLLUP_FILE_URL_8HSUfh7cJHNFxCkInNzNXw;","export default import.meta.ROLLUP_FILE_URL_WPGYjwIlzWVNM1bYhOc83w;","export default import.meta.ROLLUP_FILE_URL_cn7IAAGY294pWGc7MpElVg;","export default import.meta.ROLLUP_FILE_URL_FKNdLzKnlftW3t_gzo81yw;","import mono500Url from \"@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-500-normal.woff2?url\";\nimport mono600Url from \"@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-600-normal.woff2?url\";\nimport field400Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-400-normal.woff2?url\";\nimport field500Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-500-normal.woff2?url\";\nimport field600Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-600-normal.woff2?url\";\nimport field700Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-700-normal.woff2?url\";\n\ninterface FieldManualFontAsset {\n  readonly family: \"Fellowship Field\" | \"Fellowship Tactical\";\n  readonly weight: \"400\" | \"500\" | \"600\" | \"700\";\n  readonly url: string;\n}\n\nconst fieldManualFontAssets: readonly FieldManualFontAsset[] = [\n  { family: \"Fellowship Field\", weight: \"400\", url: field400Url },\n  { family: \"Fellowship Field\", weight: \"500\", url: field500Url },\n  { family: \"Fellowship Field\", weight: \"600\", url: field600Url },\n  { family: \"Fellowship Field\", weight: \"700\", url: field700Url },\n  { family: \"Fellowship Tactical\", weight: \"500\", url: mono500Url },\n  { family: \"Fellowship Tactical\", weight: \"600\", url: mono600Url },\n];\n\nconst installedDocuments = new WeakSet<Document>();\n\n/** Makes the bundled field-manual faces available to a component's owner document. */\nexport const installFieldManualFonts = (document: Document): void => {\n  if (installedDocuments.has(document)) {\n    return;\n  }\n\n  const FontFaceConstructor = document.defaultView?.FontFace;\n  if (!FontFaceConstructor || !document.fonts) {\n    return;\n  }\n\n  const faces = fieldManualFontAssets.map(\n    ({ family, weight, url }) =>\n      new FontFaceConstructor(family, `url(${JSON.stringify(url)}) format(\"woff2\")`, {\n        display: \"swap\",\n        style: \"normal\",\n        weight,\n      }),\n  );\n  for (const face of faces) {\n    document.fonts.add(face);\n  }\n  installedDocuments.add(document);\n};\n"],"x_google_ignoreList":[1,2,3,4,5,6],"mappings":";;AAGA,IAAa,IAAoB,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GCHpC,IAAA,IAAA,IAAA,2DAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,2DAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCaM,IAAyD;CAC7D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAuB,QAAQ;EAAO,KAAK;CAAW;CAChE;EAAE,QAAQ;EAAuB,QAAQ;EAAO,KAAK;CAAW;AAClE,GAEM,oBAAqB,IAAI,QAAkB,GAGpC,KAA2B,MAA6B;CACnE,IAAI,EAAmB,IAAI,CAAQ,GACjC;CAGF,IAAM,IAAsB,EAAS,aAAa;CAClD,IAAI,CAAC,KAAuB,CAAC,EAAS,OACpC;CAGF,IAAM,IAAQ,EAAsB,KACjC,EAAE,WAAQ,WAAQ,aACjB,IAAI,EAAoB,GAAQ,OAAO,KAAK,UAAU,CAAG,EAAE,oBAAoB;EAC7E,SAAS;EACT,OAAO;EACP;CACF,CAAC,CACL;CACA,KAAK,IAAM,KAAQ,GACjB,EAAS,MAAM,IAAI,CAAI;CAEzB,EAAmB,IAAI,CAAQ;AACjC"}
+{"version":3,"file":"decorate-B_ZTN9li.js","names":[],"sources":["../../src/styles/field-manual.styles.ts","../../node_modules/.pnpm/@fontsource+ibm-plex-mono@5.2.7/node_modules/@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-500-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-mono@5.2.7/node_modules/@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-600-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-400-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-500-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-600-normal.woff2?fellowship-font-url","../../node_modules/.pnpm/@fontsource+ibm-plex-sans-condensed@5.2.8/node_modules/@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-700-normal.woff2?fellowship-font-url","../../src/styles/field-manual-fonts.ts"],"sourcesContent":["import { css } from \"lit\";\n\n/** Shared internal aliases for the public Expedition Field Manual theme tokens. */\nexport const fieldManualStyles = css`\n  :host {\n    --_fellowship-field-canvas: var(--fellowship-field-canvas, #0b0f13);\n    --_fellowship-field-surface: var(--fellowship-field-surface, #10161c);\n    --_fellowship-field-surface-raised: var(--fellowship-field-surface-raised, #151c23);\n    --_fellowship-field-inset: var(--fellowship-field-inset, #080c10);\n    --_fellowship-field-ink: var(--fellowship-field-ink, #f1eee5);\n    --_fellowship-field-muted: var(--fellowship-field-muted, #b7b4aa);\n    --_fellowship-field-tertiary: var(--fellowship-field-tertiary, #858a8e);\n    --_fellowship-field-border: var(\n      --fellowship-field-border,\n      rgb(241 238 229 / 10%)\n    );\n    --_fellowship-field-border-strong: var(\n      --fellowship-field-border-strong,\n      rgb(241 238 229 / 18%)\n    );\n    --_fellowship-field-accent: var(--fellowship-field-accent, #69c4d4);\n    --_fellowship-field-focus: var(--fellowship-field-focus, #a8e6ee);\n    --_fellowship-field-ember: var(--fellowship-field-ember, #d9784c);\n    --_fellowship-field-brass: var(--fellowship-field-brass, #c1a36a);\n    --_fellowship-field-font-family: var(\n      --fellowship-field-font-family,\n      \"Fellowship Field\",\n      \"Arial Narrow\",\n      sans-serif\n    );\n    --_fellowship-field-mono-font-family: var(\n      --fellowship-field-mono-font-family,\n      \"Fellowship Tactical\",\n      ui-monospace,\n      monospace\n    );\n    --_fellowship-field-radius: var(--fellowship-field-radius, 6px);\n  }\n`;\n","export default import.meta.ROLLUP_FILE_URL_FKNdLzKnlftW3t_gzo81yw;","export default import.meta.ROLLUP_FILE_URL_P4DPfwIRieI8P6q8r4JZRw;","export default import.meta.ROLLUP_FILE_URL_WPGYjwIlzWVNM1bYhOc83w;","export default import.meta.ROLLUP_FILE_URL_cn7IAAGY294pWGc7MpElVg;","export default import.meta.ROLLUP_FILE_URL_8HSUfh7cJHNFxCkInNzNXw;","export default import.meta.ROLLUP_FILE_URL_VRAku6fjghkApIISiBWPzg;","import mono500Url from \"@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-500-normal.woff2?url\";\nimport mono600Url from \"@fontsource/ibm-plex-mono/files/ibm-plex-mono-latin-600-normal.woff2?url\";\nimport field400Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-400-normal.woff2?url\";\nimport field500Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-500-normal.woff2?url\";\nimport field600Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-600-normal.woff2?url\";\nimport field700Url from \"@fontsource/ibm-plex-sans-condensed/files/ibm-plex-sans-condensed-latin-700-normal.woff2?url\";\n\ninterface FieldManualFontAsset {\n  readonly family: \"Fellowship Field\" | \"Fellowship Tactical\";\n  readonly weight: \"400\" | \"500\" | \"600\" | \"700\";\n  readonly url: string;\n}\n\nconst fieldManualFontAssets: readonly FieldManualFontAsset[] = [\n  { family: \"Fellowship Field\", weight: \"400\", url: field400Url },\n  { family: \"Fellowship Field\", weight: \"500\", url: field500Url },\n  { family: \"Fellowship Field\", weight: \"600\", url: field600Url },\n  { family: \"Fellowship Field\", weight: \"700\", url: field700Url },\n  { family: \"Fellowship Tactical\", weight: \"500\", url: mono500Url },\n  { family: \"Fellowship Tactical\", weight: \"600\", url: mono600Url },\n];\n\nconst installedDocuments = new WeakSet<Document>();\n\n/** Makes the bundled field-manual faces available to a component's owner document. */\nexport const installFieldManualFonts = (document: Document): void => {\n  if (installedDocuments.has(document)) {\n    return;\n  }\n\n  const FontFaceConstructor = document.defaultView?.FontFace;\n  if (!FontFaceConstructor || !document.fonts) {\n    return;\n  }\n\n  const faces = fieldManualFontAssets.map(\n    ({ family, weight, url }) =>\n      new FontFaceConstructor(family, `url(${JSON.stringify(url)}) format(\"woff2\")`, {\n        display: \"swap\",\n        style: \"normal\",\n        weight,\n      }),\n  );\n  for (const face of faces) {\n    document.fonts.add(face);\n  }\n  installedDocuments.add(document);\n};\n"],"x_google_ignoreList":[1,2,3,4,5,6],"mappings":";;AAGA,IAAa,IAAoB,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GCHpC,IAAA,IAAA,IAAA,2DAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,2DAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCAA,IAAA,IAAA,IAAA,qEAAA,OAAA,KAAA,GAAA,CAAA,CAAA,MCaM,IAAyD;CAC7D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAoB,QAAQ;EAAO,KAAK;CAAY;CAC9D;EAAE,QAAQ;EAAuB,QAAQ;EAAO,KAAK;CAAW;CAChE;EAAE,QAAQ;EAAuB,QAAQ;EAAO,KAAK;CAAW;AAClE,GAEM,oBAAqB,IAAI,QAAkB,GAGpC,KAA2B,MAA6B;CACnE,IAAI,EAAmB,IAAI,CAAQ,GACjC;CAGF,IAAM,IAAsB,EAAS,aAAa;CAClD,IAAI,CAAC,KAAuB,CAAC,EAAS,OACpC;CAGF,IAAM,IAAQ,EAAsB,KACjC,EAAE,WAAQ,WAAQ,aACjB,IAAI,EAAoB,GAAQ,OAAO,KAAK,UAAU,CAAG,EAAE,oBAAoB;EAC7E,SAAS;EACT,OAAO;EACP;CACF,CAAC,CACL;CACA,KAAK,IAAM,KAAQ,GACjB,EAAS,MAAM,IAAI,CAAI;CAEzB,EAAmB,IAAI,CAAQ;AACjC"}