nuxt-cornerstone 1.0.0

package/dist/runtime/i18n/index.js

@@ -0,0 +1,145 @@
+import { ref } from "vue";
+import { BUILTIN_MESSAGES } from "./messages.js";
+export { BUILTIN_MESSAGES, en, fa } from "./messages.js";
+export const DEFAULT_LOCALE = "en";
+const RTL_LANGUAGES = /* @__PURE__ */ new Set([
+  "ar",
+  "ckb",
+  "dv",
+  "fa",
+  "he",
+  "ku",
+  "ps",
+  "sd",
+  "syr",
+  "ug",
+  "ur",
+  "yi"
+]);
+const hot = import.meta.hot;
+const state = hot ? hot.data.cornerstoneI18n ??= {} : {};
+state.locale ??= ref(DEFAULT_LOCALE);
+state.fallbackLocale ??= DEFAULT_LOCALE;
+state.enabled ??= true;
+state.numberingSystem ??= "auto";
+state.catalogs ??= cloneCatalogs(BUILTIN_MESSAGES);
+state.translator ??= null;
+function cloneCatalogs(source) {
+  const out = {};
+  for (const [locale, catalog] of Object.entries(source)) out[locale] = { ...catalog };
+  return out;
+}
+export function configureI18n(options) {
+  if (options === false) {
+    state.enabled = false;
+    state.locale.value = DEFAULT_LOCALE;
+    return;
+  }
+  if (!options) return;
+  state.enabled = true;
+  if (options.messages) {
+    for (const [locale, catalog] of Object.entries(options.messages)) {
+      if (!catalog) continue;
+      state.catalogs[locale] = { ...state.catalogs[locale], ...catalog };
+    }
+  }
+  if (options.fallbackLocale) state.fallbackLocale = options.fallbackLocale;
+  if (options.numberingSystem) state.numberingSystem = options.numberingSystem;
+  if (options.locale) state.locale.value = options.locale;
+}
+export function getCornerstoneLocale() {
+  return state.locale.value;
+}
+export function setCornerstoneLocale(locale) {
+  if (!state.enabled) return;
+  state.locale.value = locale;
+}
+export function getCornerstoneLocales() {
+  return Object.keys(state.catalogs);
+}
+export function hasCornerstoneCatalog(locale) {
+  const catalogs = state.catalogs;
+  return locale in catalogs || locale.split(/[-_]/)[0] in catalogs;
+}
+export function setCornerstoneTranslator(translator) {
+  state.translator = translator;
+}
+export function addCornerstoneMessages(locale, catalog) {
+  state.catalogs[locale] = { ...state.catalogs[locale], ...catalog };
+}
+export function isRtlLocale(locale = getCornerstoneLocale()) {
+  return RTL_LANGUAGES.has(locale.toLowerCase().split(/[-_]/)[0]);
+}
+export function dirForLocale(locale = getCornerstoneLocale()) {
+  return isRtlLocale(locale) ? "rtl" : "ltr";
+}
+export function t(key, params) {
+  const locale = getCornerstoneLocale();
+  const supplied = state.translator?.(key, params, locale);
+  if (typeof supplied === "string") return supplied;
+  const value = lookup(key, locale) ?? lookup(key, state.fallbackLocale) ?? lookup(key, DEFAULT_LOCALE);
+  if (value === void 0) return key;
+  return interpolate(selectPlural(value, params, locale), params, locale);
+}
+function lookup(key, locale) {
+  const catalogs = state.catalogs;
+  const language = locale.split(/[-_]/)[0];
+  return catalogs[locale]?.[key] ?? catalogs[language]?.[key];
+}
+function selectPlural(value, params, locale) {
+  if (typeof value === "string") return value;
+  const count = params?.count;
+  const category = typeof count === "number" ? pluralRules(locale).select(count) : "other";
+  return value[category] ?? value.other ?? value.one ?? "";
+}
+function interpolate(template, params, locale) {
+  if (!params) return template;
+  return template.replace(/\{(\w+)\}/g, (match, name) => {
+    const value = params[name];
+    if (value === void 0) return match;
+    return typeof value === "number" ? formatNumber(value, void 0, locale) : value;
+  });
+}
+export function n(value, options) {
+  return formatNumber(value, options, getCornerstoneLocale());
+}
+function formatNumber(value, options, locale) {
+  return numberFormat(locale, options).format(value);
+}
+const BYTE_UNITS = ["B", "KB", "MB", "GB", "TB"];
+export function formatBytes(bytes) {
+  let value = bytes;
+  let unit = 0;
+  while (value >= 1024 && unit < BYTE_UNITS.length - 1) {
+    value /= 1024;
+    unit++;
+  }
+  return t("bytes.value", {
+    value: n(value, { maximumFractionDigits: value < 10 && unit > 0 ? 1 : 0 }),
+    unit: t(`bytes.unit.${BYTE_UNITS[unit]}`)
+  });
+}
+const numberFormats = /* @__PURE__ */ new Map();
+const pluralRulesCache = /* @__PURE__ */ new Map();
+function numberFormat(locale, options) {
+  const resolved = withNumberingSystem(locale);
+  const key = `${resolved}|${options ? JSON.stringify(options) : ""}`;
+  let format = numberFormats.get(key);
+  if (!format) {
+    format = new Intl.NumberFormat(resolved, options);
+    numberFormats.set(key, format);
+  }
+  return format;
+}
+function pluralRules(locale) {
+  let rules = pluralRulesCache.get(locale);
+  if (!rules) {
+    rules = new Intl.PluralRules(locale);
+    pluralRulesCache.set(locale, rules);
+  }
+  return rules;
+}
+function withNumberingSystem(locale) {
+  if (state.numberingSystem !== "latn") return locale;
+  return locale.includes("-u-") ? `${locale}-nu-latn` : `${locale}-u-nu-latn`;
+}

