biblioplex 0.1.1 → 0.2.1

package/vendor/searchCore.js

@@ -1,223 +0,0 @@
-// Pure, DOM-free search / match / sort core.
-// Imported by the web app (search.js) and the biblioplex CLI so both share one
-// implementation of the query grammar and sort order. Depends only on
-// collection.js (which depends only on state.js) — no document/window/localStorage.
-import { normalizeLocation, locationKey, formatLocationLabel } from './collection.js';
-
-const SEARCH_FIELD_ALIASES = {
-  n: 'name', name: 'name',
-  t: 'type', type: 'type',
-  c: 'colors', color: 'colors', colors: 'colors',
-  ci: 'ci', identity: 'ci',
-  cmc: 'cmc', mv: 'cmc',
-  o: 'oracle', oracle: 'oracle', text: 'oracle',
-  r: 'rarity', rarity: 'rarity',
-  loc: 'loc', location: 'loc',
-  tag: 'tag', tags: 'tag',
-  s: 'set', set: 'set',
-  f: 'finish', finish: 'finish',
-  qty: 'qty',
-  cond: 'cond', condition: 'cond',
-  lang: 'lang', language: 'lang',
-};
-const RARITY_SHORT = { c: 'common', u: 'uncommon', r: 'rare', m: 'mythic' };
-
-export function tokenizeSearch(query) {
-  const tokens = [];
-  let i = 0;
-  const s = query;
-  const isSpace = ch => /\s/.test(ch);
-  while (i < s.length) {
-    while (i < s.length && isSpace(s[i])) i++;
-    if (i >= s.length) break;
-    let neg = false;
-    if (s[i] === '-' && i + 1 < s.length && !isSpace(s[i + 1])) { neg = true; i++; }
-    const fieldStart = i;
-    while (i < s.length && /[a-zA-Z]/.test(s[i])) i++;
-    const fieldRaw = s.slice(fieldStart, i).toLowerCase();
-    let op = null;
-    if (i < s.length && (s[i] === ':' || s[i] === '<' || s[i] === '>' || s[i] === '=')) {
-      if (s[i] === '<' || s[i] === '>') {
-        op = s[i++];
-        if (s[i] === '=') op += s[i++];
-      } else {
-        op = s[i++];
-      }
-    } else {
-      i = fieldStart;
-    }
-    let value = '';
-    if (i < s.length && s[i] === '"') {
-      i++;
-      while (i < s.length && s[i] !== '"') value += s[i++];
-      if (i < s.length && s[i] === '"') i++;
-    } else {
-      while (i < s.length && !isSpace(s[i])) value += s[i++];
-    }
-    if (op && SEARCH_FIELD_ALIASES[fieldRaw]) {
-      tokens.push({ field: SEARCH_FIELD_ALIASES[fieldRaw], op, value, neg });
-    } else if (value) {
-      tokens.push({ field: 'name', op: ':', value, neg });
-    }
-  }
-  return tokens;
-}
-
-function compareNum(a, op, b) {
-  switch (op) {
-    case ':': case '=': return a === b;
-    case '<': return a < b;
-    case '<=': return a <= b;
-    case '>': return a > b;
-    case '>=': return a >= b;
-  }
-  return false;
-}
-
-function colorSetFromValue(value) {
-  const lower = value.toLowerCase();
-  if (lower === 'colorless' || lower === 'c') return new Set();
-  return new Set(lower.replace(/[^wubrg]/g, '').split(''));
-}
-
-function matchToken(c, token) {
-  let result = false;
-  const v = token.value;
-  switch (token.field) {
-    case 'name': {
-      const name = (c.resolvedName || c.name || '').toLowerCase();
-      result = name.includes(v.toLowerCase());
-      break;
-    }
-    case 'type': {
-      result = (c.typeLine || '').toLowerCase().includes(v.toLowerCase());
-      break;
-    }
-    case 'colors':
-    case 'ci': {
-      const arr = (token.field === 'ci' ? c.colorIdentity : c.colors) || [];
-      const cardSet = new Set(arr.map(x => x.toLowerCase()));
-      const wanted = colorSetFromValue(v);
-      if (wanted.size === 0) {
-        result = cardSet.size === 0;
-      } else {
-        result = [...wanted].every(w => cardSet.has(w));
-      }
-      break;
-    }
-    case 'cmc': {
-      const cmc = c.cmc;
-      if (cmc == null) { result = false; break; }
-      const target = parseFloat(v);
-      if (isNaN(target)) { result = false; break; }
-      result = compareNum(cmc, token.op, target);
-      break;
-    }
-    case 'oracle': {
-      result = (c.oracleText || '').toLowerCase().includes(v.toLowerCase());
-      break;
-    }
-    case 'rarity': {
-      const r = (c.rarity || '').toLowerCase();
-      const want = v.toLowerCase();
-      result = r === want || r === RARITY_SHORT[want];
-      break;
-    }
-    case 'loc': {
-      const loc = normalizeLocation(c.location);
-      if (!loc) { result = false; break; }
-      const want = v.toLowerCase().replace(/^(binder|box):/, 'container:');
-      // Match against the joined "type:name" label so substrings of either
-      // field, AND the full typed label like "container:rares", all match.
-      const label = loc.type + ':' + loc.name;
-      result = label.includes(want);
-      break;
-    }
-    case 'tag': {
-      const cardTags = c.tags || [];
-      const want = v.toLowerCase();
-      result = cardTags.some(t => t.toLowerCase().includes(want));
-      break;
-    }
-    case 'set': {
-      result = (c.setCode || '').toLowerCase() === v.toLowerCase();
-      break;
-    }
-    case 'finish': {
-      result = (c.finish || '').toLowerCase() === v.toLowerCase();
-      break;
-    }
-    case 'qty': {
-      const target = parseFloat(v);
-      if (isNaN(target)) { result = false; break; }
-      result = compareNum(c.qty || 0, token.op, target);
-      break;
-    }
-    case 'cond': {
-      const cn = (c.condition || '').toLowerCase().replace(/_/g, ' ');
-      result = cn.includes(v.toLowerCase().replace(/_/g, ' '));
-      break;
-    }
-    case 'lang': {
-      result = (c.language || '').toLowerCase() === v.toLowerCase();
-      break;
-    }
-  }
-  return token.neg ? !result : result;
-}
-
-export function matchSearch(c, tokens) {
-  if (tokens.length === 0) return true;
-  return tokens.every(t => matchToken(c, t));
-}
-
-// Pure helper: applies multiselect filters to a card. Exported for tests.
-// Each `*Selected` argument is an array of selected values (empty = no filter).
-// `format`, when truthy, is a Scryfall format key (e.g. 'modern', 'commander').
-// Cards explicitly marked banned/not_legal in that format are excluded.
-// Cards with unknown legality (legacy entries pre-backfill, or in-flight
-// scryfall lookups) pass — lenient default avoids hiding cards just because
-// the metadata hasn't loaded yet.
-export function passesMultiselectFilters(c, { sets, rarities, finishes, locations, tags, format } = {}) {
-  if (sets && sets.length && !sets.includes(c.setCode)) return false;
-  if (rarities && rarities.length && !rarities.includes(c.rarity)) return false;
-  if (finishes && finishes.length && !finishes.includes(c.finish)) return false;
-  if (locations && locations.length && !locations.includes(locationKey(c.location))) return false;
-  if (tags && tags.length) {
-    const cardTags = c.tags || [];
-    if (!cardTags.some(t => tags.includes(t))) return false;
-  }
-  if (format && c.legalities && typeof c.legalities === 'object') {
-    const status = c.legalities[format];
-    if (status === 'banned' || status === 'not_legal') return false;
-  }
-  return true;
-}
-
-export const RARITY_ORDER = { common: 0, uncommon: 1, rare: 2, mythic: 3, special: 4, bonus: 5 };
-export const CONDITION_ORDER = { near_mint: 0, lightly_played: 1, moderately_played: 2, heavily_played: 3, damaged: 4 };
-
-export function compareCards(a, b, field) {
-  const an = (a.resolvedName || a.name || '').toLowerCase();
-  const bn = (b.resolvedName || b.name || '').toLowerCase();
-  const fallback = an.localeCompare(bn);
-  switch (field) {
-    case 'name': return an.localeCompare(bn);
-    case 'set': return (a.setCode || '').localeCompare(b.setCode || '') || fallback;
-    case 'cn': {
-      const ai = parseInt(a.cn || '', 10);
-      const bi = parseInt(b.cn || '', 10);
-      const aValid = !isNaN(ai), bValid = !isNaN(bi);
-      if (aValid && bValid && ai !== bi) return ai - bi;
-      return (a.cn || '').localeCompare(b.cn || '') || fallback;
-    }
-    case 'finish': return (a.finish || '').localeCompare(b.finish || '') || fallback;
-    case 'rarity': return ((RARITY_ORDER[a.rarity] ?? 99) - (RARITY_ORDER[b.rarity] ?? 99)) || fallback;
-    case 'condition': return ((CONDITION_ORDER[a.condition] ?? 99) - (CONDITION_ORDER[b.condition] ?? 99)) || fallback;
-    case 'location': return formatLocationLabel(a.location).localeCompare(formatLocationLabel(b.location)) || fallback;
-    case 'qty': return (a.qty || 0) - (b.qty || 0) || fallback;
-    case 'price': return (a.price || 0) - (b.price || 0) || fallback;
-    case 'cmc': return (a.cmc ?? 999) - (b.cmc ?? 999) || fallback;
-    default: return fallback;
-  }
-}

