@openrails/contentkit-ui 0.0.0-stage → 0.68.1

package/dist/client/crop.js

@@ -0,0 +1,103 @@
+//#region src/client/crop.ts
+function e(e, t, n, r = 0) {
+	let i = Math.max(1, Math.round(t.width)), a = Math.max(1, Math.round(t.height)), o = l(Math.round(e.w), 1, i), s = l(Math.round(e.h), 1, a);
+	if (n && n > 0) {
+		let e = r === 90 || r === 270 ? 1 / n : n;
+		for (s = Math.round(o / e), s > a && (o = Math.round(a * e)), o = l(o, 1, i), s = Math.round(o / e); s > a && o > 1;) s = Math.round(--o / e);
+		for (; s < 1 && o < i;) s = Math.round(++o / e);
+		s = Math.max(1, s);
+	}
+	return {
+		x: l(Math.round(e.x), 0, i - o),
+		y: l(Math.round(e.y), 0, a - s),
+		w: o,
+		h: s
+	};
+}
+function t(e, t, r, a = 0) {
+	let o = n(r, a), s = o.width / t.width, c = o.height / t.height;
+	return i({
+		x: e.x * s,
+		y: e.y * c,
+		w: e.w * s,
+		h: e.h * c
+	}, r, a);
+}
+function n(e, t = 0) {
+	return t === 90 || t === 270 ? {
+		width: e.height,
+		height: e.width
+	} : e;
+}
+function r(e, t, n) {
+	let { width: r, height: i } = t;
+	return n === 90 ? {
+		x: i - (e.y + e.h),
+		y: e.x,
+		w: e.h,
+		h: e.w
+	} : n === 180 ? {
+		x: r - (e.x + e.w),
+		y: i - (e.y + e.h),
+		w: e.w,
+		h: e.h
+	} : n === 270 ? {
+		x: e.y,
+		y: r - (e.x + e.w),
+		w: e.h,
+		h: e.w
+	} : e;
+}
+function i(e, t, n) {
+	let { width: r, height: i } = t;
+	return n === 90 ? {
+		x: e.y,
+		y: i - (e.x + e.w),
+		w: e.h,
+		h: e.w
+	} : n === 180 ? {
+		x: r - (e.x + e.w),
+		y: i - (e.y + e.h),
+		w: e.w,
+		h: e.h
+	} : n === 270 ? {
+		x: r - (e.y + e.h),
+		y: e.x,
+		w: e.h,
+		h: e.w
+	} : e;
+}
+function a(t, n, r = 0) {
+	let i = e({
+		x: 0,
+		y: 0,
+		w: t.width,
+		h: t.height
+	}, t, n, r);
+	return {
+		...i,
+		x: Math.floor((t.width - i.w) / 2),
+		y: Math.floor((t.height - i.h) / 2)
+	};
+}
+function o(e, t, n = 0) {
+	let r = !e || e.x === 0 && e.y === 0 && e.w === t.width && e.h === t.height;
+	return r && n === 0 ? null : {
+		...r ? {} : { crop: e },
+		...n ? { rotate: n } : {}
+	};
+}
+function s(e, t) {
+	let n = e?.crop, r = t?.crop;
+	return (e?.rotate ?? 0) === (t?.rotate ?? 0) && (n === r || !!n && !!r && n.x === r.x && n.y === r.y && n.w === r.w && n.h === r.h);
+}
+function c(e) {
+	return (Math.round(e / 90) * 90 % 360 + 360) % 360;
+}
+function l(e, t, n) {
+	return Math.min(Math.max(e, t), n);
+}
+//#endregion
+export { a as centeredCrop, e as constrainCrop, o as editOf, n as editedSize, i as fromRotated, c as rotation, s as sameEdit, t as toOriginal, r as toRotated };
+
+//# sourceMappingURL=crop.js.map