package/dist/runtime/i18n/messages.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Message catalogues for the strings this module produces itself.
+ *
+ * Both locales are bundled statically rather than imported on demand. They are
+ * a few hundred bytes each, and `t()` is called from error paths that are
+ * synchronous by nature — `asZipError()` has to return an `Error`, not a
+ * promise of one.
+ *
+ * Keys are flat and dotted. Anything in `{braces}` is interpolated; a numeric
+ * parameter is run through the locale's number formatter on the way in, which
+ * is what puts Persian-Indic digits into Farsi messages.
+ */
+/** CLDR plural categories, as `Intl.PluralRules` selects them. */
+export type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+/**
+ * A message is either a plain string, or a set of plural forms chosen by the
+ * `count` parameter. Missing categories fall back to `other`, so Farsi — where
+ * a counted noun does not inflect — only needs to supply `other`.
+ */
+export type MessageValue = string | Partial<Record<PluralCategory, string>>;
+export type MessageCatalog = Record<string, MessageValue>;
+export type MessageParams = Record<string, string | number>;
+/**
+ * Identifiers stay in English inside every translation: `cornerstone.autoInit`,
+ * `ensureCornerstone()` and `@cornerstonejs/tools` are things the reader has to
+ * type or search for, not prose.
+ */
+export declare const en: {
+    'error.ssr': string;
+    'error.optionsLocked': string;
+    'error.initFailed': string;
+    'error.toolGroupCreate': string;
+    'error.toolNotInGroup': string;
+    'warn.unknownTool': string;
+    'error.annotationViewport': string;
+    'error.annotationToolGroup': string;
+    'error.annotationTool': string;
+    'annotationJson.notJson': string;
+    'annotationJson.unknownShape': string;
+    'annotationJson.finding': string;
+    'annotationJson.class': string;
+    'annotationJson.labelled': string;
+    'zip.tooLarge': string;
+    'zip.notReadable': string;
+    'zip.readFailed': string;
+    'series.numbered': string;
+    'series.unnamed': string;
+    'series.images': {
+        one: string;
+        other: string;
+    };
+    'series.label': string;
+    'list.separator': string;
+    'bytes.value': string;
+    'bytes.unit.B': string;
+    'bytes.unit.KB': string;
+    'bytes.unit.MB': string;
+    'bytes.unit.GB': string;
+    'bytes.unit.TB': string;
+    'study.progress.reading': string;
+    'study.progress.extracting': string;
+    'study.progress.indexing': string;
+    'study.error.noDicomInZip': string;
+    'study.error.noDicomFiles': {
+        one: string;
+        other: string;
+    };
+    'study.error.noUrls': string;
+    'study.skipped.summary': string;
+    'study.skipped.more': string;
+    'study.skipped.entry': string;
+    'study.skip.metadata': string;
+    'study.skip.notDicomExtension': string;
+    'study.skip.notDicom': string;
+    'study.skip.empty': string;
+    'study.source.files': {
+        one: string;
+        other: string;
+    };
+    'study.source.urls': {
+        one: string;
+        other: string;
+    };
+    'study.source.zip': string;
+    'study.count.series': {
+        one: string;
+        other: string;
+    };
+    'study.count.skipped': {
+        one: string;
+        other: string;
+    };
+    'cine.preparing': string;
+    'cine.prepared': {
+        one: string;
+        other: string;
+    };
+    'cine.preparedWithFailures': {
+        one: string;
+        other: string;
+    };
+    'cine.cacheFull': string;
+    'report.summary': string;
+    'report.waiting': {
+        one: string;
+        other: string;
+    };
+    'report.dropped': {
+        one: string;
+        other: string;
+    };
+    'report.empty': string;
+    'report.unmatched': string;
+    'report.unmatchedNoSeries': string;
+    'report.failed': string;
+};
+export declare const fa: Record<CornerstoneMessageKey, MessageValue>;
+export declare const BUILTIN_MESSAGES: Record<string, MessageCatalog>;
+/** Keys the module itself emits. Extra keys may be added through options. */
+export type CornerstoneMessageKey = keyof typeof en;
+/** A built-in key, or any key an app has registered of its own. */
+export type MessageKey = CornerstoneMessageKey | (string & {});

package/dist/runtime/i18n/messages.js