package/vendor/state.js

@@ -1,91 +0,0 @@
-function isPlainObject(value) {
-  return value && typeof value === 'object' && !Array.isArray(value);
-}
-
-function cloneSelectedKeys(raw) {
-  if (raw instanceof Set) return new Set(raw);
-  if (Array.isArray(raw)) return new Set(raw);
-  return new Set();
-}
-
-export function createInitialState(overrides = {}) {
-  const initial = {
-    collection: [],
-    containers: {},
-    // Top-level routes: 'collection' | 'decks' | 'storage'.
-    viewMode: 'collection',
-    // The single physical container currently being browsed, independent from
-    // broad collection filters. Stored as { type, name } or null.
-    activeLocation: null,
-    // Binder-shape escape hatch only. Collection/decks/storage don't use this.
-    viewAsList: false,
-    collectionDisplayMode: 'table',
-    selectedFormat: '',
-    selectedKeys: new Set(),
-    detailIndex: -1,
-    deckGroupBy: 'type',
-    deckMode: 'visual',
-    deckBoardFilter: 'all',
-    deckCardSize: 'medium',
-    deckShowPrices: true,
-    deckOwnershipView: 'building',
-    deckSampleHand: null,
-    binderSize: '4x3',
-    binderPage: 0,
-    binderShowPrices: true,
-    binderMode: 'view',
-    binderSort: 'binder',
-    binderSearch: '',
-    binderColorFilter: '',
-    binderTypeFilter: '',
-    sortField: null,
-    sortDir: 'asc',
-    // When non-null, the app is in read-only viewer mode for someone else's
-    // shared deck. Set by share.js initShareViewer(); cleared by reloading
-    // without `?share=`. Persisted writes are guarded in persistence.js.
-    shareSnapshot: null,
-  };
-  const next = { ...initial, ...overrides };
-  next.collection = Array.isArray(overrides.collection) ? overrides.collection : initial.collection;
-  next.containers = isPlainObject(overrides.containers) ? overrides.containers : initial.containers;
-  next.selectedKeys = cloneSelectedKeys(overrides.selectedKeys);
-  return next;
-}
-
-// Shared mutable state. Use object properties (not let bindings) so
-// other modules can both read and reassign through `state.x = ...`.
-export const state = createInitialState();
-
-export function resetState(overrides = {}) {
-  const next = createInitialState(overrides);
-  for (const key of Object.keys(state)) delete state[key];
-  Object.assign(state, next);
-  return state;
-}
-
-export function applyLoadedState(loaded = {}) {
-  const defaults = createInitialState();
-  state.collection = Array.isArray(loaded.collection) ? loaded.collection : defaults.collection;
-  state.containers = isPlainObject(loaded.containers) ? loaded.containers : defaults.containers;
-  state.viewMode = typeof loaded.viewMode === 'string' ? loaded.viewMode : defaults.viewMode;
-  state.activeLocation = loaded.activeLocation ?? defaults.activeLocation;
-  state.viewAsList = Boolean(loaded.viewAsList);
-  state.collectionDisplayMode = loaded.collectionDisplayMode === 'visual' ? 'visual' : defaults.collectionDisplayMode;
-  state.selectedFormat = typeof loaded.selectedFormat === 'string' ? loaded.selectedFormat : defaults.selectedFormat;
-  state.sortField = typeof loaded.sortField === 'string' && loaded.sortField ? loaded.sortField : defaults.sortField;
-  state.sortDir = loaded.sortDir === 'desc' ? 'desc' : defaults.sortDir;
-  state.selectedKeys = new Set();
-  state.detailIndex = defaults.detailIndex;
-  state.deckSampleHand = defaults.deckSampleHand;
-  state.binderPage = defaults.binderPage;
-  state.shareSnapshot = loaded.shareSnapshot ?? defaults.shareSnapshot;
-  return state;
-}
-
-export const STORAGE_KEY = 'mtgcollection_v1';
-export const DECK_GROUP_KEY = 'mtgcollection_deck_group_v1';
-export const DECK_VIEW_PREFS_KEY = 'mtgcollection_deck_view_prefs_v1';
-export const BINDER_SIZE_KEY = 'mtgcollection_binder_size_v1';
-export const BINDER_PRICES_KEY = 'mtgcollection_binder_prices_v1';
-export const BINDER_VIEW_PREFS_KEY = 'mtgcollection_binder_view_prefs_v1';
-export const SCRYFALL_API = 'https://api.scryfall.com';