package/dist/client/crop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crop.js","names":[],"sources":["../../src/client/crop.ts"],"sourcesContent":["import type { Crop, Edit } from \"./generated/wire.js\";\n\n/** Clockwise degrees. */\nexport type Rotation = 0 | 90 | 180 | 270;\n\nexport interface Size {\n  width: number;\n  height: number;\n}\n\n/**\n * Fits rect (original pixels) inside source as whole pixels. With aspect (the\n * edited image's width/height; with a 90/270 rotation the crop is its\n * transpose) the height follows the width exactly as the server derives it.\n */\nexport function constrainCrop(rect: Crop, source: Size, aspect?: number, rotate: Rotation = 0): Crop {\n  const W = Math.max(1, Math.round(source.width));\n  const H = Math.max(1, Math.round(source.height));\n  let w = clamp(Math.round(rect.w), 1, W);\n  let h = clamp(Math.round(rect.h), 1, H);\n  if (aspect && aspect > 0) {\n    const r = rotate === 90 || rotate === 270 ? 1 / aspect : aspect; // crop width / height\n    h = Math.round(w / r);\n    if (h > H) w = Math.round(H * r);\n    w = clamp(w, 1, W);\n    h = Math.round(w / r);\n    while (h > H && w > 1) h = Math.round(--w / r);\n    while (h < 1 && w < W) h = Math.round(++w / r);\n    h = Math.max(1, h);\n  }\n  return { x: clamp(Math.round(rect.x), 0, W - w), y: clamp(Math.round(rect.y), 0, H - h), w, h };\n}\n\n/**\n * Maps a rect on the image shown at display size to original pixels. With a\n * rotation, display is the rotated image (as a cropper shows it) and the rect\n * is mapped back through the rotation.\n */\nexport function toOriginal(rect: Crop, display: Size, source: Size, rotate: Rotation = 0): Crop {\n  const shown = editedSize(source, rotate);\n  const sx = shown.width / display.width;\n  const sy = shown.height / display.height;\n  return fromRotated({ x: rect.x * sx, y: rect.y * sy, w: rect.w * sx, h: rect.h * sy }, source, rotate);\n}\n\n/** The image's size after a clockwise rotation. */\nexport function editedSize(source: Size, rotate: Rotation = 0): Size {\n  return rotate === 90 || rotate === 270 ? { width: source.height, height: source.width } : source;\n}\n\n/** A rect in original pixels as it lies on the image turned clockwise by rotate. */\nexport function toRotated(r: Crop, source: Size, rotate: Rotation): Crop {\n  const { width: W, height: H } = source;\n  if (rotate === 90) return { x: H - (r.y + r.h), y: r.x, w: r.h, h: r.w };\n  if (rotate === 180) return { x: W - (r.x + r.w), y: H - (r.y + r.h), w: r.w, h: r.h };\n  if (rotate === 270) return { x: r.y, y: W - (r.x + r.w), w: r.h, h: r.w };\n  return r;\n}\n\n/** Inverse of toRotated: a rect on the rotated image back in original pixels. */\nexport function fromRotated(r: Crop, source: Size, rotate: Rotation): Crop {\n  const { width: W, height: H } = source;\n  if (rotate === 90) return { x: r.y, y: H - (r.x + r.w), w: r.h, h: r.w };\n  if (rotate === 180) return { x: W - (r.x + r.w), y: H - (r.y + r.h), w: r.w, h: r.h };\n  if (rotate === 270) return { x: W - (r.y + r.h), y: r.x, w: r.h, h: r.w };\n  return r;\n}\n\n/** The largest centred crop (at aspect, if any). */\nexport function centeredCrop(source: Size, aspect?: number, rotate: Rotation = 0): Crop {\n  const c = constrainCrop({ x: 0, y: 0, w: source.width, h: source.height }, source, aspect, rotate);\n  return { ...c, x: Math.floor((source.width - c.w) / 2), y: Math.floor((source.height - c.h) / 2) };\n}\n\n/** The edit for a crop and rotation; null when it changes nothing. */\nexport function editOf(crop: Crop | null, source: Size, rotate: Rotation = 0): Edit | null {\n  const full = !crop || (crop.x === 0 && crop.y === 0 && crop.w === source.width && crop.h === source.height);\n  if (full && rotate === 0) return null;\n  return { ...(full ? {} : { crop }), ...(rotate ? { rotate } : {}) };\n}\n\n/** Whether two edits are the same value (null and an empty edit are). */\nexport function sameEdit(a: Edit | null | undefined, b: Edit | null | undefined): boolean {\n  const x = a?.crop, y = b?.crop;\n  return (a?.rotate ?? 0) === (b?.rotate ?? 0) && (x === y || (!!x && !!y && x.x === y.x && x.y === y.y && x.w === y.w && x.h === y.h));\n}\n\nexport function rotation(deg: number): Rotation {\n  return ((((Math.round(deg / 90) * 90) % 360) + 360) % 360) as Rotation;\n}\n\nfunction clamp(v: number, lo: number, hi: number) {\n  return Math.min(Math.max(v, lo), hi);\n}\n"],"mappings":"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"}

package/dist/client/errors.d.ts

@@ -0,0 +1,54 @@
+import { ErrorCode } from './generated/error-codes.js';
+import { BanNotice, ErrorDetails, Failure } from './generated/wire.js';
+/**
+ * Codes raised in the browser: network (no response), storage (the bucket
+ * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state
+ * is not for this file), decode (not readable as an image) and render_timeout
+ * (still processing after the wait).
+ */
+export declare const CLIENT_ERROR_CODES: readonly ["network", "storage", "aborted", "resume_mismatch", "decode", "render_timeout"];
+export type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];
+/** Every code a ContentKitError can carry: the server's registry, then the client's. */
+export declare const ERROR_CODES: readonly ContentKitErrorCode[];
+export interface ContentKitErrorInit extends ErrorOptions {
+    status?: number;
+    retryAfter?: number;
+    details?: ErrorDetails;
+    blobs?: string[];
+    ban?: BanNotice;
+    action?: string;
+}
+export declare class ContentKitError extends Error {
+    readonly code: ContentKitErrorCode;
+    readonly name = "ContentKitError";
+    /** HTTP status; 0 for client-side codes. */
+    readonly status: number;
+    readonly retryAfter?: number;
+    readonly details?: ErrorDetails;
+    readonly blobs?: string[];
+    readonly ban?: BanNotice;
+    readonly action?: string;
+    constructor(code: ContentKitErrorCode, message: string, init?: ContentKitErrorInit);
+    /**
+     * The request broke a rule the message states (a 4xx or a typed refusal),
+     * as opposed to a fault on the server or the network: show it as is.
+     */
+    get refusal(): boolean;
+    /** Rate or quota refusals: stop starting new requests until the limit frees. */
+    get isLimit(): boolean;
+    /** The commit would exceed the kind's file caps (too_many_files, 409): remove files first. */
+    get isCeiling(): boolean;
+    /** Refusals that apply to every upload of this caller, not just this file. */
+    get blocksQueue(): boolean;
+    /** Worth retrying the same request. */
+    get transient(): boolean;
+}
+export declare const isContentKitError: (e: unknown) => e is ContentKitError;
+/** Anything a call can throw, as a ContentKitError (network when it is not one). */
+export declare function toContentKitError(e: unknown): ContentKitError;
+export declare function aborted(signal?: AbortSignal): ContentKitError;
+export declare function throwIfAborted(signal?: AbortSignal): void;
+/** Reads a response that is not 2xx. */
+export declare function readContentKitError(res: Response): Promise<ContentKitError>;
+/** An upload's recorded processing failure: its typed refusal, else a processing fault. */
+export declare function failureError(f: Failure): ContentKitError;

package/dist/client/errors.js