@@ -0,0 +1,147 @@
+export const en = {
+  "error.ssr": "Cornerstone3D is browser-only (WebGL, web workers, WASM) and cannot run during SSR. Call ensureCornerstone() from onMounted, or wrap the caller in <ClientOnly>.",
+  "error.optionsLocked": "Cornerstone3D is already initialising; options can no longer be changed. Set `cornerstone.autoInit: false` in nuxt.config and call `ensureCornerstone(options)` from your own plugin.",
+  "error.initFailed": "initialisation failed",
+  "error.toolGroupCreate": 'could not create tool group "{groupId}".',
+  "error.toolNotInGroup": 'tool "{tool}" is not in tool group "{groupId}". Add its class name to `cornerstone.tools.register` in nuxt.config.',
+  "warn.unknownTool": '"{tool}" is not an exported tool class of @cornerstonejs/tools; skipping.',
+  "error.annotationViewport": "there is no viewport to place annotations on. Wait for the viewport's `ready` event before calling addBoxes().",
+  "error.annotationToolGroup": "that viewport is not in a tool group, so annotations would never be drawn. Mount it through <CornerstoneViewport>, or add it with useCornerstoneTools().addViewport().",
+  "error.annotationTool": "RectangleROITool is not available from @cornerstonejs/tools, and imported boxes are drawn with it.",
+  "annotationJson.notJson": "That file is not valid JSON: {message}",
+  "annotationJson.unknownShape": "That JSON is not a recognised annotation file. Expected a list of boxes, each with a `sopInstanceUid` and a `box`, or a report with a `findings` array whose entries carry `slice_findings`.",
+  "annotationJson.finding": "Finding {index}",
+  "annotationJson.class": "Class {value}",
+  "annotationJson.labelled": "{name} \xB7 {confidence}%",
+  "zip.tooLarge": "Archive expands to more than {limit} of DICOM data. Extract it and open the series you need, or raise `maxBytes`.",
+  "zip.notReadable": "That file is not a readable ZIP archive.",
+  "zip.readFailed": "Could not read the ZIP archive: {message}",
+  "series.numbered": "Series {number}",
+  "series.unnamed": "Unnamed series",
+  "series.images": { one: "{count} image", other: "{count} images" },
+  "series.label": "{name} ({details})",
+  "list.separator": ", ",
+  // Byte units come from the catalogue rather than from `Intl`'s unit style:
+  // CLDR's short English name for `byte` is "byte", so a 900-byte archive
+  // would read "900 byte".
+  "bytes.value": "{value} {unit}",
+  "bytes.unit.B": "B",
+  "bytes.unit.KB": "KB",
+  "bytes.unit.MB": "MB",
+  "bytes.unit.GB": "GB",
+  "bytes.unit.TB": "TB",
+  // ---------------------------------------------------------------------
+  // useDicomStudy: what was opened, how the opening is going, and what was
+  // turned away. Reasons read as a noun phrase so they drop straight into
+  // "{name} ({reason})".
+  "study.progress.reading": "Reading archive\u2026",
+  "study.progress.extracting": "Extracting\u2026",
+  "study.progress.indexing": "Reading headers {done} / {total}",
+  "study.error.noDicomInZip": "No DICOM images found in {file}.",
+  "study.error.noDicomFiles": {
+    one: "That file is not DICOM.",
+    other: "None of those {count} files is DICOM."
+  },
+  "study.error.noUrls": "None of those addresses could be read.",
+  "study.skipped.summary": "{count}: {named}",
+  "study.skipped.more": "{count}: {named}, and {rest} more",
+  "study.skipped.entry": "{name} ({reason})",
+  "study.skip.metadata": "housekeeping file",
+  "study.skip.notDicomExtension": "not a DICOM extension",
+  "study.skip.notDicom": "no DICOM header",
+  "study.skip.empty": "empty",
+  "study.source.files": {
+    one: "{count} local file, sorted by InstanceNumber",
+    other: "{count} local files, sorted by InstanceNumber"
+  },
+  "study.source.urls": { one: "{count} image", other: "{count} images" },
+  "study.source.zip": "{file} \u2014 {images} in {series}",
+  // "Series" is its own plural; a hand-rolled one says "serieses".
+  "study.count.series": { one: "{count} series", other: "{count} series" },
+  "study.count.skipped": { one: "{count} file skipped", other: "{count} files skipped" },
+  // useStackCine: how far decoding the stack ahead of playback has got.
+  "cine.preparing": "Preparing\u2026 {percent}%",
+  "cine.prepared": { one: "{count} image ready", other: "{count} images ready" },
+  "cine.preparedWithFailures": {
+    one: "{count} image ready, {failed} could not be decoded",
+    other: "{count} images ready, {failed} could not be decoded"
+  },
+  "cine.cacheFull": "Image cache full at {count} images \u2014 the rest load as you reach them.",
+  // useAnnotationReport: what a JSON report placed on the stack on screen.
+  "report.summary": "{file}: {placed} of {total} boxes placed.",
+  "report.waiting": {
+    one: "{count} more appears as you scroll to its slice.",
+    other: "{count} more appear as you scroll to their slices."
+  },
+  "report.dropped": {
+    one: "{count} entry could not be read.",
+    other: "{count} entries could not be read."
+  },
+  "report.empty": "{file} lists no annotations.",
+  "report.unmatched": "None of the {total} boxes belong to the images on screen \u2014 the report names series {series}. Open that study to see them.",
+  "report.unmatchedNoSeries": "None of the {total} boxes belong to the images on screen. They name slices that are not loaded.",
+  "report.failed": "Could not read {file}: {message}"
+};
+export const fa = {
+  "error.ssr": "Cornerstone3D \u0641\u0642\u0637 \u062F\u0631 \u0645\u0631\u0648\u0631\u06AF\u0631 \u0627\u062C\u0631\u0627 \u0645\u06CC\u200C\u0634\u0648\u062F (WebGL\u060C \u0648\u0628\u200C\u0648\u0631\u06A9\u0631\u060C WASM) \u0648 \u062F\u0631 \u0632\u0645\u0627\u0646 SSR \u0642\u0627\u0628\u0644 \u0627\u0633\u062A\u0641\u0627\u062F\u0647 \u0646\u06CC\u0633\u062A. ensureCornerstone() \u0631\u0627 \u0627\u0632 onMounted \u0641\u0631\u0627\u062E\u0648\u0627\u0646\u06CC \u06A9\u0646\u06CC\u062F\u060C \u06CC\u0627 \u0641\u0631\u0627\u062E\u0648\u0627\u0646 \u0631\u0627 \u062F\u0627\u062E\u0644 <ClientOnly> \u0628\u06AF\u0630\u0627\u0631\u06CC\u062F.",
+  "error.optionsLocked": "Cornerstone3D \u0647\u0645\u200C\u0627\u06A9\u0646\u0648\u0646 \u062F\u0631 \u062D\u0627\u0644 \u0631\u0627\u0647\u200C\u0627\u0646\u062F\u0627\u0632\u06CC \u0627\u0633\u062A\u061B \u06AF\u0632\u06CC\u0646\u0647\u200C\u0647\u0627 \u062F\u06CC\u06AF\u0631 \u0642\u0627\u0628\u0644 \u062A\u063A\u06CC\u06CC\u0631 \u0646\u06CC\u0633\u062A\u0646\u062F. \u062F\u0631 nuxt.config \u0645\u0642\u062F\u0627\u0631 `cornerstone.autoInit: false` \u0631\u0627 \u0628\u06AF\u0630\u0627\u0631\u06CC\u062F \u0648 ensureCornerstone(options) \u0631\u0627 \u0627\u0632 \u0627\u0641\u0632\u0648\u0646\u0647\u0654 \u062E\u0648\u062F\u062A\u0627\u0646 \u0641\u0631\u0627\u062E\u0648\u0627\u0646\u06CC \u06A9\u0646\u06CC\u062F.",
+  "error.initFailed": "\u0631\u0627\u0647\u200C\u0627\u0646\u062F\u0627\u0632\u06CC \u0646\u0627\u0645\u0648\u0641\u0642 \u0628\u0648\u062F",
+  "error.toolGroupCreate": "\u0633\u0627\u062E\u062A \u06AF\u0631\u0648\u0647 \u0627\u0628\u0632\u0627\u0631 \xAB{groupId}\xBB \u0645\u0645\u06A9\u0646 \u0646\u0634\u062F.",
+  "error.toolNotInGroup": "\u0627\u0628\u0632\u0627\u0631 \xAB{tool}\xBB \u062F\u0631 \u06AF\u0631\u0648\u0647 \u0627\u0628\u0632\u0627\u0631 \xAB{groupId}\xBB \u0646\u06CC\u0633\u062A. \u0646\u0627\u0645 \u06A9\u0644\u0627\u0633 \u0622\u0646 \u0631\u0627 \u0628\u0647 `cornerstone.tools.register` \u062F\u0631 nuxt.config \u0627\u0636\u0627\u0641\u0647 \u06A9\u0646\u06CC\u062F.",
+  "warn.unknownTool": "\xAB{tool}\xBB \u0627\u0632 \u06A9\u0644\u0627\u0633\u200C\u0647\u0627\u06CC \u0627\u0628\u0632\u0627\u0631 \u0635\u0627\u062F\u0631\u0634\u062F\u0647\u0654 @cornerstonejs/tools \u0646\u06CC\u0633\u062A\u061B \u0646\u0627\u062F\u06CC\u062F\u0647 \u06AF\u0631\u0641\u062A\u0647 \u0634\u062F.",
+  "error.annotationViewport": "\u0646\u0645\u0627\u06CC\u06CC \u0628\u0631\u0627\u06CC \u0642\u0631\u0627\u0631 \u062F\u0627\u062F\u0646 \u062D\u0627\u0634\u06CC\u0647\u200C\u0646\u0648\u06CC\u0633\u06CC\u200C\u0647\u0627 \u0648\u062C\u0648\u062F \u0646\u062F\u0627\u0631\u062F. \u067E\u06CC\u0634 \u0627\u0632 \u0641\u0631\u0627\u062E\u0648\u0627\u0646\u06CC addBoxes() \u0645\u0646\u062A\u0638\u0631 \u0631\u0648\u06CC\u062F\u0627\u062F `ready` \u0646\u0645\u0627 \u0628\u0645\u0627\u0646\u06CC\u062F.",
+  "error.annotationToolGroup": "\u0627\u06CC\u0646 \u0646\u0645\u0627 \u062F\u0631 \u0647\u06CC\u0686 \u06AF\u0631\u0648\u0647 \u0627\u0628\u0632\u0627\u0631\u06CC \u0646\u06CC\u0633\u062A\u060C \u0628\u0646\u0627\u0628\u0631\u0627\u06CC\u0646 \u062D\u0627\u0634\u06CC\u0647\u200C\u0646\u0648\u06CC\u0633\u06CC\u200C\u0647\u0627 \u0647\u0631\u06AF\u0632 \u0631\u0633\u0645 \u0646\u0645\u06CC\u200C\u0634\u0648\u0646\u062F. \u0622\u0646 \u0631\u0627 \u0628\u0627 <CornerstoneViewport> \u0633\u0648\u0627\u0631 \u06A9\u0646\u06CC\u062F\u060C \u06CC\u0627 \u0628\u0627 useCornerstoneTools().addViewport() \u0627\u0636\u0627\u0641\u0647 \u06A9\u0646\u06CC\u062F.",
+  "error.annotationTool": "\u0627\u0628\u0632\u0627\u0631 RectangleROITool \u0627\u0632 @cornerstonejs/tools \u062F\u0631 \u062F\u0633\u062A\u0631\u0633 \u0646\u06CC\u0633\u062A\u060C \u0648 \u06A9\u0627\u062F\u0631\u0647\u0627\u06CC \u0648\u0627\u0631\u062F\u0634\u062F\u0647 \u0628\u0627 \u0647\u0645\u06CC\u0646 \u0627\u0628\u0632\u0627\u0631 \u0631\u0633\u0645 \u0645\u06CC\u200C\u0634\u0648\u0646\u062F.",
+  "annotationJson.notJson": "\u0627\u06CC\u0646 \u0641\u0627\u06CC\u0644 JSON \u0645\u0639\u062A\u0628\u0631 \u0646\u06CC\u0633\u062A: {message}",
+  "annotationJson.unknownShape": "\u0633\u0627\u062E\u062A\u0627\u0631 \u0627\u06CC\u0646 JSON \u0628\u0647\u200C\u0639\u0646\u0648\u0627\u0646 \u0641\u0627\u06CC\u0644 \u062D\u0627\u0634\u06CC\u0647\u200C\u0646\u0648\u06CC\u0633\u06CC \u0634\u0646\u0627\u062E\u062A\u0647 \u0646\u0634\u062F. \u06CC\u06A9 \u0641\u0647\u0631\u0633\u062A \u0627\u0632 \u06A9\u0627\u062F\u0631\u0647\u0627 \u06A9\u0647 \u0647\u0631\u06A9\u062F\u0627\u0645 `sopInstanceUid` \u0648 `box` \u062F\u0627\u0631\u0646\u062F \u0627\u0646\u062A\u0638\u0627\u0631 \u0645\u06CC\u200C\u0631\u0641\u062A\u060C \u06CC\u0627 \u06AF\u0632\u0627\u0631\u0634\u06CC \u0628\u0627 \u0622\u0631\u0627\u06CC\u0647\u0654 `findings` \u06A9\u0647 \u0648\u0631\u0648\u062F\u06CC\u200C\u0647\u0627\u06CC\u0634 `slice_findings` \u062F\u0627\u0631\u0646\u062F.",
+  "annotationJson.finding": "\u06CC\u0627\u0641\u062A\u0647\u0654 {index}",
+  "annotationJson.class": "\u06A9\u0644\u0627\u0633 {value}",
+  "annotationJson.labelled": "{name} \xB7 \u066A{confidence}",
+  "zip.tooLarge": "\u062D\u062C\u0645 \u0628\u0627\u0632\u0634\u062F\u0647\u0654 \u0627\u06CC\u0646 \u0628\u0627\u06CC\u06AF\u0627\u0646\u06CC \u0628\u06CC\u0634 \u0627\u0632 {limit} \u062F\u0627\u062F\u0647\u0654 \u062F\u0627\u06CC\u06A9\u0627\u0645 \u0627\u0633\u062A. \u0622\u0646 \u0631\u0627 \u0627\u0633\u062A\u062E\u0631\u0627\u062C \u06A9\u0646\u06CC\u062F \u0648 \u062A\u0646\u0647\u0627 \u0633\u0631\u06CC \u0645\u0648\u0631\u062F\u0646\u06CC\u0627\u0632 \u0631\u0627 \u0628\u0627\u0632 \u06A9\u0646\u06CC\u062F\u060C \u06CC\u0627 \u0645\u0642\u062F\u0627\u0631 `maxBytes` \u0631\u0627 \u0627\u0641\u0632\u0627\u06CC\u0634 \u062F\u0647\u06CC\u062F.",
+  "zip.notReadable": "\u0627\u06CC\u0646 \u0641\u0627\u06CC\u0644 \u06CC\u06A9 \u0628\u0627\u06CC\u06AF\u0627\u0646\u06CC ZIP \u062E\u0648\u0627\u0646\u0627 \u0646\u06CC\u0633\u062A.",
+  "zip.readFailed": "\u062E\u0648\u0627\u0646\u062F\u0646 \u0628\u0627\u06CC\u06AF\u0627\u0646\u06CC ZIP \u0645\u0645\u06A9\u0646 \u0646\u0634\u062F: {message}",
+  "series.numbered": "\u0633\u0631\u06CC {number}",
+  "series.unnamed": "\u0633\u0631\u06CC \u0628\u062F\u0648\u0646 \u0646\u0627\u0645",
+  // Persian does not inflect a counted noun, so one form covers every count.
+  "series.images": { other: "{count} \u062A\u0635\u0648\u06CC\u0631" },
+  "series.label": "{name} ({details})",
+  "list.separator": "\u060C ",
+  "bytes.value": "{value} {unit}",
+  "bytes.unit.B": "\u0628\u0627\u06CC\u062A",
+  "bytes.unit.KB": "\u06A9\u06CC\u0644\u0648\u0628\u0627\u06CC\u062A",
+  "bytes.unit.MB": "\u0645\u06AF\u0627\u0628\u0627\u06CC\u062A",
+  "bytes.unit.GB": "\u06AF\u06CC\u06AF\u0627\u0628\u0627\u06CC\u062A",
+  "bytes.unit.TB": "\u062A\u0631\u0627\u0628\u0627\u06CC\u062A",
+  "study.progress.reading": "\u062F\u0631 \u062D\u0627\u0644 \u062E\u0648\u0627\u0646\u062F\u0646 \u0628\u0627\u06CC\u06AF\u0627\u0646\u06CC\u2026",
+  "study.progress.extracting": "\u062F\u0631 \u062D\u0627\u0644 \u0627\u0633\u062A\u062E\u0631\u0627\u062C\u2026",
+  "study.progress.indexing": "\u062E\u0648\u0627\u0646\u062F\u0646 \u0633\u0631\u0622\u06CC\u0646\u062F\u0647\u0627 {done} / {total}",
+  "study.error.noDicomInZip": "\u0647\u06CC\u0686 \u062A\u0635\u0648\u06CC\u0631 \u062F\u0627\u06CC\u06A9\u0627\u0645\u06CC \u062F\u0631 {file} \u067E\u06CC\u062F\u0627 \u0646\u0634\u062F.",
+  "study.error.noDicomFiles": { other: "\u0647\u06CC\u0686\u200C\u06A9\u062F\u0627\u0645 \u0627\u0632 \u0622\u0646 {count} \u0641\u0627\u06CC\u0644 \u062F\u0627\u06CC\u06A9\u0627\u0645 \u0646\u06CC\u0633\u062A." },
+  "study.error.noUrls": "\u0647\u06CC\u0686\u200C\u06CC\u06A9 \u0627\u0632 \u0622\u0646 \u0646\u0634\u0627\u0646\u06CC\u200C\u0647\u0627 \u062E\u0648\u0627\u0646\u062F\u0647 \u0646\u0634\u062F.",
+  "study.skipped.summary": "{count}: {named}",
+  "study.skipped.more": "{count}: {named} \u0648 {rest} \u0645\u0648\u0631\u062F \u062F\u06CC\u06AF\u0631",
+  "study.skipped.entry": "{name} ({reason})",
+  "study.skip.metadata": "\u0641\u0627\u06CC\u0644 \u062C\u0627\u0646\u0628\u06CC",
+  "study.skip.notDicomExtension": "\u067E\u0633\u0648\u0646\u062F \u062F\u0627\u06CC\u06A9\u0627\u0645 \u0646\u06CC\u0633\u062A",
+  "study.skip.notDicom": "\u0633\u0631\u0622\u06CC\u0646\u062F \u062F\u0627\u06CC\u06A9\u0627\u0645 \u0646\u062F\u0627\u0631\u062F",
+  "study.skip.empty": "\u062E\u0627\u0644\u06CC",
+  "study.source.files": { other: "{count} \u0641\u0627\u06CC\u0644 \u0645\u062D\u0644\u06CC\u060C \u0645\u0631\u062A\u0628\u200C\u0634\u062F\u0647 \u0628\u0631 \u0627\u0633\u0627\u0633 InstanceNumber" },
+  "study.source.urls": { other: "{count} \u062A\u0635\u0648\u06CC\u0631" },
+  "study.source.zip": "{file} \u2014 {images} \u062F\u0631 {series}",
+  "study.count.series": { other: "{count} \u0633\u0631\u06CC" },
+  "study.count.skipped": { other: "{count} \u0641\u0627\u06CC\u0644 \u0646\u0627\u062F\u06CC\u062F\u0647 \u06AF\u0631\u0641\u062A\u0647 \u0634\u062F" },
+  "cine.preparing": "\u062F\u0631 \u062D\u0627\u0644 \u0622\u0645\u0627\u062F\u0647\u200C\u0633\u0627\u0632\u06CC\u2026 \u066A{percent}",
+  "cine.prepared": { other: "{count} \u062A\u0635\u0648\u06CC\u0631 \u0622\u0645\u0627\u062F\u0647 \u0627\u0633\u062A" },
+  "cine.preparedWithFailures": {
+    other: "{count} \u062A\u0635\u0648\u06CC\u0631 \u0622\u0645\u0627\u062F\u0647 \u0627\u0633\u062A\u060C {failed} \u062A\u0635\u0648\u06CC\u0631 \u0631\u0645\u0632\u06AF\u0634\u0627\u06CC\u06CC \u0646\u0634\u062F"
+  },
+  "cine.cacheFull": "\u062D\u0627\u0641\u0638\u0647\u0654 \u0646\u0647\u0627\u0646 \u062A\u0635\u0627\u0648\u06CC\u0631 \u062F\u0631 {count} \u062A\u0635\u0648\u06CC\u0631 \u067E\u0631 \u0634\u062F \u2014 \u0628\u0642\u06CC\u0647 \u0647\u0646\u06AF\u0627\u0645 \u0631\u0633\u06CC\u062F\u0646 \u0628\u0647 \u0622\u0646\u200C\u0647\u0627 \u0628\u0627\u0631\u06AF\u0630\u0627\u0631\u06CC \u0645\u06CC\u200C\u0634\u0648\u0646\u062F.",
+  "report.summary": "{file}: {placed} \u06A9\u0627\u062F\u0631 \u0627\u0632 {total} \u06A9\u0627\u062F\u0631 \u0642\u0631\u0627\u0631 \u06AF\u0631\u0641\u062A.",
+  "report.waiting": { other: "{count} \u06A9\u0627\u062F\u0631 \u062F\u06CC\u06AF\u0631 \u0628\u0627 \u067E\u06CC\u0645\u0627\u06CC\u0634 \u0628\u0647 \u0628\u0631\u0634\u200C\u0647\u0627\u06CC\u0634\u0627\u0646 \u0646\u0645\u0627\u06CC\u0627\u0646 \u0645\u06CC\u200C\u0634\u0648\u0646\u062F." },
+  "report.dropped": { other: "{count} \u0648\u0631\u0648\u062F\u06CC \u062E\u0648\u0627\u0646\u062F\u0647 \u0646\u0634\u062F." },
+  "report.empty": "\u0641\u0627\u06CC\u0644 {file} \u0647\u06CC\u0686 \u062D\u0627\u0634\u06CC\u0647\u200C\u0646\u0648\u06CC\u0633\u06CC\u200C\u0627\u06CC \u0646\u062F\u0627\u0631\u062F.",
+  "report.unmatched": "\u0647\u06CC\u0686\u200C\u06CC\u06A9 \u0627\u0632 {total} \u06A9\u0627\u062F\u0631 \u0628\u0647 \u062A\u0635\u0627\u0648\u06CC\u0631 \u0631\u0648\u06CC \u0635\u0641\u062D\u0647 \u062A\u0639\u0644\u0642 \u0646\u062F\u0627\u0631\u062F \u2014 \u0627\u06CC\u0646 \u06AF\u0632\u0627\u0631\u0634 \u0633\u0631\u06CC {series} \u0631\u0627 \u0646\u0627\u0645 \u0645\u06CC\u200C\u0628\u0631\u062F. \u0628\u0631\u0627\u06CC \u062F\u06CC\u062F\u0646 \u0622\u0646\u200C\u0647\u0627 \u0647\u0645\u0627\u0646 \u0645\u0637\u0627\u0644\u0639\u0647 \u0631\u0627 \u0628\u0627\u0632 \u06A9\u0646\u06CC\u062F.",
+  "report.unmatchedNoSeries": "\u0647\u06CC\u0686\u200C\u06CC\u06A9 \u0627\u0632 {total} \u06A9\u0627\u062F\u0631 \u0628\u0647 \u062A\u0635\u0627\u0648\u06CC\u0631 \u0631\u0648\u06CC \u0635\u0641\u062D\u0647 \u062A\u0639\u0644\u0642 \u0646\u062F\u0627\u0631\u062F\u061B \u0628\u0631\u0634\u200C\u0647\u0627\u06CC\u06CC \u0631\u0627 \u0646\u0627\u0645 \u0645\u06CC\u200C\u0628\u0631\u0646\u062F \u06A9\u0647 \u0628\u0627\u0631\u06AF\u0630\u0627\u0631\u06CC \u0646\u0634\u062F\u0647\u200C\u0627\u0646\u062F.",
+  "report.failed": "\u062E\u0648\u0627\u0646\u062F\u0646 {file} \u0645\u0645\u06A9\u0646 \u0646\u0634\u062F: {message}"
+};
+export const BUILTIN_MESSAGES = { en, fa };