package/vendor/storageSchema.js

@@ -1,75 +0,0 @@
-import {
-  normalizeCollectionEntry,
-  normalizeContainers,
-} from './collection.js';
-
-export const APP_STORAGE_SCHEMA_VERSION = 1;
-const VALID_STORED_VIEW_MODES = ['collection', 'decks', 'storage'];
-const VALID_COLLECTION_DISPLAY_MODES = ['table', 'visual'];
-
-function isPlainObject(value) {
-  return value && typeof value === 'object' && !Array.isArray(value);
-}
-
-export function normalizeStoredViewMode(raw) {
-  if (VALID_STORED_VIEW_MODES.includes(raw)) return raw;
-  if (raw === 'locations') return 'storage';
-  return 'collection';
-}
-
-export function normalizeStoredCollectionDisplayMode(raw) {
-  return VALID_COLLECTION_DISPLAY_MODES.includes(raw) ? raw : 'table';
-}
-
-export function normalizeStoredUi(raw = {}) {
-  const source = isPlainObject(raw) ? raw : {};
-  return {
-    viewMode: normalizeStoredViewMode(source.viewMode),
-    viewAsList: Boolean(source.viewAsList),
-    collectionDisplayMode: normalizeStoredCollectionDisplayMode(source.collectionDisplayMode),
-    selectedFormat: typeof source.selectedFormat === 'string' ? source.selectedFormat : '',
-    sortField: typeof source.sortField === 'string' && source.sortField ? source.sortField : null,
-    sortDir: source.sortDir === 'desc' ? 'desc' : 'asc',
-  };
-}
-
-export function normalizeStoredCollectionEntry(raw) {
-  if (!isPlainObject(raw)) return null;
-  return normalizeCollectionEntry(raw, { preserveResolvedFields: true });
-}
-
-export function normalizeStoredCollection(rawCollection) {
-  if (!Array.isArray(rawCollection)) return null;
-  return rawCollection.map(normalizeStoredCollectionEntry).filter(Boolean);
-}
-
-export function normalizeStoredAppData(raw) {
-  if (!isPlainObject(raw)) return null;
-  const rawVersion = raw.schemaVersion;
-  if (
-    rawVersion != null
-    && rawVersion !== APP_STORAGE_SCHEMA_VERSION
-    && rawVersion !== String(APP_STORAGE_SCHEMA_VERSION)
-  ) {
-    return null;
-  }
-
-  const collection = normalizeStoredCollection(raw.collection);
-  if (!collection) return null;
-
-  return {
-    schemaVersion: APP_STORAGE_SCHEMA_VERSION,
-    collection,
-    containers: normalizeContainers(raw.containers),
-    ui: normalizeStoredUi(isPlainObject(raw.ui) ? raw.ui : raw),
-  };
-}
-
-export function serializeAppState(stateRef) {
-  return {
-    schemaVersion: APP_STORAGE_SCHEMA_VERSION,
-    collection: Array.isArray(stateRef.collection) ? stateRef.collection : [],
-    containers: isPlainObject(stateRef.containers) ? stateRef.containers : {},
-    ui: normalizeStoredUi(stateRef),
-  };
-}