@@ -0,0 +1,80 @@
+import { CONTENTKIT_ERROR_CODES as e } from "./generated/error-codes.js";
+//#region src/client/errors.ts
+var t = [
+	"network",
+	"storage",
+	"aborted",
+	"resume_mismatch",
+	"decode",
+	"render_timeout"
+], n = [...Object.keys(e), ...t], r = class extends Error {
+	code;
+	name = "ContentKitError";
+	status;
+	retryAfter;
+	details;
+	blobs;
+	ban;
+	action;
+	constructor(e, t, n = {}) {
+		super(t, n.cause === void 0 ? void 0 : { cause: n.cause }), this.code = e, this.status = n.status ?? 0, this.retryAfter = n.retryAfter, this.details = n.details, this.blobs = n.blobs, this.ban = n.ban, this.action = n.action;
+	}
+	get refusal() {
+		return this.status >= 400 && this.status < 500 && this.code !== "storage" || this.code.startsWith("image_") || this.code === "decode";
+	}
+	get isLimit() {
+		return this.code === "rate_limited" || this.code === "quota_exceeded";
+	}
+	get isCeiling() {
+		return this.code === "too_many_files";
+	}
+	get blocksQueue() {
+		return this.isLimit || this.code === "unauthorized" || this.code === "forbidden";
+	}
+	get transient() {
+		return this.code === "network" || this.code === "internal_error" || this.code === "unavailable" || this.code === "storage" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429);
+	}
+}, i = (e) => e instanceof r;
+function a(e) {
+	return e instanceof r ? e : new r("network", e instanceof Error ? e.message : String(e), { cause: e });
+}
+function o(e) {
+	return new r("aborted", "request canceled", { cause: e?.reason });
+}
+function s(e) {
+	if (e?.aborted) throw o(e);
+}
+var c = {
+	401: "unauthorized",
+	403: "forbidden",
+	404: "not_found",
+	409: "conflict",
+	410: "gone",
+	413: "too_large",
+	415: "type_not_allowed",
+	429: "rate_limited",
+	501: "not_configured",
+	503: "unavailable"
+}, l = new Set(n);
+async function u(e) {
+	let t = {};
+	try {
+		t = await e.json();
+	} catch {}
+	let n = Number(e.headers.get("Retry-After")), i = t.retry_after ?? (Number.isFinite(n) && n > 0 ? n : void 0);
+	return new r(t.code && l.has(t.code) ? t.code : c[e.status] ?? (e.status >= 500 ? "internal_error" : "invalid_request"), t.error ?? `HTTP ${e.status}`, {
+		status: e.status,
+		retryAfter: i,
+		blobs: t.blobs,
+		details: t.details,
+		ban: t.ban,
+		action: t.action
+	});
+}
+function d(e) {
+	return new r(e.code && l.has(e.code) ? e.code : "internal_error", e.message, { details: e.details });
+}
+//#endregion
+export { t as CLIENT_ERROR_CODES, r as ContentKitError, n as ERROR_CODES, o as aborted, d as failureError, i as isContentKitError, u as readContentKitError, s as throwIfAborted, a as toContentKitError };
+
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["import { CONTENTKIT_ERROR_CODES, type ErrorCode } from \"./generated/error-codes.js\";\nimport type { BanNotice, ErrorDetails, ErrorReply, Failure } from \"./generated/wire.js\";\n\n/**\n * Codes raised in the browser: network (no response), storage (the bucket\n * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state\n * is not for this file), decode (not readable as an image) and render_timeout\n * (still processing after the wait).\n */\nexport const CLIENT_ERROR_CODES = [\"network\", \"storage\", \"aborted\", \"resume_mismatch\", \"decode\", \"render_timeout\"] as const;\n\nexport type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];\n\n/** Every code a ContentKitError can carry: the server's registry, then the client's. */\nexport const ERROR_CODES: readonly ContentKitErrorCode[] = [...(Object.keys(CONTENTKIT_ERROR_CODES) as ErrorCode[]), ...CLIENT_ERROR_CODES];\n\nexport interface ContentKitErrorInit extends ErrorOptions {\n  status?: number;\n  retryAfter?: number;\n  details?: ErrorDetails;\n  blobs?: string[];\n  ban?: BanNotice;\n  action?: string;\n}\n\nexport class ContentKitError extends Error {\n  override readonly name = \"ContentKitError\";\n  /** HTTP status; 0 for client-side codes. */\n  readonly status: number;\n  readonly retryAfter?: number;\n  readonly details?: ErrorDetails;\n  readonly blobs?: string[];\n  readonly ban?: BanNotice;\n  readonly action?: string;\n\n  constructor(\n    readonly code: ContentKitErrorCode,\n    message: string,\n    init: ContentKitErrorInit = {},\n  ) {\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.status = init.status ?? 0;\n    this.retryAfter = init.retryAfter;\n    this.details = init.details;\n    this.blobs = init.blobs;\n    this.ban = init.ban;\n    this.action = init.action;\n  }\n\n  /**\n   * The request broke a rule the message states (a 4xx or a typed refusal),\n   * as opposed to a fault on the server or the network: show it as is.\n   */\n  get refusal(): boolean {\n    return (this.status >= 400 && this.status < 500 && this.code !== \"storage\") || this.code.startsWith(\"image_\") || this.code === \"decode\";\n  }\n\n  /** Rate or quota refusals: stop starting new requests until the limit frees. */\n  get isLimit(): boolean {\n    return this.code === \"rate_limited\" || this.code === \"quota_exceeded\";\n  }\n\n  /** The commit would exceed the kind's file caps (too_many_files, 409): remove files first. */\n  get isCeiling(): boolean {\n    return this.code === \"too_many_files\";\n  }\n\n  /** Refusals that apply to every upload of this caller, not just this file. */\n  get blocksQueue(): boolean {\n    return this.isLimit || this.code === \"unauthorized\" || this.code === \"forbidden\";\n  }\n\n  /** Worth retrying the same request. */\n  get transient(): boolean {\n    return (\n      this.code === \"network\" ||\n      this.code === \"internal_error\" ||\n      this.code === \"unavailable\" ||\n      (this.code === \"storage\" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429))\n    );\n  }\n}\n\nexport const isContentKitError = (e: unknown): e is ContentKitError => e instanceof ContentKitError;\n\n/** Anything a call can throw, as a ContentKitError (network when it is not one). */\nexport function toContentKitError(e: unknown): ContentKitError {\n  if (e instanceof ContentKitError) return e;\n  return new ContentKitError(\"network\", e instanceof Error ? e.message : String(e), { cause: e });\n}\n\nexport function aborted(signal?: AbortSignal): ContentKitError {\n  return new ContentKitError(\"aborted\", \"request canceled\", { cause: signal?.reason });\n}\n\nexport function throwIfAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw aborted(signal);\n}\n\nconst byStatus: Record<number, ContentKitErrorCode> = {\n  401: \"unauthorized\",\n  403: \"forbidden\",\n  404: \"not_found\",\n  409: \"conflict\",\n  410: \"gone\",\n  413: \"too_large\",\n  415: \"type_not_allowed\",\n  429: \"rate_limited\",\n  501: \"not_configured\",\n  503: \"unavailable\",\n};\n\nconst known = new Set<string>(ERROR_CODES);\n\n/** Reads a response that is not 2xx. */\nexport async function readContentKitError(res: Response): Promise<ContentKitError> {\n  let body: Partial<ErrorReply> = {};\n  try {\n    body = (await res.json()) as Partial<ErrorReply>;\n  } catch {\n    // not JSON (a proxy error page)\n  }\n  const header = Number(res.headers.get(\"Retry-After\"));\n  const retryAfter = body.retry_after ?? (Number.isFinite(header) && header > 0 ? header : undefined);\n  const code = body.code && known.has(body.code) ? (body.code as ContentKitErrorCode) : (byStatus[res.status] ?? (res.status >= 500 ? \"internal_error\" : \"invalid_request\"));\n  return new ContentKitError(code, body.error ?? `HTTP ${res.status}`, {\n    status: res.status,\n    retryAfter,\n    blobs: body.blobs,\n    details: body.details,\n    ban: body.ban,\n    action: body.action,\n  });\n}\n\n/** An upload's recorded processing failure: its typed refusal, else a processing fault. */\nexport function failureError(f: Failure): ContentKitError {\n  const code = f.code && known.has(f.code) ? (f.code as ContentKitErrorCode) : \"internal_error\";\n  return new ContentKitError(code, f.message, { details: f.details });\n}\n"],"mappings":";;AASA,IAAa,IAAqB;CAAC;CAAW;CAAW;CAAW;CAAmB;CAAU;AAAgB,GAKpG,IAA8C,CAAC,GAAI,OAAO,KAAK,CAAsB,GAAmB,GAAG,CAAkB,GAW7H,IAAb,cAAqC,MAAM;CAW9B;CAVX,OAAyB;CAEzB;CACA;CACA;CACA;CACA;CACA;CAEA,YACE,GACA,GACA,IAA4B,CAAC,GAC7B;EAOA,AANA,MAAM,GAAS,EAAK,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,EAAK,MAAM,CAAC,GAJlE,KAAA,OAAA,GAKT,KAAK,SAAS,EAAK,UAAU,GAC7B,KAAK,aAAa,EAAK,YACvB,KAAK,UAAU,EAAK,SACpB,KAAK,QAAQ,EAAK,OAClB,KAAK,MAAM,EAAK,KAChB,KAAK,SAAS,EAAK;CACrB;CAMA,IAAI,UAAmB;EACrB,OAAQ,KAAK,UAAU,OAAO,KAAK,SAAS,OAAO,KAAK,SAAS,aAAc,KAAK,KAAK,WAAW,QAAQ,KAAK,KAAK,SAAS;CACjI;CAGA,IAAI,UAAmB;EACrB,OAAO,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvD;CAGA,IAAI,YAAqB;EACvB,OAAO,KAAK,SAAS;CACvB;CAGA,IAAI,cAAuB;EACzB,OAAO,KAAK,WAAW,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvE;CAGA,IAAI,YAAqB;EACvB,OACE,KAAK,SAAS,aACd,KAAK,SAAS,oBACd,KAAK,SAAS,iBACb,KAAK,SAAS,cAAc,KAAK,UAAU,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW;CAErH;AACF,GAEa,KAAqB,MAAqC,aAAa;AAGpF,SAAgB,EAAkB,GAA6B;CAE7D,OADI,aAAa,IAAwB,IAClC,IAAI,EAAgB,WAAW,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;AAChG;AAEA,SAAgB,EAAQ,GAAuC;CAC7D,OAAO,IAAI,EAAgB,WAAW,oBAAoB,EAAE,OAAO,GAAQ,OAAO,CAAC;AACrF;AAEA,SAAgB,EAAe,GAA4B;CACzD,IAAI,GAAQ,SAAS,MAAM,EAAQ,CAAM;AAC3C;AAEA,IAAM,IAAgD;CACpD,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP,GAEM,IAAQ,IAAI,IAAY,CAAW;AAGzC,eAAsB,EAAoB,GAAyC;CACjF,IAAI,IAA4B,CAAC;CACjC,IAAI;EACF,IAAQ,MAAM,EAAI,KAAK;CACzB,QAAQ,CAER;CACA,IAAM,IAAS,OAAO,EAAI,QAAQ,IAAI,aAAa,CAAC,GAC9C,IAAa,EAAK,gBAAgB,OAAO,SAAS,CAAM,KAAK,IAAS,IAAI,IAAS,KAAA;CAEzF,OAAO,IAAI,EADE,EAAK,QAAQ,EAAM,IAAI,EAAK,IAAI,IAAK,EAAK,OAAgC,EAAS,EAAI,YAAY,EAAI,UAAU,MAAM,mBAAmB,oBACtH,EAAK,SAAS,QAAQ,EAAI,UAAU;EACnE,QAAQ,EAAI;EACZ;EACA,OAAO,EAAK;EACZ,SAAS,EAAK;EACd,KAAK,EAAK;EACV,QAAQ,EAAK;CACf,CAAC;AACH;AAGA,SAAgB,EAAa,GAA6B;CAExD,OAAO,IAAI,EADE,EAAE,QAAQ,EAAM,IAAI,EAAE,IAAI,IAAK,EAAE,OAA+B,kBAC5C,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;AACpE"}