package/dist/runtime/plugin.client.d.ts

@@ -0,0 +1,13 @@
+import type { ObjectPlugin } from '#app';
+import { getCornerstoneOptions } from './cornerstone.js';
+import type { CornerstoneLibs, CornerstoneModuleOptions } from './types.js';
+/** What this plugin injects, reachable as `$cornerstone` / `useNuxtApp()`. */
+export interface NuxtCornerstone {
+    ensure: (overrides?: CornerstoneModuleOptions) => Promise<CornerstoneLibs>;
+    get: () => CornerstoneLibs | null;
+    options: typeof getCornerstoneOptions;
+}
+declare const plugin: ObjectPlugin<{
+    cornerstone: NuxtCornerstone;
+}>;
+export default plugin;

package/dist/runtime/plugin.client.js

@@ -0,0 +1,31 @@
+import { defineNuxtPlugin, useRuntimeConfig } from "#imports";
+import { t } from "./i18n/index.js";
+import {
+  configureCornerstone,
+  ensureCornerstone,
+  getCornerstoneOptions,
+  getLoadedCornerstone
+} from "./cornerstone.js";
+const plugin = defineNuxtPlugin({
+  name: "nuxt-cornerstone",
+  enforce: "pre",
+  setup() {
+    const options = useRuntimeConfig().public.cornerstone;
+    configureCornerstone(options);
+    if (getCornerstoneOptions().autoInit) {
+      ensureCornerstone().catch((error) => {
+        console.error(`[nuxt-cornerstone] ${t("error.initFailed")}`, error);
+      });
+    }
+    return {
+      provide: {
+        cornerstone: {
+          ensure: (overrides) => ensureCornerstone(overrides),
+          get: () => getLoadedCornerstone(),
+          options: getCornerstoneOptions
+        }
+      }
+    };
+  }
+});
+export default plugin;