package/vendor/syncOps.js

@@ -1,188 +0,0 @@
-import { collectionKey, containerKey, normalizeContainers } from './collection.js';
-import { makeSyncSnapshot } from './portableArchive.js';
-
-export const SYNC_OP_SCHEMA_VERSION = 1;
-const SYNCED_UI_KEYS = new Set(['selectedFormat']);
-
-function cloneJson(value, fallback = null) {
-  if (value == null) return fallback;
-  try {
-    return JSON.parse(JSON.stringify(value));
-  } catch (e) {
-    return fallback;
-  }
-}
-
-function stableStringify(value) {
-  if (Array.isArray(value)) return '[' + value.map(stableStringify).join(',') + ']';
-  if (value && typeof value === 'object') {
-    return '{' + Object.keys(value).sort().map(key => (
-      JSON.stringify(key) + ':' + stableStringify(value[key])
-    )).join(',') + '}';
-  }
-  return JSON.stringify(value);
-}
-
-function sameJson(a, b) {
-  return stableStringify(a) === stableStringify(b);
-}
-
-function entrySoftIdentity(entry) {
-  if (!entry) return '';
-  return [
-    entry.scryfallId || '',
-    entry.setCode || '',
-    entry.cn || '',
-    entry.name || entry.resolvedName || '',
-    entry.finish || '',
-    entry.condition || '',
-    entry.language || '',
-  ].join('|');
-}
-
-function opId(prefix) {
-  return prefix + '_' + Date.now().toString(36) + '_' + Math.random().toString(36).slice(2, 10);
-}
-
-export function makeSyncOp(type, payload = {}, options = {}) {
-  return {
-    schemaVersion: SYNC_OP_SCHEMA_VERSION,
-    id: options.id || opId('op'),
-    type,
-    ts: options.ts || Date.now(),
-    payload: cloneJson(payload, {}),
-  };
-}
-
-function collectionMap(collection = []) {
-  const out = new Map();
-  for (const entry of collection || []) out.set(collectionKey(entry), entry);
-  return out;
-}
-
-function containersMap(containers = {}) {
-  const out = new Map();
-  for (const container of Object.values(normalizeContainers(containers))) {
-    out.set(containerKey(container), container);
-  }
-  return out;
-}
-
-function diffCollection(beforeCollection = [], afterCollection = []) {
-  const ops = [];
-  const before = collectionMap(beforeCollection);
-  const after = collectionMap(afterCollection);
-  const removed = new Map();
-  const added = new Map();
-
-  for (const [key, entry] of before.entries()) {
-    if (!after.has(key)) removed.set(key, entry);
-  }
-  for (const [key, entry] of after.entries()) {
-    if (!before.has(key)) added.set(key, entry);
-  }
-
-  for (const [key, beforeEntry] of before.entries()) {
-    if (!after.has(key)) continue;
-    const afterEntry = after.get(key);
-    if (sameJson(beforeEntry, afterEntry)) continue;
-    const beforeSansQty = { ...beforeEntry, qty: afterEntry.qty };
-    if (sameJson(beforeSansQty, afterEntry)) {
-      ops.push(makeSyncOp('collection.qtyDelta', {
-        key,
-        delta: (parseInt(afterEntry.qty, 10) || 0) - (parseInt(beforeEntry.qty, 10) || 0),
-        entry: afterEntry,
-      }));
-    } else {
-      ops.push(makeSyncOp('collection.replace', {
-        beforeKey: key,
-        afterKey: key,
-        entry: afterEntry,
-      }));
-    }
-  }
-
-  const matchedRemoved = new Set();
-  const matchedAdded = new Set();
-  for (const [addedKey, addedEntry] of added.entries()) {
-    const addedIdentity = entrySoftIdentity(addedEntry);
-    if (!addedIdentity) continue;
-    for (const [removedKey, removedEntry] of removed.entries()) {
-      if (matchedRemoved.has(removedKey)) continue;
-      if (entrySoftIdentity(removedEntry) !== addedIdentity) continue;
-      matchedRemoved.add(removedKey);
-      matchedAdded.add(addedKey);
-      ops.push(makeSyncOp('collection.replace', {
-        beforeKey: removedKey,
-        afterKey: addedKey,
-        entry: addedEntry,
-      }));
-      break;
-    }
-  }
-
-  for (const [key, entry] of added.entries()) {
-    if (matchedAdded.has(key)) continue;
-    ops.push(makeSyncOp('collection.upsert', { key, entry }));
-  }
-  for (const [key] of removed.entries()) {
-    if (matchedRemoved.has(key)) continue;
-    ops.push(makeSyncOp('collection.remove', { key }));
-  }
-  return ops;
-}
-
-function diffContainers(beforeContainers = {}, afterContainers = {}) {
-  const ops = [];
-  const before = containersMap(beforeContainers);
-  const after = containersMap(afterContainers);
-  for (const [key, container] of after.entries()) {
-    if (!before.has(key) || !sameJson(before.get(key), container)) {
-      ops.push(makeSyncOp('container.upsert', { key, container }));
-    }
-  }
-  for (const [key] of before.entries()) {
-    if (!after.has(key)) ops.push(makeSyncOp('container.remove', { key }));
-  }
-  return ops;
-}
-
-function diffUi(beforeUi = {}, afterUi = {}) {
-  const patch = {};
-  for (const key of Object.keys(afterUi || {})) {
-    if (!SYNCED_UI_KEYS.has(key)) continue;
-    if (!sameJson(beforeUi?.[key], afterUi[key])) patch[key] = cloneJson(afterUi[key], afterUi[key]);
-  }
-  return Object.keys(patch).length ? [makeSyncOp('ui.patch', { patch })] : [];
-}
-
-function diffHistory(beforeHistory = [], afterHistory = []) {
-  if (sameJson(beforeHistory, afterHistory)) return [];
-  const beforeIds = new Set(beforeHistory.map(ev => ev?.id).filter(Boolean));
-  const appended = afterHistory.filter(ev => ev?.id && !beforeIds.has(ev.id));
-  if (appended.length && beforeHistory.length + appended.length === afterHistory.length) {
-    return appended.map(event => makeSyncOp('history.append', { event }));
-  }
-  return [makeSyncOp('history.replace', { history: afterHistory })];
-}
-
-export function diffSyncSnapshots(beforeRaw, afterRaw) {
-  const before = makeSyncSnapshot(beforeRaw);
-  const after = makeSyncSnapshot(afterRaw);
-  if (!after) return [];
-  if (!before) return [makeSyncOp('snapshot.replace', { snapshot: after })];
-
-  const ops = [
-    ...diffCollection(before.app.collection, after.app.collection),
-    ...diffContainers(before.app.containers, after.app.containers),
-    ...diffUi(before.app.ui, after.app.ui),
-    ...diffHistory(before.history, after.history),
-  ];
-
-  // Shares are derived from containers today. If future share metadata diverges,
-  // sync the whole snapshot rather than silently dropping ownership state.
-  if (!sameJson(before.shares, after.shares) && ops.length === 0) {
-    ops.push(makeSyncOp('snapshot.replace', { snapshot: after }));
-  }
-  return ops;
-}