package/dist/client/gallery.d.ts

@@ -0,0 +1,43 @@
+import { FileInfo, ReadResult } from './generated/wire.js';
+export type GalleryView = "carousel" | "grid";
+export interface GalleryMediaItem {
+    kind: "image" | "video" | "audio";
+    key: string;
+    /** An image; a ladder's widest video track (its size and duration) or its audio file. */
+    file: FileInfo;
+    /** A video or audio ladder's HLS folder from the read's `hls`, e.g. "hls/". */
+    dir?: string;
+    /** Width / height from the read API; a default when unknown. */
+    aspect: number;
+}
+/** What a viewer without access is missing; `backdrop` is the public preview drawn behind it. */
+export interface GalleryLockedItem {
+    kind: "locked";
+    key: string;
+    count: number;
+    videos: number;
+    backdrop?: string;
+    aspect: number;
+}
+export type GalleryItem = GalleryMediaItem | GalleryLockedItem;
+export declare const isVideoType: (type?: string) => boolean;
+export declare const isAudioType: (type?: string) => boolean;
+export declare const isImageType: (type?: string) => boolean;
+/** The stage aspect of an audio slide. */
+export declare const AUDIO_ASPECT = 3;
+/** Subtitle files are a video's text tracks, not gallery items. */
+export declare const isSubtitleType: (type?: string) => boolean;
+/**
+ * The read result as gallery items in manifest order. With access: each
+ * image, each playable HLS ladder (a folder in `hls`: a video, or an
+ * audio-only one) and each other audio file. Without: the item's public
+ * previews (the read's `previews`), then one locked item for the rest; an
+ * item's private files are all or nothing, so locked files never carry URLs.
+ * Other files (plain videos, subtitles, zips) are not items; scope the read
+ * with a prefix to choose.
+ */
+export declare function galleryItems(read: ReadResult | null | undefined): GalleryItem[];
+/** The carousel stage's width / height: the current item's native aspect. */
+export declare function stageAspect(items: readonly GalleryItem[], index?: number): number;
+/** "0:42", "12:05", "1:02:09". */
+export declare function formatDuration(seconds: number): string;