package/dist/runtime/plugin.i18n.d.ts

@@ -0,0 +1,12 @@
+import type { ObjectPlugin } from '#app';
+/**
+ * Install the locale on both server and client, and — when asked — keep it in
+ * step with the application that installed the module.
+ *
+ * Cornerstone itself is client-only, but its strings are not: a series label or
+ * an error rendered during SSR has to come back in the configured locale, and
+ * `<html lang dir>` has to match what the client will hydrate to. Doing this in
+ * the client plugin alone produces a first paint in English that then flips.
+ */
+declare const plugin: ObjectPlugin;
+export default plugin;

package/dist/runtime/plugin.i18n.js

@@ -0,0 +1,15 @@
+import { defineNuxtPlugin, useRuntimeConfig } from "#imports";
+import { configureI18n } from "./i18n/index.js";
+import { followHostLocale, sourcesOf } from "./i18n/detect.js";
+const plugin = defineNuxtPlugin({
+  name: "nuxt-cornerstone:i18n",
+  enforce: "pre",
+  setup(nuxtApp) {
+    const options = useRuntimeConfig().public.cornerstone;
+    const i18n = options?.i18n;
+    configureI18n(i18n);
+    if (import.meta.server || !i18n || !i18n.detect) return;
+    followHostLocale(nuxtApp, sourcesOf(i18n.detect));
+  }
+});
+export default plugin;

