@shayc/open-board-format 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @shayc/open-board-format
 
+## 0.6.1
+
+### Patch Changes
+
+- 19ad2c6: Condense multi-line JSDoc comments on schema type aliases to single lines and tidy doc wording in `obz.ts` and `test-utils.ts`. Documentation only — no API or behavior changes.
+
+## 0.6.0
+
+### Minor Changes
+
+- 0977576: Align board validation with the OBF spec:
+
+  - **Buttons:** absolute positioning now requires all of `top`, `left`, `width`, and `height` together (or none of them), matching the spec's "all four attributes are required for all buttons" rule. A partial positioning set (e.g. only `top`) is now rejected; grid-only buttons are unaffected.
+  - **OBZ manifest:** `paths.images` is now optional (consistent with `paths.sounds`), so manifests that omit empty image/sound maps validate. `paths.boards` remains required.
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -3,74 +3,50 @@ import { z } from "zod";
 //#region src/schema.d.ts
 /** Unique board-element identifier, coerced to a non-empty string. */
 declare const OBFIDSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>, z.ZodString>;
-/**
- * Unique board-element identifier, coerced to a non-empty string.
- * See {@link OBFIDSchema}.
- */
+/** Unique board-element identifier, coerced to a non-empty string. See {@link OBFIDSchema}. */
 type OBFID = z.infer<typeof OBFIDSchema>;
 /** Format version of the Open Board Format, e.g., `open-board-0.1`. */
 declare const OBFFormatVersionSchema: z.ZodString;
-/**
- * Format version of the Open Board Format, e.g., `open-board-0.1`.
- * See {@link OBFFormatVersionSchema}.
- */
+/** Format version of the Open Board Format, e.g., `open-board-0.1`. See {@link OBFFormatVersionSchema}. */
 type OBFFormatVersion = z.infer<typeof OBFFormatVersionSchema>;
 /**
  * Locale identifier, typically a BCP 47 language tag (e.g., `en`, `en-US`,
  * `fr-CA`). Not strictly validated — any string is accepted.
  */
 declare const OBFLocaleCodeSchema: z.ZodString;
-/**
- * Locale identifier, typically a BCP 47 language tag, e.g., `en`, `en-US`.
- * See {@link OBFLocaleCodeSchema}.
- */
+/** Locale identifier, typically a BCP 47 language tag, e.g., `en`, `en-US`. See {@link OBFLocaleCodeSchema}. */
 type OBFLocaleCode = z.infer<typeof OBFLocaleCodeSchema>;
 /**
  * Translations for a single locale, keyed by the source string,
  * e.g., `{ "hello": "hola" }`.
  */
 declare const OBFLocalizedStringsSchema: z.ZodRecord<z.ZodString, z.ZodString>;
-/**
- * Translations for a single locale, keyed by the source string.
- * See {@link OBFLocalizedStringsSchema}.
- */
+/** Translations for a single locale, keyed by the source string. See {@link OBFLocalizedStringsSchema}. */
 type OBFLocalizedStrings = z.infer<typeof OBFLocalizedStringsSchema>;
 /**
  * Locale-keyed dictionary of translated strings,
  * e.g., `{ en: { greeting: "Hello" }, fr: { greeting: "Bonjour" } }`.
  */
 declare const OBFStringsSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
-/**
- * Locale-keyed dictionary of translated strings.
- * See {@link OBFStringsSchema}.
- */
+/** Locale-keyed dictionary of translated strings. See {@link OBFStringsSchema}. */
 type OBFStrings = z.infer<typeof OBFStringsSchema>;
 /**
  * Spelling action: a `+` prefix followed by the text to append,
  * e.g., `+hello`.
  */
 declare const OBFSpellingActionSchema: z.ZodString;
-/**
- * Spelling action: a `+` prefix followed by the text to append, e.g., `+hello`.
- * See {@link OBFSpellingActionSchema}.
- */
+/** Spelling action: a `+` prefix followed by the text to append, e.g., `+hello`. See {@link OBFSpellingActionSchema}. */
 type OBFSpellingAction = z.infer<typeof OBFSpellingActionSchema>;
 /**
  * Specialty action prefixed with `:`, e.g., `:clear`.
  * Custom extensions use the `:ext_` prefix.
  */
 declare const OBFSpecialtyActionSchema: z.ZodString;
-/**
- * Specialty action prefixed with `:`, e.g., `:clear`.
- * See {@link OBFSpecialtyActionSchema}.
- */
+/** Specialty action prefixed with `:`, e.g., `:clear`. See {@link OBFSpecialtyActionSchema}. */
 type OBFSpecialtyAction = z.infer<typeof OBFSpecialtyActionSchema>;
 /** Union of spelling and specialty actions that a button can trigger. */
 declare const OBFButtonActionSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-/**
- * Union of spelling and specialty actions that a button can trigger.
- * See {@link OBFButtonActionSchema}.
- */
+/** Union of spelling and specialty actions that a button can trigger. See {@link OBFButtonActionSchema}. */
 type OBFButtonAction = z.infer<typeof OBFButtonActionSchema>;
 /** License terms and attribution for a resource. */
 declare const OBFLicenseSchema: z.ZodObject<{
@@ -81,10 +57,7 @@ declare const OBFLicenseSchema: z.ZodObject<{
   author_url: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>, z.ZodTransform<string | undefined, string>>>;
   author_email: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodEmail, z.ZodLiteral<"">]>, z.ZodTransform<string | undefined, string>>>;
 }, z.core.$loose>;
-/**
- * License terms and attribution for a resource.
- * See {@link OBFLicenseSchema}.
- */
+/** License terms and attribution for a resource. See {@link OBFLicenseSchema}. */
 type OBFLicense = z.infer<typeof OBFLicenseSchema>;
 /**
  * Common properties for media resources (images and sounds).
@@ -114,20 +87,14 @@ declare const OBFMediaSchema: z.ZodObject<{
     author_email: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodEmail, z.ZodLiteral<"">]>, z.ZodTransform<string | undefined, string>>>;
   }, z.core.$loose>>;
 }, z.core.$loose>;
-/**
- * Common properties for media resources (images and sounds).
- * See {@link OBFMediaSchema}.
- */
+/** Common properties for media resources (images and sounds). See {@link OBFMediaSchema}. */
 type OBFMedia = z.infer<typeof OBFMediaSchema>;
 /** Reference to a symbol in a proprietary symbol set (e.g., SymbolStix). */
 declare const OBFSymbolInfoSchema: z.ZodObject<{
   set: z.ZodString;
   filename: z.ZodString;
 }, z.core.$loose>;
-/**
- * Reference to a symbol in a proprietary symbol set.
- * See {@link OBFSymbolInfoSchema}.
- */
+/** Reference to a symbol in a proprietary symbol set. See {@link OBFSymbolInfoSchema}. */
 type OBFSymbolInfo = z.infer<typeof OBFSymbolInfoSchema>;
 /**
  * Image resource, extending {@link OBFMediaSchema} with optional
@@ -161,10 +128,7 @@ declare const OBFImageSchema: z.ZodObject<{
   width: z.ZodOptional<z.ZodNumber>;
   height: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
-/**
- * Image resource with optional symbol and dimension properties.
- * See {@link OBFImageSchema}.
- */
+/** Image resource with optional symbol and dimension properties. See {@link OBFImageSchema}. */
 type OBFImage = z.infer<typeof OBFImageSchema>;
 /**
  * Audio resource. Identical to {@link OBFMediaSchema} — no additional properties.
@@ -185,10 +149,7 @@ declare const OBFSoundSchema: z.ZodObject<{
     author_email: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodEmail, z.ZodLiteral<"">]>, z.ZodTransform<string | undefined, string>>>;
   }, z.core.$loose>>;
 }, z.core.$loose>;
-/**
- * Audio resource, identical to {@link OBFMedia}.
- * See {@link OBFSoundSchema}.
- */
+/** Audio resource, identical to {@link OBFMediaSchema}. See {@link OBFSoundSchema}. */
 type OBFSound = z.infer<typeof OBFSoundSchema>;
 /** Reference to another board, resolved by ID, path, or URL. */
 declare const OBFLoadBoardSchema: z.ZodObject<{
@@ -198,10 +159,7 @@ declare const OBFLoadBoardSchema: z.ZodObject<{
   url: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>, z.ZodTransform<string | undefined, string>>>;
   path: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
-/**
- * Reference to another board, resolved by ID, path, or URL.
- * See {@link OBFLoadBoardSchema}.
- */
+/** Reference to another board, resolved by ID, path, or URL. See {@link OBFLoadBoardSchema}. */
 type OBFLoadBoard = z.infer<typeof OBFLoadBoardSchema>;
 /**
  * Interactive element on a board, optionally linked to images, sounds, and actions.
@@ -228,10 +186,7 @@ declare const OBFButtonSchema: z.ZodObject<{
   width: z.ZodOptional<z.ZodNumber>;
   height: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
-/**
- * Interactive element on a board, optionally linked to images, sounds, and
- * actions. See {@link OBFButtonSchema}.
- */
+/** Interactive element on a board, optionally linked to images, sounds, and actions. See {@link OBFButtonSchema}. */
 type OBFButton = z.infer<typeof OBFButtonSchema>;
 /**
  * Row-and-column layout that arranges buttons by their IDs.
@@ -241,10 +196,7 @@ declare const OBFGridSchema: z.ZodObject<{
   columns: z.ZodNumber;
   order: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>, z.ZodString>, z.ZodNull]>>>;
 }, z.core.$loose>;
-/**
- * Row-and-column layout that arranges buttons by their IDs.
- * See {@link OBFGridSchema}.
- */
+/** Row-and-column layout that arranges buttons by their IDs. See {@link OBFGridSchema}. */
 type OBFGrid = z.infer<typeof OBFGridSchema>;
 /**
  * Root object of an `.obf` file: the complete definition of a single communication board.
@@ -331,10 +283,7 @@ declare const OBFBoardSchema: z.ZodObject<{
   }, z.core.$loose>>;
   strings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.core.$loose>;
-/**
- * The complete definition of a single communication board — root object of
- * an `.obf` file. See {@link OBFBoardSchema}.
- */
+/** Root object of an `.obf` file: the complete definition of a single communication board. See {@link OBFBoardSchema}. */
 type OBFBoard = z.infer<typeof OBFBoardSchema>;
 /**
  * Table of contents for an `.obz` package, mapping resource IDs to their archive paths.
@@ -344,14 +293,11 @@ declare const OBFManifestSchema: z.ZodObject<{
   root: z.ZodString;
   paths: z.ZodObject<{
     boards: z.ZodRecord<z.ZodString, z.ZodString>;
-    images: z.ZodRecord<z.ZodString, z.ZodString>;
+    images: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     sounds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   }, z.core.$loose>;
 }, z.core.$loose>;
-/**
- * Table of contents for an `.obz` package, mapping resource IDs to their
- * archive paths. See {@link OBFManifestSchema}.
- */
+/** Table of contents for an `.obz` package, mapping resource IDs to their archive paths. See {@link OBFManifestSchema}. */
 type OBFManifest = z.infer<typeof OBFManifestSchema>;
 //#endregion
 //#region src/errors.d.ts
@@ -520,9 +466,8 @@ declare function loadOBZ(file: File): Promise<ParsedOBZ>;
  * Decompress an OBZ archive and return its manifest, boards, and resources.
  *
  * @param archive - The OBZ archive as an `ArrayBuffer`.
- * @returns The parsed manifest, a map of board IDs to validated boards,
- *          the resolved root board, and a map of file paths to their
- *          binary content.
+ * @returns A {@link ParsedOBZ} with the archive's manifest, boards, root
+ *          board, and resources.
  *
  * @throws {@link OBFError}; branch on `info.code`: `"not-zip"`,
  *   `"unreadable-zip"`, `"missing-manifest"`, `"not-json"` or

package/dist/index.mjs

@@ -2,10 +2,7 @@ import { z } from "zod";
 import { unzip as unzip$1, zip as zip$1 } from "fflate";
 //#region src/schema.ts
 /**
-* Open Board Format (OBF) Zod Schemas
-*
-* These schemas represent the Open Board Format, designed for sharing communication boards and board sets
-* between Augmentative and Alternative Communication (AAC) applications.
+* Zod schemas for the Open Board Format (OBF) data model.
 *
 * Official OBF specification: https://www.openboardformat.org/docs
 */
@@ -178,7 +175,15 @@ const OBFButtonSchema = z.looseObject({
 	width: z.number().min(0).max(1).optional(),
 	/** Height of the button for absolute positioning (0.0 to 1.0). */
 	height: z.number().min(0).max(1).optional()
-});
+}).refine((b) => {
+	const set = [
+		b.top,
+		b.left,
+		b.width,
+		b.height
+	].filter((v) => v !== void 0);
+	return set.length === 0 || set.length === 4;
+}, { message: "Absolute positioning requires all of top, left, width, and height (or none)" });
 /**
 * Row-and-column layout that arranges buttons by their IDs.
 */