package/dist/client/gallery.js

@@ -0,0 +1,86 @@
+//#region src/client/gallery.ts
+var e = (e) => !!e?.startsWith("video/"), t = (e) => !!e?.startsWith("audio/"), n = (e) => !!e?.startsWith("image/"), r = (e) => [
+	"text/vtt",
+	"application/x-subrip",
+	"text/x-ssa",
+	"text/x-ass"
+].includes(e ?? "");
+function i(e, t) {
+	return e?.w && e.h ? e.w / e.h : t;
+}
+var a = (e) => e.slice(0, e.lastIndexOf("/") + 1);
+function o(r) {
+	if (!r) return [];
+	let o = r.access === "full", s = r.hls ?? [], c = (e) => s.find((t) => e.path.startsWith(t)), l = (e) => a(e.path) || e.path, u = r.files.filter((n) => n.locked && (e(n.type) || t(n.type))), d = new Set(u.map(l)), f = r.files.filter((e) => e.locked && n(e.type) && !d.has(a(e.path))), p = new Set(u.filter((t) => e(t.type)).map(l)).size, m = o ? [] : r.previews ?? [], h = Math.max(f.length - m.length, 0) + d.size, g = m.map((e, t) => ({
+		kind: "image",
+		key: `preview/${t + 1}`,
+		file: {
+			path: `preview/${t + 1}`,
+			type: "image/webp",
+			url: e
+		},
+		aspect: 1
+	})), _ = /* @__PURE__ */ new Set();
+	for (let a of r.files) {
+		if (a.locked) continue;
+		let o = c(a);
+		if (o) {
+			if (_.has(o)) continue;
+			_.add(o);
+			let n = r.files.filter((e) => e.path.startsWith(o)), a = n.filter((t) => e(t.type)).reduce((e, t) => (t.w ?? 0) > (e?.w ?? -1) ? t : e, void 0);
+			if (a) {
+				let e = a.dur ?? n.find((e) => e.dur)?.dur;
+				g.push({
+					kind: "video",
+					key: o,
+					dir: o,
+					file: {
+						...a,
+						dur: e
+					},
+					aspect: i(a, 16 / 9)
+				});
+			} else {
+				let e = n.find((e) => e.path.endsWith(".m4a")) ?? n.find((e) => t(e.type));
+				e && g.push({
+					kind: "audio",
+					key: o,
+					dir: o,
+					file: e,
+					aspect: 3
+				});
+			}
+			continue;
+		}
+		n(a.type) ? g.push({
+			kind: "image",
+			key: a.path,
+			file: a,
+			aspect: i(a, 1)
+		}) : t(a.type) && g.push({
+			kind: "audio",
+			key: a.path,
+			file: a,
+			aspect: 3
+		});
+	}
+	return h > 0 && g.push({
+		kind: "locked",
+		key: "locked",
+		count: h,
+		videos: p,
+		backdrop: m.at(-1),
+		aspect: 1
+	}), g;
+}
+function s(e, t = 0) {
+	return e[t]?.aspect ?? 1;
+}
+function c(e) {
+	let t = Math.max(0, Math.round(e)), n = Math.floor(t / 3600), r = Math.floor(t % 3600 / 60), i = String(t % 60).padStart(2, "0");
+	return n ? `${n}:${String(r).padStart(2, "0")}:${i}` : `${r}:${i}`;
+}
+//#endregion
+export { c as formatDuration, o as galleryItems, t as isAudioType, n as isImageType, r as isSubtitleType, e as isVideoType, s as stageAspect };
+
+//# sourceMappingURL=gallery.js.map