package/dist/runtime/types.d.ts

@@ -0,0 +1,150 @@
+import type { MessageCatalog } from './i18n/messages.js';
+import type { Types as CoreTypes } from '@cornerstonejs/core';
+import type { Types as DicomLoaderTypes } from '@cornerstonejs/dicom-image-loader';
+/**
+ * Cornerstone3D is imported dynamically and only in the browser, so every
+ * reference to it in this module is type-only. `typeof import(...)` is erased
+ * at compile time and never produces a runtime import.
+ */
+export type CornerstoneCore = typeof import('@cornerstonejs/core');
+export type CornerstoneTools = typeof import('@cornerstonejs/tools');
+export type CornerstoneDicomImageLoader = typeof import('@cornerstonejs/dicom-image-loader');
+export interface CornerstoneLibs {
+    core: CornerstoneCore;
+    tools: CornerstoneTools;
+    dicomImageLoader: CornerstoneDicomImageLoader;
+}
+/** Recursive Partial that leaves functions and arrays alone. */
+export type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T extends readonly unknown[] ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * Tools registered by default. Cornerstone's `addTool` is a global registry and
+ * throws on a duplicate name, so registration is guarded (see `cornerstone.ts`).
+ */
+export declare const DEFAULT_TOOLS: readonly ["WindowLevelTool", "PanTool", "ZoomTool", "StackScrollTool", "LengthTool", "RectangleROITool", "EllipticalROITool", "ProbeTool"];
+export type DefaultToolClassName = (typeof DEFAULT_TOOLS)[number];
+/** Any exported tool class name from `@cornerstonejs/tools`. */
+export type CornerstoneToolClassName = DefaultToolClassName | (string & {});
+export interface CornerstoneToolsOptions {
+    /** Run `csToolsInit()` and register the tool classes. Default: `true`. */
+    enabled?: boolean;
+    /**
+     * Tool classes to register globally, by their export name in
+     * `@cornerstonejs/tools`. `false` registers none — do it yourself with
+     * `addTool()`. Default: {@link DEFAULT_TOOLS}.
+     */
+    register?: CornerstoneToolClassName[] | false;
+}
+/**
+ * Where to read the host application's locale from.
+ *
+ * - `'i18n'` — `nuxtApp.$i18n.locale`, which is what `@nuxtjs/i18n` and
+ *   vue-i18n expose. Duck-typed, so nothing is imported and nothing breaks
+ *   when they are absent. Followed reactively.
+ * - `'html'` — the `lang` attribute on `<html>`, watched for changes. Works
+ *   with any i18n library, since they nearly all set it.
+ * - `'navigator'` — the browser's preferred language, read once at startup.
+ */
+export type LocaleSource = 'i18n' | 'html' | 'navigator';
+export interface CornerstoneI18nOptions {
+    /**
+     * Locale for the strings this module produces. Default: `'en'`.
+     *
+     * `en` and `fa` ship with the module; any other locale needs a catalogue of
+     * its own in {@link CornerstoneI18nOptions.messages}.
+     */
+    locale?: string;
+    /** Used for keys the active locale is missing. Default: `'en'`. */
+    fallbackLocale?: string;
+    /**
+     * Catalogues merged over the built-in ones, keyed by locale. Use it to
+     * override individual strings, add a locale, or register keys of your own —
+     * `t()` resolves anything in here.
+     *
+     * These travel through `runtimeConfig`, so values must be plain strings (or
+     * plural-form objects), not functions.
+     */
+    messages?: Record<string, MessageCatalog>;
+    /**
+     * `'auto'` (default) lets each locale use its own digits, which means
+     * Persian-Indic digits in Farsi. `'latn'` pins every locale to 0-9, for apps
+     * whose users cross-reference slice numbers against other systems.
+     */
+    numberingSystem?: 'auto' | 'latn';
+    /**
+     * Follow the locale of the application that installed the module, instead of
+     * the one pinned in {@link CornerstoneI18nOptions.locale}. Default: `false`.
+     *
+     * `true` tries each {@link LocaleSource} in order and stops at the first one
+     * that answers; an array picks the sources and their order yourself.
+     *
+     * Only a locale the module has a catalogue for is adopted, so an app running
+     * in a language nobody has translated keeps the configured locale rather than
+     * silently flipping text direction under the viewer.
+     *
+     * Detection is client-side. The locale is module-scoped state, which on the
+     * server is shared by every in-flight request, so following a per-request
+     * locale there would let one request's language leak into another's. During
+     * SSR the configured locale is used — see "Internationalisation" in the
+     * README for the per-request case.
+     */
+    detect?: boolean | LocaleSource[];
+}
+export interface CornerstoneModuleOptions {
+    /**
+     * Initialise Cornerstone3D from the client plugin, as the app boots, rather
+     * than lazily on first viewport mount. Default: `true`.
+     *
+     * Set to `false` when you need to pass non-serializable options (callbacks
+     * such as `dicomImageLoader.beforeSend`, or `core.peerImport`): those cannot
+     * travel through `runtimeConfig`, so pass them to `ensureCornerstone()` from
+     * a plugin of your own instead.
+     */
+    autoInit?: boolean;
+    /** Passed to `coreInit()`. Deep-merged over Cornerstone's own defaults. */
+    core?: DeepPartial<CoreTypes.Cornerstone3DConfig>;
+    /** Passed to `dicomImageLoaderInit()`. */
+    dicomImageLoader?: DicomLoaderTypes.LoaderOptions;
+    tools?: CornerstoneToolsOptions;
+    /**
+     * Locale and message catalogues for the module's own strings — the errors it
+     * throws and the series labels `useDicomFiles()` builds.
+     *
+     * `false` turns the catalogue off: the module stays on English and ignores
+     * locale changes, which is what you want when the host app owns these
+     * strings. Route them through its i18n with `setTranslator()` from
+     * `useCornerstoneI18n()`.
+     */
+    i18n?: CornerstoneI18nOptions | false;
+    /**
+     * Register `@originjs/vite-plugin-commonjs` on the client build. Default:
+     * `true`, and it is required for images to decode at all in dev.
+     *
+     * The DICOM image loader has to stay out of dependency prebundling (esbuild
+     * cannot resolve its WASM specifiers), which means Vite serves its imports
+     * raw — including the four Emscripten codec bundles, which are UMD/CommonJS.
+     * Without this plugin those imports fail with "doesn't provide an export
+     * named: 'default'". Only turn it off if you are supplying your own CommonJS
+     * interop.
+     */
+    viteCommonjs?: boolean;
+    /** Component name prefix. Default: `'Cornerstone'` (→ `<CornerstoneViewport>`). */
+    prefix?: string;
+    /** Default rendering engine id shared by viewports. */
+    renderingEngineId?: string;
+    /** Default tool group id shared by viewports. */
+    toolGroupId?: string;
+}
+/** Module options after defaults are applied. */
+export type ResolvedCornerstoneOptions = Required<Pick<CornerstoneModuleOptions, 'autoInit' | 'core' | 'dicomImageLoader' | 'viteCommonjs' | 'prefix' | 'renderingEngineId' | 'toolGroupId'>> & {
+    tools: Required<CornerstoneToolsOptions>;
+    i18n: Required<CornerstoneI18nOptions> | false;
+};
+/** A mouse/keyboard binding for `setActive`, as `tools.Enums.MouseBindings`. */
+export interface ToolBinding {
+    mouseButton?: number;
+    modifierKey?: number;
+    numTouchPoints?: number;
+}
+export type StackViewport = CoreTypes.IStackViewport;

package/dist/runtime/types.js

@@ -0,0 +1,10 @@
+export const DEFAULT_TOOLS = [
+  "WindowLevelTool",
+  "PanTool",
+  "ZoomTool",
+  "StackScrollTool",
+  "LengthTool",
+  "RectangleROITool",
+  "EllipticalROITool",
+  "ProbeTool"
+];