@@ -235,7 +240,7 @@ const OBFManifestSchema = z.looseObject({
 		/** Mapping of board IDs to their file paths. */
 		boards: z.record(z.string(), z.string()),
 		/** Mapping of image IDs to their file paths. */
-		images: z.record(z.string(), z.string()),
+		images: z.record(z.string(), z.string()).optional(),
 		/** Mapping of sound IDs to their file paths. */
 		sounds: z.record(z.string(), z.string()).optional()
 	})
@@ -484,9 +489,8 @@ async function loadOBZ(file) {
 * Decompress an OBZ archive and return its manifest, boards, and resources.
 *
 * @param archive - The OBZ archive as an `ArrayBuffer`.
-* @returns The parsed manifest, a map of board IDs to validated boards,
-*          the resolved root board, and a map of file paths to their
-*          binary content.
+* @returns A {@link ParsedOBZ} with the archive's manifest, boards, root
+*          board, and resources.
 *
 * @throws {@link OBFError}; branch on `info.code`: `"not-zip"`,
 *   `"unreadable-zip"`, `"missing-manifest"`, `"not-json"` or

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["_exhaustive"],"sources":["../src/schema.ts","../src/errors.ts","../src/obf.ts","../src/zip.ts","../src/obz.ts","../src/load-board.ts"],"sourcesContent":["/**\n * Open Board Format (OBF) Zod Schemas\n *\n * These schemas represent the Open Board Format, designed for sharing communication boards and board sets\n * between Augmentative and Alternative Communication (AAC) applications.\n *\n * Official OBF specification: https://www.openboardformat.org/docs\n */\n\nimport { z } from \"zod\";\n\n/** Optional URL that treats empty strings as undefined. */\nconst OBFOptionalUrlSchema = z\n  .union([z.url(), z.literal(\"\")])\n  .transform((val) => (val === \"\" ? undefined : val))\n  .optional();\n\n/** Optional email that treats empty strings as undefined. */\nconst OBFOptionalEmailSchema = z\n  .union([z.email(), z.literal(\"\")])\n  .transform((val) => (val === \"\" ? undefined : val))\n  .optional();\n\n/** Optional ID that treats empty strings as undefined. */\nconst OBFOptionalIDSchema = z\n  .union([z.string(), z.number()])\n  .transform((val) => {\n    const str = String(val);\n    return str === \"\" ? undefined : str;\n  })\n  .optional();\n\n/** Unique board-element identifier, coerced to a non-empty string. */\nexport const OBFIDSchema = z\n  .union([z.string(), z.number()])\n  .transform((val) => String(val))\n  .pipe(z.string().min(1));\n\n/**\n * Unique board-element identifier, coerced to a non-empty string.\n * See {@link OBFIDSchema}.\n */\nexport type OBFID = z.infer<typeof OBFIDSchema>;\n\n/** Format version of the Open Board Format, e.g., `open-board-0.1`. */\nexport const OBFFormatVersionSchema = z.string().regex(/^open-board-.+$/);\n\n/**\n * Format version of the Open Board Format, e.g., `open-board-0.1`.\n * See {@link OBFFormatVersionSchema}.\n */\nexport type OBFFormatVersion = z.infer<typeof OBFFormatVersionSchema>;\n\n/**\n * Locale identifier, typically a BCP 47 language tag (e.g., `en`, `en-US`,\n * `fr-CA`). Not strictly validated — any string is accepted.\n */\nexport const OBFLocaleCodeSchema = z.string();\n\n/**\n * Locale identifier, typically a BCP 47 language tag, e.g., `en`, `en-US`.\n * See {@link OBFLocaleCodeSchema}.\n */\nexport type OBFLocaleCode = z.infer<typeof OBFLocaleCodeSchema>;\n\n/**\n * Translations for a single locale, keyed by the source string,\n * e.g., `{ \"hello\": \"hola\" }`.\n */\nexport const OBFLocalizedStringsSchema = z.record(z.string(), z.string());\n\n/**\n * Translations for a single locale, keyed by the source string.\n * See {@link OBFLocalizedStringsSchema}.\n */\nexport type OBFLocalizedStrings = z.infer<typeof OBFLocalizedStringsSchema>;\n\n/**\n * Locale-keyed dictionary of translated strings,\n * e.g., `{ en: { greeting: \"Hello\" }, fr: { greeting: \"Bonjour\" } }`.\n */\nexport const OBFStringsSchema = z.record(z.string(), OBFLocalizedStringsSchema);\n\n/**\n * Locale-keyed dictionary of translated strings.\n * See {@link OBFStringsSchema}.\n */\nexport type OBFStrings = z.infer<typeof OBFStringsSchema>;\n\n/**\n * Spelling action: a `+` prefix followed by the text to append,\n * e.g., `+hello`.\n */\nexport const OBFSpellingActionSchema = z.string().regex(/^\\+.+$/);\n\n/**\n * Spelling action: a `+` prefix followed by the text to append, e.g., `+hello`.\n * See {@link OBFSpellingActionSchema}.\n */\nexport type OBFSpellingAction = z.infer<typeof OBFSpellingActionSchema>;\n\n/**\n * Specialty action prefixed with `:`, e.g., `:clear`.\n * Custom extensions use the `:ext_` prefix.\n */\nexport const OBFSpecialtyActionSchema = z\n  .string()\n  .regex(/^:[a-z][a-z0-9_-]*$/i);\n\n/**\n * Specialty action prefixed with `:`, e.g., `:clear`.\n * See {@link OBFSpecialtyActionSchema}.\n */\nexport type OBFSpecialtyAction = z.infer<typeof OBFSpecialtyActionSchema>;\n\n/** Union of spelling and specialty actions that a button can trigger. */\nexport const OBFButtonActionSchema = z.union([\n  OBFSpellingActionSchema,\n  OBFSpecialtyActionSchema,\n]);\n\n/**\n * Union of spelling and specialty actions that a button can trigger.\n * See {@link OBFButtonActionSchema}.\n */\nexport type OBFButtonAction = z.infer<typeof OBFButtonActionSchema>;\n\n/** License terms and attribution for a resource. */\nexport const OBFLicenseSchema = z.looseObject({\n  /** Type of the license, e.g., `CC-BY-SA`. */\n  type: z.string(),\n  /** URL to the license terms. */\n  copyright_notice_url: OBFOptionalUrlSchema,\n  /** Source URL of the resource. */\n  source_url: OBFOptionalUrlSchema,\n  /** Name of the author. */\n  author_name: z.string().optional(),\n  /** URL of the author's webpage. */\n  author_url: OBFOptionalUrlSchema,\n  /** Email address of the author. */\n  author_email: OBFOptionalEmailSchema,\n});\n\n/**\n * License terms and attribution for a resource.\n * See {@link OBFLicenseSchema}.\n */\nexport type OBFLicense = z.infer<typeof OBFLicenseSchema>;\n\n/**\n * Common properties for media resources (images and sounds).\n *\n * When multiple references are provided, they should be used in the following order:\n * 1. `data`\n * 2. `path`\n * 3. `url`\n *\n * `data_url` is not part of this fallback chain — it is an API endpoint for\n * retrieving information about the resource, not an alternative source of\n * the media bytes.\n */\nexport const OBFMediaSchema = z.looseObject({\n  /** Unique identifier for the media resource. */\n  id: OBFIDSchema,\n  /** Media data inlined as a `data:` URI. */\n  data: z.string().optional(),\n  /** Path to the media file within an `.obz` package. */\n  path: z.string().optional(),\n  /**\n   * URL of an API endpoint for fetching the media programmatically —\n   * not a `data:` URI (that is `data`).\n   */\n  data_url: OBFOptionalUrlSchema,\n  /** URL to the media resource. */\n  url: OBFOptionalUrlSchema,\n  /** MIME type of the media, e.g., `image/png`, `audio/mpeg`. */\n  content_type: z.string().optional(),\n  /** Licensing information for the media. */\n  license: OBFLicenseSchema.optional(),\n});\n\n/**\n * Common properties for media resources (images and sounds).\n * See {@link OBFMediaSchema}.\n */\nexport type OBFMedia = z.infer<typeof OBFMediaSchema>;\n\n/** Reference to a symbol in a proprietary symbol set (e.g., SymbolStix). */\nexport const OBFSymbolInfoSchema = z.looseObject({\n  /** Name of the symbol set, e.g., `symbolstix`. */\n  set: z.string(),\n  /** Filename of the symbol within the set. */\n  filename: z.string(),\n});\n\n/**\n * Reference to a symbol in a proprietary symbol set.\n * See {@link OBFSymbolInfoSchema}.\n */\nexport type OBFSymbolInfo = z.infer<typeof OBFSymbolInfoSchema>;\n\n/**\n * Image resource, extending {@link OBFMediaSchema} with optional\n * symbol and dimension properties.\n *\n * When resolving the image, consumers should prefer sources in this order:\n * 1. `data`\n * 2. `path`\n * 3. `url`\n * 4. `symbol`\n */\nexport const OBFImageSchema = OBFMediaSchema.extend({\n  /** Information about a symbol from a proprietary symbol set. */\n  symbol: OBFSymbolInfoSchema.optional(),\n  /** Width of the image in pixels. */\n  width: z.number().optional(),\n  /** Height of the image in pixels. */\n  height: z.number().optional(),\n});\n\n/**\n * Image resource with optional symbol and dimension properties.\n * See {@link OBFImageSchema}.\n */\nexport type OBFImage = z.infer<typeof OBFImageSchema>;\n\n/**\n * Audio resource. Identical to {@link OBFMediaSchema} — no additional properties.\n */\nexport const OBFSoundSchema = OBFMediaSchema;\n\n/**\n * Audio resource, identical to {@link OBFMedia}.\n * See {@link OBFSoundSchema}.\n */\nexport type OBFSound = z.infer<typeof OBFSoundSchema>;\n\n/** Reference to another board, resolved by ID, path, or URL. */\nexport const OBFLoadBoardSchema = z.looseObject({\n  /** Unique identifier of the board to load. */\n  id: OBFOptionalIDSchema,\n  /** Name of the board to load. */\n  name: z.string().optional(),\n  /**\n   * URL of an API endpoint for fetching the board programmatically —\n   * not a `data:` URI.\n   */\n  data_url: OBFOptionalUrlSchema,\n  /** URL to access the board via a web browser. */\n  url: OBFOptionalUrlSchema,\n  /** Path to the board within an `.obz` package. */\n  path: z.string().optional(),\n});\n\n/**\n * Reference to another board, resolved by ID, path, or URL.\n * See {@link OBFLoadBoardSchema}.\n */\nexport type OBFLoadBoard = z.infer<typeof OBFLoadBoardSchema>;\n\n/**\n * Interactive element on a board, optionally linked to images, sounds, and actions.\n */\nexport const OBFButtonSchema = z.looseObject({\n  /** Unique identifier for the button. */\n  id: OBFIDSchema,\n  /** Label text displayed on the button. */\n  label: z.string().optional(),\n  /** Alternative text for vocalization when the button is activated. */\n  vocalization: z.string().optional(),\n  /** Identifier of the image associated with the button. */\n  image_id: OBFOptionalIDSchema,\n  /** Identifier of the sound associated with the button. */\n  sound_id: OBFOptionalIDSchema,\n  /**\n   * Action triggered by the button. When `actions` is also set, this is\n   * the single-action fallback for apps that support one action per button.\n   */\n  action: OBFButtonActionSchema.optional(),\n  /**\n   * Multiple actions executed in order. Apps that support it should\n   * prefer this over the single `action` fallback.\n   */\n  actions: z.array(OBFButtonActionSchema).optional(),\n  /** Information to load another board when this button is activated. */\n  load_board: OBFLoadBoardSchema.optional(),\n  /** Background color of the button in `rgb` or `rgba` format. */\n  background_color: z.string().optional(),\n  /** Border color of the button in `rgb` or `rgba` format. */\n  border_color: z.string().optional(),\n  /** Vertical position for absolute positioning (0.0 to 1.0). */\n  top: z.number().min(0).max(1).optional(),\n  /** Horizontal position for absolute positioning (0.0 to 1.0). */\n  left: z.number().min(0).max(1).optional(),\n  /** Width of the button for absolute positioning (0.0 to 1.0). */\n  width: z.number().min(0).max(1).optional(),\n  /** Height of the button for absolute positioning (0.0 to 1.0). */\n  height: z.number().min(0).max(1).optional(),\n});\n\n/**\n * Interactive element on a board, optionally linked to images, sounds, and\n * actions. See {@link OBFButtonSchema}.\n */\nexport type OBFButton = z.infer<typeof OBFButtonSchema>;\n\n/**\n * Row-and-column layout that arranges buttons by their IDs.\n */\nexport const OBFGridSchema = z\n  .looseObject({\n    /** Number of rows in the grid. */\n    rows: z.number().int().min(1),\n    /** Number of columns in the grid. */\n    columns: z.number().int().min(1),\n    /**\n     * 2D array representing the order of buttons by their IDs.\n     * Each sub-array corresponds to a row, and each element is a button ID or null for empty slots.\n     */\n    order: z.array(z.array(z.union([OBFIDSchema, z.null()]))),\n  })\n  .refine((g) => g.order.length === g.rows, {\n    message: \"Grid order length must match rows\",\n  })\n  .refine((g) => g.order.every((row) => row.length === g.columns), {\n    message: \"Each grid row must have length equal to columns\",\n  });\n\n/**\n * Row-and-column layout that arranges buttons by their IDs.\n * See {@link OBFGridSchema}.\n */\nexport type OBFGrid = z.infer<typeof OBFGridSchema>;\n\n/**\n * Root object of an `.obf` file: the complete definition of a single communication board.\n */\nexport const OBFBoardSchema = z.looseObject({\n  /** Format version of the Open Board Format, e.g., `open-board-0.1`. */\n  format: OBFFormatVersionSchema,\n  /** Unique identifier for the board. */\n  id: OBFIDSchema,\n  /** Locale of the board as a BCP 47 language tag, e.g., `en`, `en-US`. */\n  locale: OBFLocaleCodeSchema.optional(),\n  /** List of buttons on the board. */\n  buttons: z.array(OBFButtonSchema),\n  /** URL where the board can be accessed or downloaded. */\n  url: OBFOptionalUrlSchema,\n  /** Name of the board. */\n  name: z.string().optional(),\n  /** Description of the board in HTML format. */\n  description_html: z.string().optional(),\n  /** Grid layout information for arranging buttons. */\n  grid: OBFGridSchema,\n  /** List of images used in the board. */\n  images: z.array(OBFImageSchema).optional(),\n  /** List of sounds used in the board. */\n  sounds: z.array(OBFSoundSchema).optional(),\n  /** Licensing information for the board. */\n  license: OBFLicenseSchema.optional(),\n  /** String translations for multiple locales. */\n  strings: OBFStringsSchema.optional(),\n});\n\n/**\n * The complete definition of a single communication board — root object of\n * an `.obf` file. See {@link OBFBoardSchema}.\n */\nexport type OBFBoard = z.infer<typeof OBFBoardSchema>;\n\n/**\n * Table of contents for an `.obz` package, mapping resource IDs to their archive paths.\n */\nexport const OBFManifestSchema = z\n  .looseObject({\n    /** Format version of the Open Board Format, e.g., `open-board-0.1`. */\n    format: OBFFormatVersionSchema,\n    /** Path to the root board within the `.obz` package. */\n    root: z.string(),\n    /** Mapping of IDs to paths for boards, images, and sounds. */\n    paths: z.looseObject({\n      /** Mapping of board IDs to their file paths. */\n      boards: z.record(z.string(), z.string()),\n      /** Mapping of image IDs to their file paths. */\n      images: z.record(z.string(), z.string()),\n      /** Mapping of sound IDs to their file paths. */\n      sounds: z.record(z.string(), z.string()).optional(),\n    }),\n  })\n  .refine((m) => Object.values(m.paths.boards).includes(m.root), {\n    message: \"root must be listed in paths.boards\",\n    path: [\"root\"],\n  });\n\n/**\n * Table of contents for an `.obz` package, mapping resource IDs to their\n * archive paths. See {@link OBFManifestSchema}.\n */\nexport type OBFManifest = z.infer<typeof OBFManifestSchema>;\n","/**\n * Typed errors for `@shayc/open-board-format`.\n *\n * Every failure thrown by this package is an {@link OBFError} carrying a\n * discriminated {@link OBFErrorInfo} on its `info` property. Switch on\n * `error.info.code` to get exactly the structured context for that failure —\n * the human-readable `message` is derived from `info` and is not part of the\n * stable contract.\n *\n * ```ts\n * try {\n *   await loadBoard(file);\n * } catch (error) {\n *   if (!(error instanceof OBFError)) throw error;\n *   switch (error.info.code) {\n *     case \"missing-resource\":\n *       reupload(error.info.kind, error.info.path); // both fully typed\n *       break;\n *     case \"invalid-board\":\n *       showIssues(error.info.issues);\n *       break;\n *   }\n * }\n * ```\n */\n\nimport { z } from \"zod\";\n\n/**\n * A single schema validation problem — Zod's issue shape, re-exported under a\n * domain name. `z.core.$ZodIssue` is the type Zod v4 designates for libraries\n * built on it (the bare `z.ZodIssue` is deprecated in its favor); aliasing it\n * gives consumers a stable OBF name without reaching into Zod's `core` export.\n */\nexport type OBFIssue = z.core.$ZodIssue;\n\n/**\n * Discriminated description of why an {@link OBFError} was thrown.\n *\n * Switch on `code`; each variant carries the fields relevant to it. When a\n * failure wraps an underlying error it lives on the standard `error.cause`,\n * never duplicated here. The only optional field is `invalid-board`'s\n * `boardId`, absent when validation runs on a value with no known id.\n */\nexport type OBFErrorInfo =\n  // --- decoding (underlying parser/decompressor error on `error.cause`) ---\n  /** Input was not parseable JSON. */\n  | { code: \"not-json\"; source: \"board\" | \"manifest\" }\n  /** An OBZ archive was expected, but the bytes are not a ZIP. */\n  | { code: \"not-zip\" }\n  /** A ZIP archive could not be decompressed. */\n  | { code: \"unreadable-zip\" }\n  // --- validation (underlying `ZodError` on `error.cause`) ---\n  /** A board failed schema validation. `boardId` is set when known. */\n  | { code: \"invalid-board\"; boardId?: string; issues: readonly OBFIssue[] }\n  /** A manifest failed schema validation. */\n  | { code: \"invalid-manifest\"; issues: readonly OBFIssue[] }\n  // --- archive structure (reading an .obz) ---\n  /** The archive has no `manifest.json`. */\n  | { code: \"missing-manifest\" }\n  /** A board the manifest declares is absent from the archive. */\n  | { code: \"missing-board\"; boardId: string; path: string }\n  /** A board's `id` disagrees with the id the manifest declares for it. */\n  | {\n      code: \"board-id-mismatch\";\n      path: string;\n      declaredId: string;\n      actualId: string;\n    }\n  // --- archive assembly (createOBZ) ---\n  /** `rootBoardId` matches none of the supplied boards. */\n  | { code: \"unknown-root\"; rootBoardId: string }\n  /** Two supplied boards share the same `id`. */\n  | { code: \"duplicate-board\"; boardId: string }\n  /** A board declares a media `path` with no matching resource. */\n  | {\n      code: \"missing-resource\";\n      kind: \"image\" | \"sound\";\n      mediaId: string;\n      path: string;\n    }\n  /** Two boards declare the same media id with different paths. */\n  | {\n      code: \"conflicting-paths\";\n      kind: \"image\" | \"sound\";\n      mediaId: string;\n      paths: [string, string];\n    }\n  /** A supplied resource would overwrite a generated board or the manifest. */\n  | { code: \"path-collision\"; path: string }\n  /** The archive could not be compressed. */\n  | { code: \"zip-failed\" }\n  /** An internal invariant was violated — a bug in this library; please report. */\n  | { code: \"internal\"; detail: string };\n\n/** Every `code` an {@link OBFError} can carry. */\nexport type OBFErrorCode = OBFErrorInfo[\"code\"];\n\n/**\n * The single error type thrown by `@shayc/open-board-format`.\n *\n * Branch on {@link OBFError.info} (a discriminated {@link OBFErrorInfo}) rather\n * than parsing {@link OBFError.message}. Any underlying error — a `JSON.parse`\n * failure, a `ZodError`, or an fflate error — is on the standard `error.cause`.\n */\nexport class OBFError extends Error {\n  /** Structured, discriminated description of the failure. */\n  readonly info: OBFErrorInfo;\n\n  constructor(info: OBFErrorInfo, options?: { cause?: unknown }) {\n    super(formatOBFError(info), options);\n    this.name = \"OBFError\";\n    this.info = info;\n  }\n}\n\n/** Derive a human-readable message from an {@link OBFErrorInfo}. */\nfunction formatOBFError(info: OBFErrorInfo): string {\n  switch (info.code) {\n    case \"not-json\":\n      return `Invalid ${info.source === \"manifest\" ? \"OBZ manifest\" : \"OBF\"}: not valid JSON`;\n    case \"not-zip\":\n      return \"Invalid OBZ: not a ZIP file\";\n    case \"unreadable-zip\":\n      return \"ZIP archive could not be read\";\n    case \"invalid-board\": {\n      const subject = info.boardId ? `board \"${info.boardId}\"` : \"board\";\n      return `Invalid OBF ${subject}:\\n${prettifyIssues(info.issues)}`;\n    }\n    case \"invalid-manifest\":\n      return `Invalid OBZ manifest:\\n${prettifyIssues(info.issues)}`;\n    case \"missing-manifest\":\n      return \"Invalid OBZ: missing manifest.json\";\n    case \"missing-board\":\n      return `Invalid OBZ: board \"${info.boardId}\" is declared in the manifest but missing at \"${info.path}\"`;\n    case \"board-id-mismatch\":\n      return `Invalid OBZ: board at \"${info.path}\" has id \"${info.actualId}\" but the manifest declares it as \"${info.declaredId}\"`;\n    case \"unknown-root\":\n      return `Invalid OBZ: rootBoardId \"${info.rootBoardId}\" does not match any supplied board`;\n    case \"duplicate-board\":\n      return `Invalid OBZ: duplicate board id \"${info.boardId}\" — board ids must be unique within a package`;\n    case \"missing-resource\":\n      return `Invalid OBZ: ${info.kind} \"${info.mediaId}\" references \"${info.path}\" but no matching resource was supplied`;\n    case \"conflicting-paths\":\n      return `Invalid OBZ: ${info.kind} id \"${info.mediaId}\" maps to conflicting paths \"${info.paths[0]}\" and \"${info.paths[1]}\"`;\n    case \"path-collision\":\n      return `Invalid OBZ: resource path \"${info.path}\" collides with a generated board or manifest entry`;\n    case \"zip-failed\":\n      return \"Failed to build ZIP archive\";\n    case \"internal\":\n      return `Internal error (please report): ${info.detail}`;\n    /* v8 ignore start -- exhaustiveness guard: unreachable, enforced at compile time */\n    default: {\n      const _exhaustive: never = info;\n      return _exhaustive;\n    }\n    /* v8 ignore stop */\n  }\n}\n\n/** Render schema issues using Zod's pretty formatter. */\nfunction prettifyIssues(issues: readonly OBFIssue[]): string {\n  return z.prettifyError(new z.ZodError([...issues]));\n}\n","/**\n * Parsing, validation, and serialization for single `.obf` board files.\n */\n\nimport { OBFError } from \"./errors\";\nimport type { OBFBoard } from \"./schema\";\nimport { OBFBoardSchema } from \"./schema\";\n\nconst UTF8_BOM = \"\\uFEFF\";\n\n/** Strip a leading UTF-8 BOM, which some editors silently prepend. */\nfunction stripBom(text: string): string {\n  return text.startsWith(UTF8_BOM) ? text.slice(1) : text;\n}\n\n/**\n * Parse a JSON string into a validated OBF board.\n *\n * Strips an optional UTF-8 BOM prefix before parsing and throws a\n * descriptive error if the input is malformed or fails schema validation.\n *\n * @param json - The JSON string to parse.\n * @returns The validated board object.\n *\n * @throws {@link OBFError} with `info.code` `\"not-json\"` if the JSON is\n *   malformed, or `\"invalid-board\"` if it fails schema validation.\n */\nexport function parseOBF(json: string): OBFBoard {\n  const sanitized = stripBom(json);\n\n  let rawBoard: unknown;\n\n  try {\n    rawBoard = JSON.parse(sanitized) as unknown;\n  } catch (error) {\n    throw new OBFError({ code: \"not-json\", source: \"board\" }, { cause: error });\n  }\n\n  return validateOBF(rawBoard);\n}\n\n/**\n * Read a `File` and parse its contents as a validated OBF board.\n *\n * This relies on the browser `File` API; for Node environments,\n * read the file to a string and pass it to {@link parseOBF} instead.\n *\n * @param file - A `File` handle pointing to an `.obf` file.\n * @returns The validated board object.\n *\n * @throws {@link OBFError} with `info.code` `\"not-json\"` if the file content is\n *   malformed, or `\"invalid-board\"` if it fails schema validation.\n */\nexport async function loadOBF(file: File): Promise<OBFBoard> {\n  const json = await file.text();\n  return parseOBF(json);\n}\n\n/**\n * Validate an unknown value against the OBF board schema.\n *\n * @param data - The value to validate.\n * @returns The validated board object.\n *\n * @throws {@link OBFError} with `info.code` `\"invalid-board\"` if the value fails\n *   schema validation. `info.issues` holds the underlying Zod issues.\n */\nexport function validateOBF(data: unknown): OBFBoard {\n  const result = OBFBoardSchema.safeParse(data);\n\n  if (!result.success) {\n    throw new OBFError(\n      { code: \"invalid-board\", issues: result.error.issues },\n      { cause: result.error },\n    );\n  }\n\n  return result.data;\n}\n\n/**\n * Stringify an OBF board to a pretty-printed JSON string.\n *\n * @param board - The board to stringify.\n * @returns A JSON string with two-space indentation.\n */\nexport function stringifyOBF(board: OBFBoard): string {\n  return JSON.stringify(board, null, 2);\n}\n","/**\n * Minimal ZIP helpers over fflate: signature sniffing, unzip, and zip.\n */\n\nimport { unzip as fflateUnzip, zip as fflateZip } from \"fflate\";\nimport { OBFError } from \"./errors\";\n\n/**\n * First two bytes of every ZIP archive — the ASCII letters `PK`,\n * after Phil Katz, creator of the format.\n *\n * Only the 2-byte prefix is checked intentionally: this keeps the\n * test lightweight and sufficient for distinguishing ZIP from JSON.\n */\nconst ZIP_MAGIC = [0x50, 0x4b] as const;\n\n/** Balanced speed-vs-size deflate level, on fflate's 0–9 scale (0 = store). */\nconst COMPRESSION_LEVEL = 6;\n\n/**\n * Decompress a ZIP archive into a map of file paths to raw bytes.\n *\n * @param archive - The ZIP archive as an `ArrayBuffer`.\n * @returns A map of file paths to their decompressed content.\n *\n * @throws {@link OBFError} with `info.code` `\"unreadable-zip\"` if the archive is\n *   corrupt or cannot be decompressed.\n */\nexport function unzip(archive: ArrayBuffer): Promise<Map<string, Uint8Array>> {\n  return new Promise((resolve, reject) => {\n    const compressed = new Uint8Array(archive);\n\n    fflateUnzip(compressed, (error, entries) => {\n      if (error) {\n        reject(new OBFError({ code: \"unreadable-zip\" }, { cause: error }));\n        return;\n      }\n\n      const pathToBytes = new Map<string, Uint8Array>(Object.entries(entries));\n\n      resolve(pathToBytes);\n    });\n  });\n}\n\n/**\n * Compress a map of file paths and contents into a single ZIP archive.\n *\n * Accepts both `Uint8Array` and `ArrayBuffer` values so callers can\n * pass the output of {@link unzip} directly or supply raw `ArrayBuffer`s\n * without converting first.\n *\n * @param entries - A map of file paths to their content bytes.\n * @returns The compressed archive as a `Uint8Array`.\n *\n * @throws {@link OBFError} with `info.code` `\"zip-failed\"` if fflate fails to\n *   compress an entry.\n */\nexport function zip(\n  entries: Map<string, Uint8Array | ArrayBuffer>,\n): Promise<Uint8Array> {\n  return new Promise((resolve, reject) => {\n    const pathToBytes: Record<string, Uint8Array> = {};\n\n    for (const [path, content] of entries) {\n      pathToBytes[path] =\n        content instanceof Uint8Array ? content : new Uint8Array(content);\n    }\n\n    fflateZip(pathToBytes, { level: COMPRESSION_LEVEL }, (error, result) => {\n      if (error) {\n        reject(new OBFError({ code: \"zip-failed\" }, { cause: error }));\n        return;\n      }\n\n      resolve(result);\n    });\n  });\n}\n\n/**\n * Test whether an `ArrayBuffer` begins with the two-byte ZIP magic\n * prefix (`PK`).\n *\n * @param archive - The buffer to inspect.\n * @returns `true` if the buffer starts with the ZIP signature.\n */\nexport function isZip(archive: ArrayBuffer): boolean {\n  const bytes = new Uint8Array(archive);\n\n  return (\n    bytes.length >= ZIP_MAGIC.length &&\n    ZIP_MAGIC.every((byte, index) => bytes[index] === byte)\n  );\n}\n","/**\n * Creation and extraction of `.obz` board packages.\n */\n\nimport { OBFError } from \"./errors\";\nimport { parseOBF } from \"./obf\";\nimport type { OBFBoard, OBFManifest } from \"./schema\";\nimport { OBFBoardSchema, OBFManifestSchema } from \"./schema\";\nimport { isZip, unzip, zip } from \"./zip\";\n\n/**\n * Fully extracted contents of an `.obz` archive.\n */\nexport interface ParsedOBZ {\n  /** The package's table of contents. */\n  manifest: OBFManifest;\n  /** Validated board objects keyed by board ID. */\n  boards: Map<string, OBFBoard>;\n  /**\n   * The package's entry-point board — the one `manifest.root` points at,\n   * already resolved. Same object as `boards.get(rootBoard.id)`.\n   */\n  rootBoard: OBFBoard;\n  /**\n   * Raw bytes for every entry in the archive, keyed by archive path —\n   * including `manifest.json` and the `.obf` boards as well as media\n   * such as images and sounds.\n   */\n  resources: Map<string, Uint8Array>;\n}\n\n/**\n * Read a `File` and extract its contents as a parsed OBZ package.\n *\n * This relies on the browser `File` API; for Node environments,\n * read the file to an `ArrayBuffer` and pass it to {@link extractOBZ} instead.\n *\n * @param file - A `File` handle pointing to an `.obz` archive.\n * @returns The parsed manifest, boards, root board, and binary resources.\n *\n * @throws {@link OBFError} — the same failures as {@link extractOBZ}, which\n *   this delegates to.\n */\nexport async function loadOBZ(file: File): Promise<ParsedOBZ> {\n  const archive = await file.arrayBuffer();\n  return extractOBZ(archive);\n}\n\n/**\n * Decompress an OBZ archive and return its manifest, boards, and resources.\n *\n * @param archive - The OBZ archive as an `ArrayBuffer`.\n * @returns The parsed manifest, a map of board IDs to validated boards,\n *          the resolved root board, and a map of file paths to their\n *          binary content.\n *\n * @throws {@link OBFError}; branch on `info.code`: `\"not-zip\"`,\n *   `\"unreadable-zip\"`, `\"missing-manifest\"`, `\"not-json\"` or\n *   `\"invalid-manifest\"` (bad manifest), `\"missing-board\"`,\n *   `\"board-id-mismatch\"`, or `\"invalid-board\"` (a board fails validation).\n */\nexport async function extractOBZ(archive: ArrayBuffer): Promise<ParsedOBZ> {\n  if (!isZip(archive)) {\n    throw new OBFError({ code: \"not-zip\" });\n  }\n\n  const entries = await unzip(archive);\n\n  const manifest = extractManifest(entries);\n  const { boards, rootBoard } = extractBoards(manifest, entries);\n\n  return { manifest, boards, rootBoard, resources: entries };\n}\n\n/**\n * Parse and validate an OBZ manifest — the table of contents that maps\n * board IDs to their file paths within the archive.\n *\n * @param json - A JSON string representing the manifest.\n * @returns The validated manifest object.\n *\n * @throws {@link OBFError} with `info.code` `\"not-json\"` if the JSON is\n *   malformed, or `\"invalid-manifest\"` if it fails schema validation.\n */\nexport function parseManifest(json: string): OBFManifest {\n  let data: unknown;\n\n  try {\n    data = JSON.parse(json) as unknown;\n  } catch (error) {\n    throw new OBFError(\n      { code: \"not-json\", source: \"manifest\" },\n      { cause: error },\n    );\n  }\n\n  const result = OBFManifestSchema.safeParse(data);\n\n  if (!result.success) {\n    throw new OBFError(\n      { code: \"invalid-manifest\", issues: result.error.issues },\n      { cause: result.error },\n    );\n  }\n\n  return result.data;\n}\n\n/**\n * Bundle boards and optional resources into a compressed OBZ archive.\n *\n * A manifest is generated automatically from the supplied boards,\n * using the `rootBoardId` to designate the entry-point board.\n *\n * Every failure is an {@link OBFError}; branch on `info.code`.\n *\n * @param boards - The boards to include in the archive.\n * @param rootBoardId - The ID of the board that serves as the archive's entry point.\n * @param resources - Optional map of file paths to binary content (images, sounds, etc.).\n * @returns A `Blob` containing the compressed OBZ archive.\n *\n * @throws {@link OBFError} `\"unknown-root\"` if `rootBoardId` does not match any of the supplied boards.\n * @throws {@link OBFError} `\"duplicate-board\"` if two supplied boards share the same ID.\n * @throws {@link OBFError} `\"invalid-board\"` if a supplied board fails schema validation.\n * @throws {@link OBFError} `\"conflicting-paths\"` if two boards declare the same media ID with conflicting paths.\n * @throws {@link OBFError} `\"missing-resource\"` if a board declares an image or sound `path` with no matching entry in `resources`.\n * @throws {@link OBFError} `\"path-collision\"` if a `resources` entry would overwrite the generated `manifest.json` or a board file.\n */\nexport async function createOBZ(\n  boards: OBFBoard[],\n  rootBoardId: string,\n  resources?: Map<string, Uint8Array | ArrayBuffer>,\n): Promise<Blob> {\n  if (!boards.some((board) => board.id === rootBoardId)) {\n    throw new OBFError({ code: \"unknown-root\", rootBoardId });\n  }\n\n  const seenBoardIds = new Set<string>();\n  for (const board of boards) {\n    if (seenBoardIds.has(board.id)) {\n      throw new OBFError({ code: \"duplicate-board\", boardId: board.id });\n    }\n    seenBoardIds.add(board.id);\n  }\n\n  const entries = new Map<string, Uint8Array | ArrayBuffer>();\n\n  const boardPaths = Object.fromEntries(\n    boards.map((board) => [board.id, `boards/${board.id}.obf`]),\n  );\n\n  const imagePaths = collectMediaPaths(boards, \"images\");\n  const soundPaths = collectMediaPaths(boards, \"sounds\");\n\n  const manifestResult = OBFManifestSchema.safeParse({\n    format: \"open-board-0.1\",\n    root: `boards/${rootBoardId}.obf`,\n    paths: {\n      boards: boardPaths,\n      images: imagePaths,\n      ...(Object.keys(soundPaths).length > 0 ? { sounds: soundPaths } : {}),\n    },\n  });\n\n  /* v8 ignore start -- defensive: the manifest is built from already-validated inputs */\n  if (!manifestResult.success) {\n    throw new OBFError(\n      { code: \"internal\", detail: \"generated manifest failed validation\" },\n      { cause: manifestResult.error },\n    );\n  }\n  /* v8 ignore stop */\n\n  const manifest = manifestResult.data;\n\n  const encoder = new TextEncoder();\n\n  entries.set(\n    \"manifest.json\",\n    encoder.encode(JSON.stringify(manifest, null, 2)),\n  );\n\n  for (const board of boards) {\n    const result = OBFBoardSchema.safeParse(board);\n    if (!result.success) {\n      throw new OBFError(\n        {\n          code: \"invalid-board\",\n          boardId: board.id,\n          issues: result.error.issues,\n        },\n        { cause: result.error },\n      );\n    }\n    const path = `boards/${result.data.id}.obf`;\n    entries.set(path, encoder.encode(JSON.stringify(result.data, null, 2)));\n  }\n\n  if (resources) {\n    for (const [path, bytes] of resources) {\n      if (entries.has(path)) {\n        throw new OBFError({ code: \"path-collision\", path });\n      }\n      entries.set(path, bytes);\n    }\n  }\n\n  assertPathsPresent(\"image\", imagePaths, entries);\n  assertPathsPresent(\"sound\", soundPaths, entries);\n\n  const compressed = await zip(entries);\n  return new Blob([compressed], { type: \"application/zip\" });\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Walk every board's media collection and produce the `{ id -> path }` map\n * the spec calls \"redundant but still required\" for the OBZ manifest.\n *\n * Throws when two boards declare the same media ID with conflicting paths\n * — a silent OBZ that points at a non-existent file is worse than a clear error.\n */\nfunction collectMediaPaths(\n  boards: OBFBoard[],\n  kind: \"images\" | \"sounds\",\n): Record<string, string> {\n  const paths: Record<string, string> = {};\n\n  for (const board of boards) {\n    for (const media of board[kind] ?? []) {\n      if (media.path === undefined) {\n        continue;\n      }\n\n      const existing = paths[media.id];\n      if (existing !== undefined && existing !== media.path) {\n        throw new OBFError({\n          code: \"conflicting-paths\",\n          kind: kind === \"images\" ? \"image\" : \"sound\",\n          mediaId: media.id,\n          paths: [existing, media.path],\n        });\n      }\n      paths[media.id] = media.path;\n    }\n  }\n\n  return paths;\n}\n\n/**\n * Assert that every media path the generated manifest declares exists as an\n * archive entry — the same contract {@link extractOBZ} assumes when reading.\n *\n * Only media that declared a `path` reach this check, so `url`/`data`-only\n * media are never flagged.\n */\nfunction assertPathsPresent(\n  kind: \"image\" | \"sound\",\n  paths: Record<string, string>,\n  entries: Map<string, Uint8Array | ArrayBuffer>,\n): void {\n  for (const [id, path] of Object.entries(paths)) {\n    if (!entries.has(path)) {\n      throw new OBFError({\n        code: \"missing-resource\",\n        kind,\n        mediaId: id,\n        path,\n      });\n    }\n  }\n}\n\nfunction extractManifest(entries: Map<string, Uint8Array>): OBFManifest {\n  const manifestBytes = entries.get(\"manifest.json\");\n\n  if (!manifestBytes) {\n    throw new OBFError({ code: \"missing-manifest\" });\n  }\n\n  const manifestJson = new TextDecoder().decode(manifestBytes);\n  return parseManifest(manifestJson);\n}\n\nfunction extractBoards(\n  manifest: OBFManifest,\n  entries: Map<string, Uint8Array>,\n): { boards: Map<string, OBFBoard>; rootBoard: OBFBoard } {\n  const boards = new Map<string, OBFBoard>();\n  let rootBoard: OBFBoard | undefined;\n\n  for (const [id, path] of Object.entries(manifest.paths.boards)) {\n    const boardBytes = entries.get(path);\n\n    if (!boardBytes) {\n      throw new OBFError({ code: \"missing-board\", boardId: id, path });\n    }\n\n    const boardJson = new TextDecoder().decode(boardBytes);\n    const board = parseOBF(boardJson);\n\n    if (board.id !== id) {\n      throw new OBFError({\n        code: \"board-id-mismatch\",\n        path,\n        declaredId: id,\n        actualId: board.id,\n      });\n    }\n\n    boards.set(id, board);\n\n    if (path === manifest.root) {\n      rootBoard = board;\n    }\n  }\n\n  // `OBFManifestSchema` requires `root` to be one of `paths.boards`, so the loop\n  // above always assigns `rootBoard` for the validated manifests we receive.\n  /* v8 ignore start -- defensive: OBFManifestSchema guarantees root ∈ paths.boards */\n  if (!rootBoard) {\n    throw new OBFError({\n      code: \"internal\",\n      detail: `root board \"${manifest.root}\" not found in paths.boards`,\n    });\n  }\n  /* v8 ignore stop */\n\n  return { boards, rootBoard };\n}\n","/**\n * Format-agnostic loading of `.obf` boards and `.obz` packages.\n */\n\nimport { parseOBF } from \"./obf\";\nimport { extractOBZ } from \"./obz\";\nimport type { ParsedOBZ } from \"./obz\";\nimport type { OBFBoard } from \"./schema\";\nimport { isZip } from \"./zip\";\n\n/**\n * Result of {@link loadBoard} — a discriminated union over the two file\n * shapes the Open Board Format defines.\n *\n * Switch on `format` to narrow:\n *\n * ```ts\n * const loaded = await loadBoard(file);\n * if (loaded.format === \"obz\") {\n *   loaded.archive.rootBoard; // home board of the ParsedOBZ archive\n * } else {\n *   loaded.board;             // OBFBoard\n * }\n * ```\n */\nexport type LoadedBoard =\n  | { format: \"obz\"; archive: ParsedOBZ }\n  | { format: \"obf\"; board: OBFBoard };\n\n/**\n * Detect whether the input is a single OBF board or an OBZ package and load it\n * accordingly.\n *\n * Input that begins with the ZIP magic prefix is treated as an `.obz` package;\n * anything else is parsed as an `.obf` board. The input is read once, so\n * consumers can accept either format from a single drag-and-drop, file picker,\n * or fetch response without inspecting the file extension or re-deriving the\n * OBF-vs-OBZ distinction themselves.\n *\n * @param input - A `File` handle or `ArrayBuffer` holding `.obf` or `.obz` content.\n * @returns A discriminated union tagged by `format`.\n *\n * @throws {@link OBFError} — the OBZ failures of {@link extractOBZ} when the\n *   input is an archive, or the OBF failures of {@link parseOBF} otherwise.\n *   Branch on `error.info.code`.\n */\nexport async function loadBoard(\n  input: File | ArrayBuffer,\n): Promise<LoadedBoard> {\n  const buffer =\n    input instanceof ArrayBuffer ? input : await input.arrayBuffer();\n\n  if (isZip(buffer)) {\n    return { format: \"obz\", archive: await extractOBZ(buffer) };\n  }\n\n  return { format: \"obf\", board: parseOBF(new TextDecoder().decode(buffer)) };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["_exhaustive"],"sources":["../src/schema.ts","../src/errors.ts","../src/obf.ts","../src/zip.ts","../src/obz.ts","../src/load-board.ts"],"sourcesContent":["/**\n * Zod schemas for the Open Board Format (OBF) data model.\n *\n * Official OBF specification: https://www.openboardformat.org/docs\n */\n\nimport { z } from \"zod\";\n\n/** Optional URL that treats empty strings as undefined. */\nconst OBFOptionalUrlSchema = z\n  .union([z.url(), z.literal(\"\")])\n  .transform((val) => (val === \"\" ? undefined : val))\n  .optional();\n\n/** Optional email that treats empty strings as undefined. */\nconst OBFOptionalEmailSchema = z\n  .union([z.email(), z.literal(\"\")])\n  .transform((val) => (val === \"\" ? undefined : val))\n  .optional();\n\n/** Optional ID that treats empty strings as undefined. */\nconst OBFOptionalIDSchema = z\n  .union([z.string(), z.number()])\n  .transform((val) => {\n    const str = String(val);\n    return str === \"\" ? undefined : str;\n  })\n  .optional();\n\n/** Unique board-element identifier, coerced to a non-empty string. */\nexport const OBFIDSchema = z\n  .union([z.string(), z.number()])\n  .transform((val) => String(val))\n  .pipe(z.string().min(1));\n\n/** Unique board-element identifier, coerced to a non-empty string. See {@link OBFIDSchema}. */\nexport type OBFID = z.infer<typeof OBFIDSchema>;\n\n/** Format version of the Open Board Format, e.g., `open-board-0.1`. */\nexport const OBFFormatVersionSchema = z.string().regex(/^open-board-.+$/);\n\n/** Format version of the Open Board Format, e.g., `open-board-0.1`. See {@link OBFFormatVersionSchema}. */\nexport type OBFFormatVersion = z.infer<typeof OBFFormatVersionSchema>;\n\n/**\n * Locale identifier, typically a BCP 47 language tag (e.g., `en`, `en-US`,\n * `fr-CA`). Not strictly validated — any string is accepted.\n */\nexport const OBFLocaleCodeSchema = z.string();\n\n/** Locale identifier, typically a BCP 47 language tag, e.g., `en`, `en-US`. See {@link OBFLocaleCodeSchema}. */\nexport type OBFLocaleCode = z.infer<typeof OBFLocaleCodeSchema>;\n\n/**\n * Translations for a single locale, keyed by the source string,\n * e.g., `{ \"hello\": \"hola\" }`.\n */\nexport const OBFLocalizedStringsSchema = z.record(z.string(), z.string());\n\n/** Translations for a single locale, keyed by the source string. See {@link OBFLocalizedStringsSchema}. */\nexport type OBFLocalizedStrings = z.infer<typeof OBFLocalizedStringsSchema>;\n\n/**\n * Locale-keyed dictionary of translated strings,\n * e.g., `{ en: { greeting: \"Hello\" }, fr: { greeting: \"Bonjour\" } }`.\n */\nexport const OBFStringsSchema = z.record(z.string(), OBFLocalizedStringsSchema);\n\n/** Locale-keyed dictionary of translated strings. See {@link OBFStringsSchema}. */\nexport type OBFStrings = z.infer<typeof OBFStringsSchema>;\n\n/**\n * Spelling action: a `+` prefix followed by the text to append,\n * e.g., `+hello`.\n */\nexport const OBFSpellingActionSchema = z.string().regex(/^\\+.+$/);\n\n/** Spelling action: a `+` prefix followed by the text to append, e.g., `+hello`. See {@link OBFSpellingActionSchema}. */\nexport type OBFSpellingAction = z.infer<typeof OBFSpellingActionSchema>;\n\n/**\n * Specialty action prefixed with `:`, e.g., `:clear`.\n * Custom extensions use the `:ext_` prefix.\n */\nexport const OBFSpecialtyActionSchema = z\n  .string()\n  .regex(/^:[a-z][a-z0-9_-]*$/i);\n\n/** Specialty action prefixed with `:`, e.g., `:clear`. See {@link OBFSpecialtyActionSchema}. */\nexport type OBFSpecialtyAction = z.infer<typeof OBFSpecialtyActionSchema>;\n\n/** Union of spelling and specialty actions that a button can trigger. */\nexport const OBFButtonActionSchema = z.union([\n  OBFSpellingActionSchema,\n  OBFSpecialtyActionSchema,\n]);\n\n/** Union of spelling and specialty actions that a button can trigger. See {@link OBFButtonActionSchema}. */\nexport type OBFButtonAction = z.infer<typeof OBFButtonActionSchema>;\n\n/** License terms and attribution for a resource. */\nexport const OBFLicenseSchema = z.looseObject({\n  /** Type of the license, e.g., `CC-BY-SA`. */\n  type: z.string(),\n  /** URL to the license terms. */\n  copyright_notice_url: OBFOptionalUrlSchema,\n  /** Source URL of the resource. */\n  source_url: OBFOptionalUrlSchema,\n  /** Name of the author. */\n  author_name: z.string().optional(),\n  /** URL of the author's webpage. */\n  author_url: OBFOptionalUrlSchema,\n  /** Email address of the author. */\n  author_email: OBFOptionalEmailSchema,\n});\n\n/** License terms and attribution for a resource. See {@link OBFLicenseSchema}. */\nexport type OBFLicense = z.infer<typeof OBFLicenseSchema>;\n\n/**\n * Common properties for media resources (images and sounds).\n *\n * When multiple references are provided, they should be used in the following order:\n * 1. `data`\n * 2. `path`\n * 3. `url`\n *\n * `data_url` is not part of this fallback chain — it is an API endpoint for\n * retrieving information about the resource, not an alternative source of\n * the media bytes.\n */\nexport const OBFMediaSchema = z.looseObject({\n  /** Unique identifier for the media resource. */\n  id: OBFIDSchema,\n  /** Media data inlined as a `data:` URI. */\n  data: z.string().optional(),\n  /** Path to the media file within an `.obz` package. */\n  path: z.string().optional(),\n  /**\n   * URL of an API endpoint for fetching the media programmatically —\n   * not a `data:` URI (that is `data`).\n   */\n  data_url: OBFOptionalUrlSchema,\n  /** URL to the media resource. */\n  url: OBFOptionalUrlSchema,\n  /** MIME type of the media, e.g., `image/png`, `audio/mpeg`. */\n  content_type: z.string().optional(),\n  /** Licensing information for the media. */\n  license: OBFLicenseSchema.optional(),\n});\n\n/** Common properties for media resources (images and sounds). See {@link OBFMediaSchema}. */\nexport type OBFMedia = z.infer<typeof OBFMediaSchema>;\n\n/** Reference to a symbol in a proprietary symbol set (e.g., SymbolStix). */\nexport const OBFSymbolInfoSchema = z.looseObject({\n  /** Name of the symbol set, e.g., `symbolstix`. */\n  set: z.string(),\n  /** Filename of the symbol within the set. */\n  filename: z.string(),\n});\n\n/** Reference to a symbol in a proprietary symbol set. See {@link OBFSymbolInfoSchema}. */\nexport type OBFSymbolInfo = z.infer<typeof OBFSymbolInfoSchema>;\n\n/**\n * Image resource, extending {@link OBFMediaSchema} with optional\n * symbol and dimension properties.\n *\n * When resolving the image, consumers should prefer sources in this order:\n * 1. `data`\n * 2. `path`\n * 3. `url`\n * 4. `symbol`\n */\nexport const OBFImageSchema = OBFMediaSchema.extend({\n  /** Information about a symbol from a proprietary symbol set. */\n  symbol: OBFSymbolInfoSchema.optional(),\n  /** Width of the image in pixels. */\n  width: z.number().optional(),\n  /** Height of the image in pixels. */\n  height: z.number().optional(),\n});\n\n/** Image resource with optional symbol and dimension properties. See {@link OBFImageSchema}. */\nexport type OBFImage = z.infer<typeof OBFImageSchema>;\n\n/**\n * Audio resource. Identical to {@link OBFMediaSchema} — no additional properties.\n */\nexport const OBFSoundSchema = OBFMediaSchema;\n\n/** Audio resource, identical to {@link OBFMediaSchema}. See {@link OBFSoundSchema}. */\nexport type OBFSound = z.infer<typeof OBFSoundSchema>;\n\n/** Reference to another board, resolved by ID, path, or URL. */\nexport const OBFLoadBoardSchema = z.looseObject({\n  /** Unique identifier of the board to load. */\n  id: OBFOptionalIDSchema,\n  /** Name of the board to load. */\n  name: z.string().optional(),\n  /**\n   * URL of an API endpoint for fetching the board programmatically —\n   * not a `data:` URI.\n   */\n  data_url: OBFOptionalUrlSchema,\n  /** URL to access the board via a web browser. */\n  url: OBFOptionalUrlSchema,\n  /** Path to the board within an `.obz` package. */\n  path: z.string().optional(),\n});\n\n/** Reference to another board, resolved by ID, path, or URL. See {@link OBFLoadBoardSchema}. */\nexport type OBFLoadBoard = z.infer<typeof OBFLoadBoardSchema>;\n\n/**\n * Interactive element on a board, optionally linked to images, sounds, and actions.\n */\nexport const OBFButtonSchema = z\n  .looseObject({\n    /** Unique identifier for the button. */\n    id: OBFIDSchema,\n    /** Label text displayed on the button. */\n    label: z.string().optional(),\n    /** Alternative text for vocalization when the button is activated. */\n    vocalization: z.string().optional(),\n    /** Identifier of the image associated with the button. */\n    image_id: OBFOptionalIDSchema,\n    /** Identifier of the sound associated with the button. */\n    sound_id: OBFOptionalIDSchema,\n    /**\n     * Action triggered by the button. When `actions` is also set, this is\n     * the single-action fallback for apps that support one action per button.\n     */\n    action: OBFButtonActionSchema.optional(),\n    /**\n     * Multiple actions executed in order. Apps that support it should\n     * prefer this over the single `action` fallback.\n     */\n    actions: z.array(OBFButtonActionSchema).optional(),\n    /** Information to load another board when this button is activated. */\n    load_board: OBFLoadBoardSchema.optional(),\n    /** Background color of the button in `rgb` or `rgba` format. */\n    background_color: z.string().optional(),\n    /** Border color of the button in `rgb` or `rgba` format. */\n    border_color: z.string().optional(),\n    /** Vertical position for absolute positioning (0.0 to 1.0). */\n    top: z.number().min(0).max(1).optional(),\n    /** Horizontal position for absolute positioning (0.0 to 1.0). */\n    left: z.number().min(0).max(1).optional(),\n    /** Width of the button for absolute positioning (0.0 to 1.0). */\n    width: z.number().min(0).max(1).optional(),\n    /** Height of the button for absolute positioning (0.0 to 1.0). */\n    height: z.number().min(0).max(1).optional(),\n  })\n  .refine(\n    (b) => {\n      const set = [b.top, b.left, b.width, b.height].filter(\n        (v) => v !== undefined,\n      );\n      return set.length === 0 || set.length === 4;\n    },\n    {\n      message:\n        \"Absolute positioning requires all of top, left, width, and height (or none)\",\n    },\n  );\n\n/** Interactive element on a board, optionally linked to images, sounds, and actions. See {@link OBFButtonSchema}. */\nexport type OBFButton = z.infer<typeof OBFButtonSchema>;\n\n/**\n * Row-and-column layout that arranges buttons by their IDs.\n */\nexport const OBFGridSchema = z\n  .looseObject({\n    /** Number of rows in the grid. */\n    rows: z.number().int().min(1),\n    /** Number of columns in the grid. */\n    columns: z.number().int().min(1),\n    /**\n     * 2D array representing the order of buttons by their IDs.\n     * Each sub-array corresponds to a row, and each element is a button ID or null for empty slots.\n     */\n    order: z.array(z.array(z.union([OBFIDSchema, z.null()]))),\n  })\n  .refine((g) => g.order.length === g.rows, {\n    message: \"Grid order length must match rows\",\n  })\n  .refine((g) => g.order.every((row) => row.length === g.columns), {\n    message: \"Each grid row must have length equal to columns\",\n  });\n\n/** Row-and-column layout that arranges buttons by their IDs. See {@link OBFGridSchema}. */\nexport type OBFGrid = z.infer<typeof OBFGridSchema>;\n\n/**\n * Root object of an `.obf` file: the complete definition of a single communication board.\n */\nexport const OBFBoardSchema = z.looseObject({\n  /** Format version of the Open Board Format, e.g., `open-board-0.1`. */\n  format: OBFFormatVersionSchema,\n  /** Unique identifier for the board. */\n  id: OBFIDSchema,\n  /** Locale of the board as a BCP 47 language tag, e.g., `en`, `en-US`. */\n  locale: OBFLocaleCodeSchema.optional(),\n  /** List of buttons on the board. */\n  buttons: z.array(OBFButtonSchema),\n  /** URL where the board can be accessed or downloaded. */\n  url: OBFOptionalUrlSchema,\n  /** Name of the board. */\n  name: z.string().optional(),\n  /** Description of the board in HTML format. */\n  description_html: z.string().optional(),\n  /** Grid layout information for arranging buttons. */\n  grid: OBFGridSchema,\n  /** List of images used in the board. */\n  images: z.array(OBFImageSchema).optional(),\n  /** List of sounds used in the board. */\n  sounds: z.array(OBFSoundSchema).optional(),\n  /** Licensing information for the board. */\n  license: OBFLicenseSchema.optional(),\n  /** String translations for multiple locales. */\n  strings: OBFStringsSchema.optional(),\n});\n\n/** Root object of an `.obf` file: the complete definition of a single communication board. See {@link OBFBoardSchema}. */\nexport type OBFBoard = z.infer<typeof OBFBoardSchema>;\n\n/**\n * Table of contents for an `.obz` package, mapping resource IDs to their archive paths.\n */\nexport const OBFManifestSchema = z\n  .looseObject({\n    /** Format version of the Open Board Format, e.g., `open-board-0.1`. */\n    format: OBFFormatVersionSchema,\n    /** Path to the root board within the `.obz` package. */\n    root: z.string(),\n    /** Mapping of IDs to paths for boards, images, and sounds. */\n    paths: z.looseObject({\n      /** Mapping of board IDs to their file paths. */\n      boards: z.record(z.string(), z.string()),\n      /** Mapping of image IDs to their file paths. */\n      images: z.record(z.string(), z.string()).optional(),\n      /** Mapping of sound IDs to their file paths. */\n      sounds: z.record(z.string(), z.string()).optional(),\n    }),\n  })\n  .refine((m) => Object.values(m.paths.boards).includes(m.root), {\n    message: \"root must be listed in paths.boards\",\n    path: [\"root\"],\n  });\n\n/** Table of contents for an `.obz` package, mapping resource IDs to their archive paths. See {@link OBFManifestSchema}. */\nexport type OBFManifest = z.infer<typeof OBFManifestSchema>;\n","/**\n * Typed errors for `@shayc/open-board-format`.\n *\n * Every failure thrown by this package is an {@link OBFError} carrying a\n * discriminated {@link OBFErrorInfo} on its `info` property. Switch on\n * `error.info.code` to get exactly the structured context for that failure —\n * the human-readable `message` is derived from `info` and is not part of the\n * stable contract.\n *\n * ```ts\n * try {\n *   await loadBoard(file);\n * } catch (error) {\n *   if (!(error instanceof OBFError)) throw error;\n *   switch (error.info.code) {\n *     case \"missing-resource\":\n *       reupload(error.info.kind, error.info.path); // both fully typed\n *       break;\n *     case \"invalid-board\":\n *       showIssues(error.info.issues);\n *       break;\n *   }\n * }\n * ```\n */\n\nimport { z } from \"zod\";\n\n/**\n * A single schema validation problem — Zod's issue shape, re-exported under a\n * domain name. `z.core.$ZodIssue` is the type Zod v4 designates for libraries\n * built on it (the bare `z.ZodIssue` is deprecated in its favor); aliasing it\n * gives consumers a stable OBF name without reaching into Zod's `core` export.\n */\nexport type OBFIssue = z.core.$ZodIssue;\n\n/**\n * Discriminated description of why an {@link OBFError} was thrown.\n *\n * Switch on `code`; each variant carries the fields relevant to it. When a\n * failure wraps an underlying error it lives on the standard `error.cause`,\n * never duplicated here. The only optional field is `invalid-board`'s\n * `boardId`, absent when validation runs on a value with no known id.\n */\nexport type OBFErrorInfo =\n  // --- decoding (underlying parser/decompressor error on `error.cause`) ---\n  /** Input was not parseable JSON. */\n  | { code: \"not-json\"; source: \"board\" | \"manifest\" }\n  /** An OBZ archive was expected, but the bytes are not a ZIP. */\n  | { code: \"not-zip\" }\n  /** A ZIP archive could not be decompressed. */\n  | { code: \"unreadable-zip\" }\n  // --- validation (underlying `ZodError` on `error.cause`) ---\n  /** A board failed schema validation. `boardId` is set when known. */\n  | { code: \"invalid-board\"; boardId?: string; issues: readonly OBFIssue[] }\n  /** A manifest failed schema validation. */\n  | { code: \"invalid-manifest\"; issues: readonly OBFIssue[] }\n  // --- archive structure (reading an .obz) ---\n  /** The archive has no `manifest.json`. */\n  | { code: \"missing-manifest\" }\n  /** A board the manifest declares is absent from the archive. */\n  | { code: \"missing-board\"; boardId: string; path: string }\n  /** A board's `id` disagrees with the id the manifest declares for it. */\n  | {\n      code: \"board-id-mismatch\";\n      path: string;\n      declaredId: string;\n      actualId: string;\n    }\n  // --- archive assembly (createOBZ) ---\n  /** `rootBoardId` matches none of the supplied boards. */\n  | { code: \"unknown-root\"; rootBoardId: string }\n  /** Two supplied boards share the same `id`. */\n  | { code: \"duplicate-board\"; boardId: string }\n  /** A board declares a media `path` with no matching resource. */\n  | {\n      code: \"missing-resource\";\n      kind: \"image\" | \"sound\";\n      mediaId: string;\n      path: string;\n    }\n  /** Two boards declare the same media id with different paths. */\n  | {\n      code: \"conflicting-paths\";\n      kind: \"image\" | \"sound\";\n      mediaId: string;\n      paths: [string, string];\n    }\n  /** A supplied resource would overwrite a generated board or the manifest. */\n  | { code: \"path-collision\"; path: string }\n  /** The archive could not be compressed. */\n  | { code: \"zip-failed\" }\n  /** An internal invariant was violated — a bug in this library; please report. */\n  | { code: \"internal\"; detail: string };\n\n/** Every `code` an {@link OBFError} can carry. */\nexport type OBFErrorCode = OBFErrorInfo[\"code\"];\n\n/**\n * The single error type thrown by `@shayc/open-board-format`.\n *\n * Branch on {@link OBFError.info} (a discriminated {@link OBFErrorInfo}) rather\n * than parsing {@link OBFError.message}. Any underlying error — a `JSON.parse`\n * failure, a `ZodError`, or an fflate error — is on the standard `error.cause`.\n */\nexport class OBFError extends Error {\n  /** Structured, discriminated description of the failure. */\n  readonly info: OBFErrorInfo;\n\n  constructor(info: OBFErrorInfo, options?: { cause?: unknown }) {\n    super(formatOBFError(info), options);\n    this.name = \"OBFError\";\n    this.info = info;\n  }\n}\n\n/** Derive a human-readable message from an {@link OBFErrorInfo}. */\nfunction formatOBFError(info: OBFErrorInfo): string {\n  switch (info.code) {\n    case \"not-json\":\n      return `Invalid ${info.source === \"manifest\" ? \"OBZ manifest\" : \"OBF\"}: not valid JSON`;\n    case \"not-zip\":\n      return \"Invalid OBZ: not a ZIP file\";\n    case \"unreadable-zip\":\n      return \"ZIP archive could not be read\";\n    case \"invalid-board\": {\n      const subject = info.boardId ? `board \"${info.boardId}\"` : \"board\";\n      return `Invalid OBF ${subject}:\\n${prettifyIssues(info.issues)}`;\n    }\n    case \"invalid-manifest\":\n      return `Invalid OBZ manifest:\\n${prettifyIssues(info.issues)}`;\n    case \"missing-manifest\":\n      return \"Invalid OBZ: missing manifest.json\";\n    case \"missing-board\":\n      return `Invalid OBZ: board \"${info.boardId}\" is declared in the manifest but missing at \"${info.path}\"`;\n    case \"board-id-mismatch\":\n      return `Invalid OBZ: board at \"${info.path}\" has id \"${info.actualId}\" but the manifest declares it as \"${info.declaredId}\"`;\n    case \"unknown-root\":\n      return `Invalid OBZ: rootBoardId \"${info.rootBoardId}\" does not match any supplied board`;\n    case \"duplicate-board\":\n      return `Invalid OBZ: duplicate board id \"${info.boardId}\" — board ids must be unique within a package`;\n    case \"missing-resource\":\n      return `Invalid OBZ: ${info.kind} \"${info.mediaId}\" references \"${info.path}\" but no matching resource was supplied`;\n    case \"conflicting-paths\":\n      return `Invalid OBZ: ${info.kind} id \"${info.mediaId}\" maps to conflicting paths \"${info.paths[0]}\" and \"${info.paths[1]}\"`;\n    case \"path-collision\":\n      return `Invalid OBZ: resource path \"${info.path}\" collides with a generated board or manifest entry`;\n    case \"zip-failed\":\n      return \"Failed to build ZIP archive\";\n    case \"internal\":\n      return `Internal error (please report): ${info.detail}`;\n    /* v8 ignore start -- exhaustiveness guard: unreachable, enforced at compile time */\n    default: {\n      const _exhaustive: never = info;\n      return _exhaustive;\n    }\n    /* v8 ignore stop */\n  }\n}\n\n/** Render schema issues using Zod's pretty formatter. */\nfunction prettifyIssues(issues: readonly OBFIssue[]): string {\n  return z.prettifyError(new z.ZodError([...issues]));\n}\n","/**\n * Parsing, validation, and serialization for single `.obf` board files.\n */\n\nimport { OBFError } from \"./errors\";\nimport type { OBFBoard } from \"./schema\";\nimport { OBFBoardSchema } from \"./schema\";\n\nconst UTF8_BOM = \"\\uFEFF\";\n\n/** Strip a leading UTF-8 BOM, which some editors silently prepend. */\nfunction stripBom(text: string): string {\n  return text.startsWith(UTF8_BOM) ? text.slice(1) : text;\n}\n\n/**\n * Parse a JSON string into a validated OBF board.\n *\n * Strips an optional UTF-8 BOM prefix before parsing and throws a\n * descriptive error if the input is malformed or fails schema validation.\n *\n * @param json - The JSON string to parse.\n * @returns The validated board object.\n *\n * @throws {@link OBFError} with `info.code` `\"not-json\"` if the JSON is\n *   malformed, or `\"invalid-board\"` if it fails schema validation.\n */\nexport function parseOBF(json: string): OBFBoard {\n  const sanitized = stripBom(json);\n\n  let rawBoard: unknown;\n\n  try {\n    rawBoard = JSON.parse(sanitized) as unknown;\n  } catch (error) {\n    throw new OBFError({ code: \"not-json\", source: \"board\" }, { cause: error });\n  }\n\n  return validateOBF(rawBoard);\n}\n\n/**\n * Read a `File` and parse its contents as a validated OBF board.\n *\n * This relies on the browser `File` API; for Node environments,\n * read the file to a string and pass it to {@link parseOBF} instead.\n *\n * @param file - A `File` handle pointing to an `.obf` file.\n * @returns The validated board object.\n *\n * @throws {@link OBFError} with `info.code` `\"not-json\"` if the file content is\n *   malformed, or `\"invalid-board\"` if it fails schema validation.\n */\nexport async function loadOBF(file: File): Promise<OBFBoard> {\n  const json = await file.text();\n  return parseOBF(json);\n}\n\n/**\n * Validate an unknown value against the OBF board schema.\n *\n * @param data - The value to validate.\n * @returns The validated board object.\n *\n * @throws {@link OBFError} with `info.code` `\"invalid-board\"` if the value fails\n *   schema validation. `info.issues` holds the underlying Zod issues.\n */\nexport function validateOBF(data: unknown): OBFBoard {\n  const result = OBFBoardSchema.safeParse(data);\n\n  if (!result.success) {\n    throw new OBFError(\n      { code: \"invalid-board\", issues: result.error.issues },\n      { cause: result.error },\n    );\n  }\n\n  return result.data;\n}\n\n/**\n * Stringify an OBF board to a pretty-printed JSON string.\n *\n * @param board - The board to stringify.\n * @returns A JSON string with two-space indentation.\n */\nexport function stringifyOBF(board: OBFBoard): string {\n  return JSON.stringify(board, null, 2);\n}\n","/**\n * Minimal ZIP helpers over fflate: signature sniffing, unzip, and zip.\n */\n\nimport { unzip as fflateUnzip, zip as fflateZip } from \"fflate\";\nimport { OBFError } from \"./errors\";\n\n/**\n * First two bytes of every ZIP archive — the ASCII letters `PK`,\n * after Phil Katz, creator of the format.\n *\n * Only the 2-byte prefix is checked intentionally: this keeps the\n * test lightweight and sufficient for distinguishing ZIP from JSON.\n */\nconst ZIP_MAGIC = [0x50, 0x4b] as const;\n\n/** Balanced speed-vs-size deflate level, on fflate's 0–9 scale (0 = store). */\nconst COMPRESSION_LEVEL = 6;\n\n/**\n * Decompress a ZIP archive into a map of file paths to raw bytes.\n *\n * @param archive - The ZIP archive as an `ArrayBuffer`.\n * @returns A map of file paths to their decompressed content.\n *\n * @throws {@link OBFError} with `info.code` `\"unreadable-zip\"` if the archive is\n *   corrupt or cannot be decompressed.\n */\nexport function unzip(archive: ArrayBuffer): Promise<Map<string, Uint8Array>> {\n  return new Promise((resolve, reject) => {\n    const compressed = new Uint8Array(archive);\n\n    fflateUnzip(compressed, (error, entries) => {\n      if (error) {\n        reject(new OBFError({ code: \"unreadable-zip\" }, { cause: error }));\n        return;\n      }\n\n      const pathToBytes = new Map<string, Uint8Array>(Object.entries(entries));\n\n      resolve(pathToBytes);\n    });\n  });\n}\n\n/**\n * Compress a map of file paths and contents into a single ZIP archive.\n *\n * Accepts both `Uint8Array` and `ArrayBuffer` values so callers can\n * pass the output of {@link unzip} directly or supply raw `ArrayBuffer`s\n * without converting first.\n *\n * @param entries - A map of file paths to their content bytes.\n * @returns The compressed archive as a `Uint8Array`.\n *\n * @throws {@link OBFError} with `info.code` `\"zip-failed\"` if fflate fails to\n *   compress an entry.\n */\nexport function zip(\n  entries: Map<string, Uint8Array | ArrayBuffer>,\n): Promise<Uint8Array> {\n  return new Promise((resolve, reject) => {\n    const pathToBytes: Record<string, Uint8Array> = {};\n\n    for (const [path, content] of entries) {\n      pathToBytes[path] =\n        content instanceof Uint8Array ? content : new Uint8Array(content);\n    }\n\n    fflateZip(pathToBytes, { level: COMPRESSION_LEVEL }, (error, result) => {\n      if (error) {\n        reject(new OBFError({ code: \"zip-failed\" }, { cause: error }));\n        return;\n      }\n\n      resolve(result);\n    });\n  });\n}\n\n/**\n * Test whether an `ArrayBuffer` begins with the two-byte ZIP magic\n * prefix (`PK`).\n *\n * @param archive - The buffer to inspect.\n * @returns `true` if the buffer starts with the ZIP signature.\n */\nexport function isZip(archive: ArrayBuffer): boolean {\n  const bytes = new Uint8Array(archive);\n\n  return (\n    bytes.length >= ZIP_MAGIC.length &&\n    ZIP_MAGIC.every((byte, index) => bytes[index] === byte)\n  );\n}\n","/**\n * Creation and extraction of `.obz` board packages.\n */\n\nimport { OBFError } from \"./errors\";\nimport { parseOBF } from \"./obf\";\nimport type { OBFBoard, OBFManifest } from \"./schema\";\nimport { OBFBoardSchema, OBFManifestSchema } from \"./schema\";\nimport { isZip, unzip, zip } from \"./zip\";\n\n/**\n * Fully extracted contents of an `.obz` archive.\n */\nexport interface ParsedOBZ {\n  /** The package's table of contents. */\n  manifest: OBFManifest;\n  /** Validated board objects keyed by board ID. */\n  boards: Map<string, OBFBoard>;\n  /**\n   * The package's entry-point board — the one `manifest.root` points at,\n   * already resolved. Same object as `boards.get(rootBoard.id)`.\n   */\n  rootBoard: OBFBoard;\n  /**\n   * Raw bytes for every entry in the archive, keyed by archive path —\n   * including `manifest.json` and the `.obf` boards as well as media\n   * such as images and sounds.\n   */\n  resources: Map<string, Uint8Array>;\n}\n\n/**\n * Read a `File` and extract its contents as a parsed OBZ package.\n *\n * This relies on the browser `File` API; for Node environments,\n * read the file to an `ArrayBuffer` and pass it to {@link extractOBZ} instead.\n *\n * @param file - A `File` handle pointing to an `.obz` archive.\n * @returns The parsed manifest, boards, root board, and binary resources.\n *\n * @throws {@link OBFError} — the same failures as {@link extractOBZ}, which\n *   this delegates to.\n */\nexport async function loadOBZ(file: File): Promise<ParsedOBZ> {\n  const archive = await file.arrayBuffer();\n  return extractOBZ(archive);\n}\n\n/**\n * Decompress an OBZ archive and return its manifest, boards, and resources.\n *\n * @param archive - The OBZ archive as an `ArrayBuffer`.\n * @returns A {@link ParsedOBZ} with the archive's manifest, boards, root\n *          board, and resources.\n *\n * @throws {@link OBFError}; branch on `info.code`: `\"not-zip\"`,\n *   `\"unreadable-zip\"`, `\"missing-manifest\"`, `\"not-json\"` or\n *   `\"invalid-manifest\"` (bad manifest), `\"missing-board\"`,\n *   `\"board-id-mismatch\"`, or `\"invalid-board\"` (a board fails validation).\n */\nexport async function extractOBZ(archive: ArrayBuffer): Promise<ParsedOBZ> {\n  if (!isZip(archive)) {\n    throw new OBFError({ code: \"not-zip\" });\n  }\n\n  const entries = await unzip(archive);\n\n  const manifest = extractManifest(entries);\n  const { boards, rootBoard } = extractBoards(manifest, entries);\n\n  return { manifest, boards, rootBoard, resources: entries };\n}\n\n/**\n * Parse and validate an OBZ manifest — the table of contents that maps\n * board IDs to their file paths within the archive.\n *\n * @param json - A JSON string representing the manifest.\n * @returns The validated manifest object.\n *\n * @throws {@link OBFError} with `info.code` `\"not-json\"` if the JSON is\n *   malformed, or `\"invalid-manifest\"` if it fails schema validation.\n */\nexport function parseManifest(json: string): OBFManifest {\n  let data: unknown;\n\n  try {\n    data = JSON.parse(json) as unknown;\n  } catch (error) {\n    throw new OBFError(\n      { code: \"not-json\", source: \"manifest\" },\n      { cause: error },\n    );\n  }\n\n  const result = OBFManifestSchema.safeParse(data);\n\n  if (!result.success) {\n    throw new OBFError(\n      { code: \"invalid-manifest\", issues: result.error.issues },\n      { cause: result.error },\n    );\n  }\n\n  return result.data;\n}\n\n/**\n * Bundle boards and optional resources into a compressed OBZ archive.\n *\n * A manifest is generated automatically from the supplied boards,\n * using the `rootBoardId` to designate the entry-point board.\n *\n * Every failure is an {@link OBFError}; branch on `info.code`.\n *\n * @param boards - The boards to include in the archive.\n * @param rootBoardId - The ID of the board that serves as the archive's entry point.\n * @param resources - Optional map of file paths to binary content (images, sounds, etc.).\n * @returns A `Blob` containing the compressed OBZ archive.\n *\n * @throws {@link OBFError} `\"unknown-root\"` if `rootBoardId` does not match any of the supplied boards.\n * @throws {@link OBFError} `\"duplicate-board\"` if two supplied boards share the same ID.\n * @throws {@link OBFError} `\"invalid-board\"` if a supplied board fails schema validation.\n * @throws {@link OBFError} `\"conflicting-paths\"` if two boards declare the same media ID with conflicting paths.\n * @throws {@link OBFError} `\"missing-resource\"` if a board declares an image or sound `path` with no matching entry in `resources`.\n * @throws {@link OBFError} `\"path-collision\"` if a `resources` entry would overwrite the generated `manifest.json` or a board file.\n */\nexport async function createOBZ(\n  boards: OBFBoard[],\n  rootBoardId: string,\n  resources?: Map<string, Uint8Array | ArrayBuffer>,\n): Promise<Blob> {\n  if (!boards.some((board) => board.id === rootBoardId)) {\n    throw new OBFError({ code: \"unknown-root\", rootBoardId });\n  }\n\n  const seenBoardIds = new Set<string>();\n  for (const board of boards) {\n    if (seenBoardIds.has(board.id)) {\n      throw new OBFError({ code: \"duplicate-board\", boardId: board.id });\n    }\n    seenBoardIds.add(board.id);\n  }\n\n  const entries = new Map<string, Uint8Array | ArrayBuffer>();\n\n  const boardPaths = Object.fromEntries(\n    boards.map((board) => [board.id, `boards/${board.id}.obf`]),\n  );\n\n  const imagePaths = collectMediaPaths(boards, \"images\");\n  const soundPaths = collectMediaPaths(boards, \"sounds\");\n\n  const manifestResult = OBFManifestSchema.safeParse({\n    format: \"open-board-0.1\",\n    root: `boards/${rootBoardId}.obf`,\n    paths: {\n      boards: boardPaths,\n      images: imagePaths,\n      ...(Object.keys(soundPaths).length > 0 ? { sounds: soundPaths } : {}),\n    },\n  });\n\n  /* v8 ignore start -- defensive: the manifest is built from already-validated inputs */\n  if (!manifestResult.success) {\n    throw new OBFError(\n      { code: \"internal\", detail: \"generated manifest failed validation\" },\n      { cause: manifestResult.error },\n    );\n  }\n  /* v8 ignore stop */\n\n  const manifest = manifestResult.data;\n\n  const encoder = new TextEncoder();\n\n  entries.set(\n    \"manifest.json\",\n    encoder.encode(JSON.stringify(manifest, null, 2)),\n  );\n\n  for (const board of boards) {\n    const result = OBFBoardSchema.safeParse(board);\n    if (!result.success) {\n      throw new OBFError(\n        {\n          code: \"invalid-board\",\n          boardId: board.id,\n          issues: result.error.issues,\n        },\n        { cause: result.error },\n      );\n    }\n    const path = `boards/${result.data.id}.obf`;\n    entries.set(path, encoder.encode(JSON.stringify(result.data, null, 2)));\n  }\n\n  if (resources) {\n    for (const [path, bytes] of resources) {\n      if (entries.has(path)) {\n        throw new OBFError({ code: \"path-collision\", path });\n      }\n      entries.set(path, bytes);\n    }\n  }\n\n  assertPathsPresent(\"image\", imagePaths, entries);\n  assertPathsPresent(\"sound\", soundPaths, entries);\n\n  const compressed = await zip(entries);\n  return new Blob([compressed], { type: \"application/zip\" });\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Walk every board's media collection and produce the `{ id -> path }` map\n * the spec calls \"redundant but still required\" for the OBZ manifest.\n *\n * Throws when two boards declare the same media ID with conflicting paths\n * — a silent OBZ that points at a non-existent file is worse than a clear error.\n */\nfunction collectMediaPaths(\n  boards: OBFBoard[],\n  kind: \"images\" | \"sounds\",\n): Record<string, string> {\n  const paths: Record<string, string> = {};\n\n  for (const board of boards) {\n    for (const media of board[kind] ?? []) {\n      if (media.path === undefined) {\n        continue;\n      }\n\n      const existing = paths[media.id];\n      if (existing !== undefined && existing !== media.path) {\n        throw new OBFError({\n          code: \"conflicting-paths\",\n          kind: kind === \"images\" ? \"image\" : \"sound\",\n          mediaId: media.id,\n          paths: [existing, media.path],\n        });\n      }\n      paths[media.id] = media.path;\n    }\n  }\n\n  return paths;\n}\n\n/**\n * Assert that every media path the generated manifest declares exists as an\n * archive entry — the same contract {@link extractOBZ} assumes when reading.\n *\n * Only media that declared a `path` reach this check, so `url`/`data`-only\n * media are never flagged.\n */\nfunction assertPathsPresent(\n  kind: \"image\" | \"sound\",\n  paths: Record<string, string>,\n  entries: Map<string, Uint8Array | ArrayBuffer>,\n): void {\n  for (const [id, path] of Object.entries(paths)) {\n    if (!entries.has(path)) {\n      throw new OBFError({\n        code: \"missing-resource\",\n        kind,\n        mediaId: id,\n        path,\n      });\n    }\n  }\n}\n\nfunction extractManifest(entries: Map<string, Uint8Array>): OBFManifest {\n  const manifestBytes = entries.get(\"manifest.json\");\n\n  if (!manifestBytes) {\n    throw new OBFError({ code: \"missing-manifest\" });\n  }\n\n  const manifestJson = new TextDecoder().decode(manifestBytes);\n  return parseManifest(manifestJson);\n}\n\nfunction extractBoards(\n  manifest: OBFManifest,\n  entries: Map<string, Uint8Array>,\n): { boards: Map<string, OBFBoard>; rootBoard: OBFBoard } {\n  const boards = new Map<string, OBFBoard>();\n  let rootBoard: OBFBoard | undefined;\n\n  for (const [id, path] of Object.entries(manifest.paths.boards)) {\n    const boardBytes = entries.get(path);\n\n    if (!boardBytes) {\n      throw new OBFError({ code: \"missing-board\", boardId: id, path });\n    }\n\n    const boardJson = new TextDecoder().decode(boardBytes);\n    const board = parseOBF(boardJson);\n\n    if (board.id !== id) {\n      throw new OBFError({\n        code: \"board-id-mismatch\",\n        path,\n        declaredId: id,\n        actualId: board.id,\n      });\n    }\n\n    boards.set(id, board);\n\n    if (path === manifest.root) {\n      rootBoard = board;\n    }\n  }\n\n  // `OBFManifestSchema` requires `root` to be one of `paths.boards`, so the loop\n  // above always assigns `rootBoard` for the validated manifests we receive.\n  /* v8 ignore start -- defensive: OBFManifestSchema guarantees root ∈ paths.boards */\n  if (!rootBoard) {\n    throw new OBFError({\n      code: \"internal\",\n      detail: `root board \"${manifest.root}\" not found in paths.boards`,\n    });\n  }\n  /* v8 ignore stop */\n\n  return { boards, rootBoard };\n}\n","/**\n * Format-agnostic loading of `.obf` boards and `.obz` packages.\n */\n\nimport { parseOBF } from \"./obf\";\nimport { extractOBZ } from \"./obz\";\nimport type { ParsedOBZ } from \"./obz\";\nimport type { OBFBoard } from \"./schema\";\nimport { isZip } from \"./zip\";\n\n/**\n * Result of {@link loadBoard} — a discriminated union over the two file\n * shapes the Open Board Format defines.\n *\n * Switch on `format` to narrow:\n *\n * ```ts\n * const loaded = await loadBoard(file);\n * if (loaded.format === \"obz\") {\n *   loaded.archive.rootBoard; // home board of the ParsedOBZ archive\n * } else {\n *   loaded.board;             // OBFBoard\n * }\n * ```\n */\nexport type LoadedBoard =\n  | { format: \"obz\"; archive: ParsedOBZ }\n  | { format: \"obf\"; board: OBFBoard };\n\n/**\n * Detect whether the input is a single OBF board or an OBZ package and load it\n * accordingly.\n *\n * Input that begins with the ZIP magic prefix is treated as an `.obz` package;\n * anything else is parsed as an `.obf` board. The input is read once, so\n * consumers can accept either format from a single drag-and-drop, file picker,\n * or fetch response without inspecting the file extension or re-deriving the\n * OBF-vs-OBZ distinction themselves.\n *\n * @param input - A `File` handle or `ArrayBuffer` holding `.obf` or `.obz` content.\n * @returns A discriminated union tagged by `format`.\n *\n * @throws {@link OBFError} — the OBZ failures of {@link extractOBZ} when the\n *   input is an archive, or the OBF failures of {@link parseOBF} otherwise.\n *   Branch on `error.info.code`.\n */\nexport async function loadBoard(\n  input: File | ArrayBuffer,\n): Promise<LoadedBoard> {\n  const buffer =\n    input instanceof ArrayBuffer ? input : await input.arrayBuffer();\n\n  if (isZip(buffer)) {\n    return { format: \"obz\", archive: await extractOBZ(buffer) };\n  }\n\n  return { format: \"obf\", board: parseOBF(new TextDecoder().decode(buffer)) };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shayc/open-board-format",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "A TypeScript toolkit for Open Board Format — the open standard for Augmentative and Alternative Communication (AAC) boards.",
   "license": "MIT",
   "author": "Shay Cojocaru <shayc@outlook.com>",