package/dist/client/gallery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.js","names":[],"sources":["../../src/client/gallery.ts"],"sourcesContent":["import type { FileInfo, ReadResult } from \"./generated/wire.js\";\n\nexport type GalleryView = \"carousel\" | \"grid\";\n\nexport interface GalleryMediaItem {\n  kind: \"image\" | \"video\" | \"audio\";\n  key: string;\n  /** An image; a ladder's widest video track (its size and duration) or its audio file. */\n  file: FileInfo;\n  /** A video or audio ladder's HLS folder from the read's `hls`, e.g. \"hls/\". */\n  dir?: string;\n  /** Width / height from the read API; a default when unknown. */\n  aspect: number;\n}\n\n/** What a viewer without access is missing; `backdrop` is the public preview drawn behind it. */\nexport interface GalleryLockedItem {\n  kind: \"locked\";\n  key: string;\n  count: number;\n  videos: number;\n  backdrop?: string;\n  aspect: number;\n}\n\nexport type GalleryItem = GalleryMediaItem | GalleryLockedItem;\n\nexport const isVideoType = (type?: string) => !!type?.startsWith(\"video/\");\nexport const isAudioType = (type?: string) => !!type?.startsWith(\"audio/\");\nexport const isImageType = (type?: string) => !!type?.startsWith(\"image/\");\n\n/** The stage aspect of an audio slide. */\nexport const AUDIO_ASPECT = 3;\n\n/** Subtitle files are a video's text tracks, not gallery items. */\nexport const isSubtitleType = (type?: string) =>\n  [\"text/vtt\", \"application/x-subrip\", \"text/x-ssa\", \"text/x-ass\"].includes(type ?? \"\");\n\nfunction aspectOf(f: FileInfo | undefined, fallback: number) {\n  return f?.w && f.h ? f.w / f.h : fallback;\n}\n\nconst parent = (path: string) => path.slice(0, path.lastIndexOf(\"/\") + 1);\n\n/**\n * The read result as gallery items in manifest order. With access: each\n * image, each playable HLS ladder (a folder in `hls`: a video, or an\n * audio-only one) and each other audio file. Without: the item's public\n * previews (the read's `previews`), then one locked item for the rest; an\n * item's private files are all or nothing, so locked files never carry URLs.\n * Other files (plain videos, subtitles, zips) are not items; scope the read\n * with a prefix to choose.\n */\nexport function galleryItems(read: ReadResult | null | undefined): GalleryItem[] {\n  if (!read) return [];\n  const full = read.access === \"full\";\n  const dirs = read.hls ?? [];\n  const dirOf = (f: FileInfo) => dirs.find((d) => f.path.startsWith(d));\n  // A locked ladder lists its tracks (and sprite): count each folder once.\n  const unit = (f: FileInfo) => parent(f.path) || f.path;\n  const lockedMedia = read.files.filter((f) => f.locked && (isVideoType(f.type) || isAudioType(f.type)));\n  const units = new Set(lockedMedia.map(unit));\n  const lockedImages = read.files.filter((f) => f.locked && isImageType(f.type) && !units.has(parent(f.path)));\n  const lockedVideos = new Set(lockedMedia.filter((f) => isVideoType(f.type)).map(unit)).size;\n  const previews = full ? [] : (read.previews ?? []);\n  // Each preview shows one of the locked images.\n  const lockedCount = Math.max(lockedImages.length - previews.length, 0) + units.size;\n  const items: GalleryItem[] = previews.map((url, i) => ({ kind: \"image\", key: `preview/${i + 1}`, file: { path: `preview/${i + 1}`, type: \"image/webp\", url }, aspect: 1 }));\n  const seen = new Set<string>();\n  for (const f of read.files) {\n    if (f.locked) continue;\n    const dir = dirOf(f);\n    if (dir) {\n      if (seen.has(dir)) continue;\n      seen.add(dir);\n      const files = read.files.filter((x) => x.path.startsWith(dir));\n      const video = files.filter((x) => isVideoType(x.type)).reduce<FileInfo | undefined>((a, x) => ((x.w ?? 0) > (a?.w ?? -1) ? x : a), undefined);\n      if (video) {\n        const dur = video.dur ?? files.find((x) => x.dur)?.dur;\n        items.push({ kind: \"video\", key: dir, dir, file: { ...video, dur }, aspect: aspectOf(video, 16 / 9) });\n      } else {\n        const audio = files.find((x) => x.path.endsWith(\".m4a\")) ?? files.find((x) => isAudioType(x.type));\n        if (audio) items.push({ kind: \"audio\", key: dir, dir, file: audio, aspect: AUDIO_ASPECT });\n      }\n      continue;\n    }\n    if (isImageType(f.type)) items.push({ kind: \"image\", key: f.path, file: f, aspect: aspectOf(f, 1) });\n    else if (isAudioType(f.type)) items.push({ kind: \"audio\", key: f.path, file: f, aspect: AUDIO_ASPECT });\n  }\n  if (lockedCount > 0)\n    items.push({ kind: \"locked\", key: \"locked\", count: lockedCount, videos: lockedVideos, backdrop: previews.at(-1), aspect: 1 });\n  return items;\n}\n\n/** The carousel stage's width / height: the current item's native aspect. */\nexport function stageAspect(items: readonly GalleryItem[], index = 0): number {\n  return items[index]?.aspect ?? 1;\n}\n\n/** \"0:42\", \"12:05\", \"1:02:09\". */\nexport function formatDuration(seconds: number): string {\n  const s = Math.max(0, Math.round(seconds));\n  const h = Math.floor(s / 3600);\n  const m = Math.floor((s % 3600) / 60);\n  const ss = String(s % 60).padStart(2, \"0\");\n  return h ? `${h}:${String(m).padStart(2, \"0\")}:${ss}` : `${m}:${ss}`;\n}\n"],"mappings":"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"}

package/dist/client/generated/error-codes.d.ts

@@ -0,0 +1,5 @@
+export type ErrorCode = "animation_not_allowed" | "animation_too_long" | "animation_unsupported" | "checksum_mismatch" | "comment_banned" | "comment_too_long" | "conflict" | "forbidden" | "gone" | "image_too_large" | "image_too_small" | "image_unreadable" | "incomplete" | "internal_error" | "invalid_request" | "moderation_rejected" | "not_configured" | "not_found" | "not_uploaded" | "quota_exceeded" | "rate_limited" | "tenant_mismatch" | "too_large" | "too_many_files" | "type_not_allowed" | "unauthorized" | "unavailable" | "video_aspect_unsupported" | "video_over_budget" | "video_too_large" | "video_too_long";
+export declare const CONTENTKIT_ERROR_CODES: Readonly<Record<ErrorCode, {
+    status: number;
+    meaning: string;
+}>>;

package/dist/client/generated/error-codes.js

@@ -0,0 +1,131 @@
+//#region src/client/generated/error-codes.ts
+var e = {
+	animation_not_allowed: {
+		status: 422,
+		meaning: "An animated image where the upload path refuses animation."
+	},
+	animation_too_long: {
+		status: 422,
+		meaning: "The animation has more frames or seconds than the processor allows."
+	},
+	animation_unsupported: {
+		status: 415,
+		meaning: "An AVIF or HEIF image sequence, which is decoded as one frame."
+	},
+	checksum_mismatch: {
+		status: 422,
+		meaning: "The stored bytes differ from the declared SHA-256."
+	},
+	comment_banned: {
+		status: 403,
+		meaning: "The actor is banned from commenting on this target; `ban` says the scope, the reason and when it ends."
+	},
+	comment_too_long: {
+		status: 422,
+		meaning: "The comment is longer than the site allows; `details.max` is the limit in characters."
+	},
+	conflict: {
+		status: 409,
+		meaning: "A concurrent change, a path or slug already taken, or an operation id already used for another commit."
+	},
+	forbidden: {
+		status: 403,
+		meaning: "The actor may not do this."
+	},
+	gone: {
+		status: 410,
+		meaning: "The content was removed."
+	},
+	image_too_large: {
+		status: 413,
+		meaning: "The image has more pixels or frames than the processor decodes."
+	},
+	image_too_small: {
+		status: 422,
+		meaning: "The edited image is narrower than its public preset's minimum width."
+	},
+	image_unreadable: {
+		status: 422,
+		meaning: "The file is not a decodable image of its declared type."
+	},
+	incomplete: {
+		status: 409,
+		meaning: "A multipart upload is missing parts."
+	},
+	internal_error: {
+		status: 500,
+		meaning: "A server fault; the cause is in the server log."
+	},
+	invalid_request: {
+		status: 400,
+		meaning: "The request is malformed: its body, a query parameter or a path value."
+	},
+	moderation_rejected: {
+		status: 422,
+		meaning: "The moderator refused the text; `error` says why."
+	},
+	not_configured: {
+		status: 501,
+		meaning: "The capability needs a port the host did not configure; retrying does not help."
+	},
+	not_found: {
+		status: 404,
+		meaning: "Nothing by that name, or nothing the actor may see."
+	},
+	not_uploaded: {
+		status: 409,
+		meaning: "A commit names an upload that has not landed; `blobs` lists the ones to upload again."
+	},
+	quota_exceeded: {
+		status: 413,
+		meaning: "The uploader's storage quota is used up."
+	},
+	rate_limited: {
+		status: 429,
+		meaning: "Too many requests; retry after `retry_after` seconds (also the Retry-After header)."
+	},
+	tenant_mismatch: {
+		status: 500,
+		meaning: "A host port answered with another tenant's data: a configuration fault."
+	},
+	too_large: {
+		status: 413,
+		meaning: "The file is larger than its upload path allows; `details` has `size` and `max_bytes`."
+	},
+	too_many_files: {
+		status: 409,
+		meaning: "The commit would put more files in an upload path, or the item, than allowed; `details.max` is the limit."
+	},
+	type_not_allowed: {
+		status: 415,
+		meaning: "The file type is not allowed in the upload path; `details.allowed` lists the types."
+	},
+	unauthorized: {
+		status: 401,
+		meaning: "The route needs a signed-in actor."
+	},
+	unavailable: {
+		status: 503,
+		meaning: "Media storage cannot be reached, or a commit's recovery is pending; retry."
+	},
+	video_aspect_unsupported: {
+		status: 422,
+		meaning: "The video's display aspect is outside what its upload path accepts; `details` has `min_aspect` and `max_aspect` (width/height)."
+	},
+	video_over_budget: {
+		status: 422,
+		meaning: "The planned encode costs more than its upload path allows, or the source averages under a frame a second."
+	},
+	video_too_large: {
+		status: 422,
+		meaning: "The video's frames are larger than its upload path allows."
+	},
+	video_too_long: {
+		status: 422,
+		meaning: "The video or audio runs longer than its upload path allows."
+	}
+};
+//#endregion
+export { e as CONTENTKIT_ERROR_CODES };
+
+//# sourceMappingURL=error-codes.js.map

package/dist/client/generated/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","names":[],"sources":["../../../src/client/generated/error-codes.ts"],"sourcesContent":["// Generated by `go generate ./internal/contract` from ContentKit's error-code registry. Do not edit.\n\nexport type ErrorCode =\n  | \"animation_not_allowed\"\n  | \"animation_too_long\"\n  | \"animation_unsupported\"\n  | \"checksum_mismatch\"\n  | \"comment_banned\"\n  | \"comment_too_long\"\n  | \"conflict\"\n  | \"forbidden\"\n  | \"gone\"\n  | \"image_too_large\"\n  | \"image_too_small\"\n  | \"image_unreadable\"\n  | \"incomplete\"\n  | \"internal_error\"\n  | \"invalid_request\"\n  | \"moderation_rejected\"\n  | \"not_configured\"\n  | \"not_found\"\n  | \"not_uploaded\"\n  | \"quota_exceeded\"\n  | \"rate_limited\"\n  | \"tenant_mismatch\"\n  | \"too_large\"\n  | \"too_many_files\"\n  | \"type_not_allowed\"\n  | \"unauthorized\"\n  | \"unavailable\"\n  | \"video_aspect_unsupported\"\n  | \"video_over_budget\"\n  | \"video_too_large\"\n  | \"video_too_long\"\n;\n\n// Each code's HTTP status and meaning. A message on the wire is for people;\n// classify by code.\nexport const CONTENTKIT_ERROR_CODES: Readonly<Record<ErrorCode, { status: number; meaning: string }>> = {\n  animation_not_allowed: { status: 422, meaning: \"An animated image where the upload path refuses animation.\" },\n  animation_too_long: { status: 422, meaning: \"The animation has more frames or seconds than the processor allows.\" },\n  animation_unsupported: { status: 415, meaning: \"An AVIF or HEIF image sequence, which is decoded as one frame.\" },\n  checksum_mismatch: { status: 422, meaning: \"The stored bytes differ from the declared SHA-256.\" },\n  comment_banned: { status: 403, meaning: \"The actor is banned from commenting on this target; `ban` says the scope, the reason and when it ends.\" },\n  comment_too_long: { status: 422, meaning: \"The comment is longer than the site allows; `details.max` is the limit in characters.\" },\n  conflict: { status: 409, meaning: \"A concurrent change, a path or slug already taken, or an operation id already used for another commit.\" },\n  forbidden: { status: 403, meaning: \"The actor may not do this.\" },\n  gone: { status: 410, meaning: \"The content was removed.\" },\n  image_too_large: { status: 413, meaning: \"The image has more pixels or frames than the processor decodes.\" },\n  image_too_small: { status: 422, meaning: \"The edited image is narrower than its public preset's minimum width.\" },\n  image_unreadable: { status: 422, meaning: \"The file is not a decodable image of its declared type.\" },\n  incomplete: { status: 409, meaning: \"A multipart upload is missing parts.\" },\n  internal_error: { status: 500, meaning: \"A server fault; the cause is in the server log.\" },\n  invalid_request: { status: 400, meaning: \"The request is malformed: its body, a query parameter or a path value.\" },\n  moderation_rejected: { status: 422, meaning: \"The moderator refused the text; `error` says why.\" },\n  not_configured: { status: 501, meaning: \"The capability needs a port the host did not configure; retrying does not help.\" },\n  not_found: { status: 404, meaning: \"Nothing by that name, or nothing the actor may see.\" },\n  not_uploaded: { status: 409, meaning: \"A commit names an upload that has not landed; `blobs` lists the ones to upload again.\" },\n  quota_exceeded: { status: 413, meaning: \"The uploader's storage quota is used up.\" },\n  rate_limited: { status: 429, meaning: \"Too many requests; retry after `retry_after` seconds (also the Retry-After header).\" },\n  tenant_mismatch: { status: 500, meaning: \"A host port answered with another tenant's data: a configuration fault.\" },\n  too_large: { status: 413, meaning: \"The file is larger than its upload path allows; `details` has `size` and `max_bytes`.\" },\n  too_many_files: { status: 409, meaning: \"The commit would put more files in an upload path, or the item, than allowed; `details.max` is the limit.\" },\n  type_not_allowed: { status: 415, meaning: \"The file type is not allowed in the upload path; `details.allowed` lists the types.\" },\n  unauthorized: { status: 401, meaning: \"The route needs a signed-in actor.\" },\n  unavailable: { status: 503, meaning: \"Media storage cannot be reached, or a commit's recovery is pending; retry.\" },\n  video_aspect_unsupported: { status: 422, meaning: \"The video's display aspect is outside what its upload path accepts; `details` has `min_aspect` and `max_aspect` (width/height).\" },\n  video_over_budget: { status: 422, meaning: \"The planned encode costs more than its upload path allows, or the source averages under a frame a second.\" },\n  video_too_large: { status: 422, meaning: \"The video's frames are larger than its upload path allows.\" },\n  video_too_long: { status: 422, meaning: \"The video or audio runs longer than its upload path allows.\" },\n};\n"],"mappings":";AAsCA,IAAa,IAA2F;CACtG,uBAAuB;EAAE,QAAQ;EAAK,SAAS;CAA6D;CAC5G,oBAAoB;EAAE,QAAQ;EAAK,SAAS;CAAsE;CAClH,uBAAuB;EAAE,QAAQ;EAAK,SAAS;CAAiE;CAChH,mBAAmB;EAAE,QAAQ;EAAK,SAAS;CAAqD;CAChG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAyG;CACjJ,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAClI,UAAU;EAAE,QAAQ;EAAK,SAAS;CAAyG;CAC3I,WAAW;EAAE,QAAQ;EAAK,SAAS;CAA6B;CAChE,MAAM;EAAE,QAAQ;EAAK,SAAS;CAA2B;CACzD,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAkE;CAC3G,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAuE;CAChH,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAA0D;CACpG,YAAY;EAAE,QAAQ;EAAK,SAAS;CAAuC;CAC3E,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAkD;CAC1F,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAyE;CAClH,qBAAqB;EAAE,QAAQ;EAAK,SAAS;CAAoD;CACjG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAkF;CAC1H,WAAW;EAAE,QAAQ;EAAK,SAAS;CAAsD;CACzF,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAC9H,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA2C;CACnF,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAsF;CAC5H,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA0E;CACnH,WAAW;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAC3H,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA4G;CACpJ,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAsF;CAChI,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAqC;CAC3E,aAAa;EAAE,QAAQ;EAAK,SAAS;CAA6E;CAClH,0BAA0B;EAAE,QAAQ;EAAK,SAAS;CAAkI;CACpL,mBAAmB;EAAE,QAAQ;EAAK,SAAS;CAA4G;CACvJ,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA6D;CACtG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA8D;AACxG"}