@moloodev/platform 0.9.1 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moloodev/platform",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -21,9 +21,9 @@
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
-    "tsx": "^4.23.13",
+    "vitest": "5.1.0",
     "typescript": "^7.0.2",
-    "@moloodev/typescript-config": "0.9.1"
+    "@moloodev/typescript-config": "0.11.0"
   },
   "publishConfig": {
     "access": "public"
@@ -35,6 +35,6 @@
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "tsx --test 'src/**/*.test.ts' 'src/**/*.test.tsx'"
+    "test": "vitest run --root ../.. --project @moloodev/platform"
   }
 }

package/src/asset-types.ts

@@ -1,25 +1,5 @@
-/** Icons used by asset kinds and file appearance resolvers. Independent of chrome `AppIcon`. */
-export const FILE_APPEARANCE_ICONS = [
-  "tabler:folder",
-  "tabler:hierarchy",
-  "tabler:layout",
-  "tabler:table",
-  "tabler:markdown",
-  "tabler:photo",
-  "tabler:movie",
-  "tabler:music",
-  "tabler:file-text",
-  "tabler:database",
-  "tabler:code",
-  "tabler:archive",
-  "tabler:typography",
-  "tabler:cube",
-  "tabler:file",
-  "tabler:package",
-  "tabler:help",
-] as const;
-
-export type AssetTypeIcon = (typeof FILE_APPEARANCE_ICONS)[number];
+/** Tabler URI for a file glyph; hosts use a neutral glyph for unknown names. */
+export type AssetTypeIcon = `tabler:${string}`;
 
 /**
  * Primitive storage and CRDT collaboration mode for an asset.
@@ -56,6 +36,8 @@ export type FileAppearance = {
 
 /** Optional file matcher rule declared by an installed `EditorManifest`. */
 export type FileAppearanceMatcher = {
+  /** Explicit asset kind id for type-only surfaces; never inferred from an editor. */
+  type?: string;
   extensions?: readonly string[];
   mimeTypes?: readonly string[];
   schema?: string;
@@ -71,31 +53,32 @@ export const UNKNOWN_FILE_APPEARANCE: FileAppearance = {
   icon: "tabler:help",
 };
 
-const PATTERN_APPEARANCE_MAP = {
-  "moloo.folder": { label: "폴더", color: "#94a3b8", icon: "tabler:folder" },
-  "moloo.loop": { label: "루프", color: "#f07858", icon: "tabler:hierarchy" },
-  "moloo.table": { label: "테이블", color: "#3d9b8f", icon: "tabler:table" },
-  "moloo.markdown": { label: "마크다운", color: "#5b6abf", icon: "tabler:markdown" },
-  "moloo.bundle": { label: "번들", color: "#2f7a86", icon: "tabler:package" },
-  "moloo.layout": { label: "레이아웃", color: "#7695b3", icon: "tabler:layout" },
-  "moloo.catalog": { label: "카탈로그", color: "#9474ad", icon: "tabler:package" },
-  "moloo.image": { label: "이미지", color: "#a5c65b", icon: "tabler:photo" },
-  "moloo.video": { label: "비디오", color: "#8f7fe0", icon: "tabler:movie" },
-  "moloo.audio": { label: "오디오", color: "#c78cd9", icon: "tabler:music" },
-  "moloo.document": { label: "문서", color: "#89b4e8", icon: "tabler:file-text" },
-  "moloo.data": { label: "데이터", color: "#66b06f", icon: "tabler:database" },
-  "moloo.code": { label: "코드", color: "#5c73c9", icon: "tabler:code" },
-  "moloo.archive": { label: "압축", color: "#b3a27a", icon: "tabler:archive" },
-  "moloo.font": { label: "글꼴", color: "#b09bbf", icon: "tabler:typography" },
-  "moloo.model": { label: "3D 모델", color: "#d1b24f", icon: "tabler:cube" },
-  "moloo.binary": { label: "바이너리", color: "#a7adba", icon: "tabler:file" },
-} as const satisfies Record<string, FileAppearance>;
+/** Classification identifiers, independent of display identity. */
+export const KNOWN_PATTERN_IDS = [
+  "moloo.folder", "moloo.loop", "moloo.table", "moloo.markdown",
+  "moloo.bundle", "moloo.layout", "moloo.catalog", "moloo.image",
+  "moloo.video", "moloo.audio", "moloo.document", "moloo.data",
+  "moloo.code", "moloo.archive", "moloo.font", "moloo.model", "moloo.binary",
+] as const;
+export type KnownPatternId = (typeof KNOWN_PATTERN_IDS)[number];
 
-export type KnownPatternId = keyof typeof PATTERN_APPEARANCE_MAP;
+const DIRECTORY_APPEARANCE: FileAppearance = {
+  label: "폴더", color: UNKNOWN_FILE_APPEARANCE.color, icon: "tabler:folder",
+};
 
-export const KNOWN_PATTERN_IDS = Object.keys(
-  PATTERN_APPEARANCE_MAP,
-) as KnownPatternId[];
+/** Type-only surfaces use the same explicit file-type declaration as file surfaces. */
+export function resolveTypeAppearance(
+  type: string,
+  matchers: readonly FileAppearanceMatcher[] = [],
+): FileAppearance {
+  if (type === "moloo.folder") return DIRECTORY_APPEARANCE;
+  const matcher = matchers.find((entry) => entry.type === type);
+  return {
+    label: matcher?.label ?? (type || UNKNOWN_FILE_APPEARANCE.label),
+    icon: matcher?.icon ?? UNKNOWN_FILE_APPEARANCE.icon,
+    color: matcher?.color ?? UNKNOWN_FILE_APPEARANCE.color,
+  };
+}
 
 const DOCUMENT_SUBTYPES = new Set([
   "pdf",
@@ -340,14 +323,6 @@ export function classifyFile(input: {
   };
 }
 
-const FIRST_PARTY_SCHEMA_APPEARANCE: Record<string, FileAppearance> = {
-  [FIRST_PARTY_SCHEMAS.layout]: PATTERN_APPEARANCE_MAP["moloo.layout"],
-  [FIRST_PARTY_SCHEMAS.catalog]: PATTERN_APPEARANCE_MAP["moloo.catalog"],
-  [FIRST_PARTY_SCHEMAS.table]: PATTERN_APPEARANCE_MAP["moloo.table"],
-  [FIRST_PARTY_SCHEMAS.loop]: PATTERN_APPEARANCE_MAP["moloo.loop"],
-  [FIRST_PARTY_SCHEMAS.bundle]: PATTERN_APPEARANCE_MAP["moloo.bundle"],
-};
-
 function isCompoundExtension(ext: string): boolean {
   const withoutLeadingDot = ext.startsWith(".") ? ext.slice(1) : ext;
   return withoutLeadingDot.includes(".");
@@ -365,7 +340,8 @@ function scoreMatcher(
   if (matcher.storageMode && file.storageMode && matcher.storageMode !== file.storageMode) {
     return 0;
   }
-  if (matcher.schema && file.schema && matcher.schema === file.schema) {
+  if (matcher.schema && file.schema) {
+    if (matcher.schema !== file.schema) return 0;
     return 400;
   }
   const lowerName = file.name.toLowerCase();
@@ -396,119 +372,42 @@ function scoreMatcher(
 }
 
 /**
- * Resolve cosmetic display metadata (`label`, `color`, `icon`) for a file from
- * installed editor matchers, falling back to first-party `$schema`/extension
- * rules and OS-style MIME family defaults.
+ * File identity comes only from manifest fileTypes. Highest specificity wins:
+ * schema, compound extension, extension, exact MIME, MIME family. Ties keep the
+ * first declaration (hosts sort manifests by editor id). Missing fields are
+ * neutral, never borrowed from a different rule or the owning editor.
  */
 export function resolveFileAppearance(
   file: {
     name: string;
     storageMode?: string;
-    contentType: string;
+    contentType?: string | null;
     schema?: string | null;
   },
   matchers: readonly FileAppearanceMatcher[] = [],
 ): FileAppearance {
   if (file.name === ".keep" || normalizeMimeType(file.contentType) === "application/x-directory") {
-    return PATTERN_APPEARANCE_MAP["moloo.folder"];
+    return DIRECTORY_APPEARANCE;
   }
-
-  const classified = classifyFile({
-    fileName: file.name,
-    contentType: file.contentType,
-  });
-  const effectiveSchema = file.schema ?? classified.defaultSchema;
+  const classified = classifyFile({ fileName: file.name, contentType: file.contentType });
   const effectiveFile = {
     ...file,
     storageMode: file.storageMode ?? classified.storageMode,
     contentType: normalizeMimeType(file.contentType) || classified.contentType,
-    schema: effectiveSchema,
+    schema: file.schema ?? classified.defaultSchema,
   };
-
   let bestScore = 0;
-  let bestMatcher: FileAppearanceMatcher | null = null;
+  let bestMatcher: FileAppearanceMatcher | undefined;
   for (const matcher of matchers) {
     const score = scoreMatcher(effectiveFile, matcher);
-    if (score > bestScore && (matcher.label || matcher.icon || matcher.color)) {
+    if (score > bestScore) {
       bestScore = score;
       bestMatcher = matcher;
     }
   }
-
-  if (effectiveSchema && FIRST_PARTY_SCHEMA_APPEARANCE[effectiveSchema]) {
-    const base = FIRST_PARTY_SCHEMA_APPEARANCE[effectiveSchema]!;
-    // Only let a matcher override a first-party schema/compound-extension appearance
-    // when it matched at schema (>= 400) or compound-extension (>= 300) specificity,
-    // never on a generic .json or application/json rule.
-    const override = bestScore >= 300 ? bestMatcher : null;
-    return {
-      label: override?.label ?? base.label,
-      color: override?.color ?? base.color,
-      icon: override?.icon ?? base.icon,
-    };
-  }
-
-  const lowerName = file.name.toLowerCase();
-  const mime = effectiveFile.contentType;
-  if (
-    mime === "text/markdown" ||
-    lowerName.endsWith(".md") ||
-    lowerName.endsWith(".markdown")
-  ) {
-    const md = PATTERN_APPEARANCE_MAP["moloo.markdown"];
-    const override = bestScore >= 150 ? bestMatcher : null;
-    return {
-      label: override?.label ?? md.label,
-      color: override?.color ?? md.color,
-      icon: override?.icon ?? md.icon,
-    };
-  }
-
-  const fallbackKind = patternForContentType(mime);
-  const fallback = PATTERN_APPEARANCE_MAP[fallbackKind];
   return {
-    label: bestMatcher?.label ?? fallback.label,
-    color: bestMatcher?.color ?? fallback.color,
-    icon: bestMatcher?.icon ?? fallback.icon,
+    label: bestMatcher?.label ?? UNKNOWN_FILE_APPEARANCE.label,
+    icon: bestMatcher?.icon ?? UNKNOWN_FILE_APPEARANCE.icon,
+    color: bestMatcher?.color ?? UNKNOWN_FILE_APPEARANCE.color,
   };
 }
-
-/**
- * Resolve cosmetic appearance for either a pattern/kind identifier (`moloo.*`)
- * or an asset summary with `name`, `storageMode`, `contentType`, and `schema`.
- * When file fields (`storageMode`, `schema`, or `contentType` + `name`) are
- * present, they take precedence over a legacy `type` string.
- */
-export function resolvePatternAppearance(
-  input:
-    | string
-    | {
-        type?: string;
-        name?: string;
-        storageMode?: StorageMode;
-        contentType?: string | null;
-        schema?: string | null;
-      },
-): FileAppearance {
-  if (typeof input === "string") {
-    return Object.hasOwn(PATTERN_APPEARANCE_MAP, input)
-      ? PATTERN_APPEARANCE_MAP[input as KnownPatternId]
-      : UNKNOWN_FILE_APPEARANCE;
-  }
-  if (
-    input.storageMode ||
-    input.schema ||
-    (input.contentType && input.name)
-  ) {
-    return resolveFileAppearance({
-      name: input.name ?? "",
-      storageMode: input.storageMode,
-      contentType: input.contentType ?? "application/octet-stream",
-      schema: input.schema ?? null,
-    });
-  }
-  if (input.type && Object.hasOwn(PATTERN_APPEARANCE_MAP, input.type)) {
-    return PATTERN_APPEARANCE_MAP[input.type as KnownPatternId];
-  }
-  return UNKNOWN_FILE_APPEARANCE;
-}

package/src/editor-appearance.ts

@@ -0,0 +1,7 @@
+/** Editor identity is declared at the manifest top level, independently of files. */
+export function resolveEditorAppearance(editor: { icon?: string; color?: string }): {
+  icon: string;
+  color: string;
+} {
+  return { icon: editor.icon ?? "tabler:help", color: editor.color ?? "#94a3b8" };
+}

package/src/index.ts

@@ -7,7 +7,6 @@ export {
 } from "./qualified-name";
 
 export {
-  FILE_APPEARANCE_ICONS,
   FIRST_PARTY_SCHEMAS,
   KNOWN_PATTERN_IDS,
   STORAGE_MODES,
@@ -16,7 +15,7 @@ export {
   isStorageMode,
   patternForContentType,
   resolveFileAppearance,
-  resolvePatternAppearance,
+  resolveTypeAppearance,
   type AssetTypeIcon,
   type FileAppearance,
   type FileAppearanceMatcher,
@@ -94,3 +93,5 @@ export { EDITOR_TRACKS, isEditorTrack, type EditorTrack } from "./editor-track";
 export type { PublishTarget } from "./publish-target";
 export { PUBLISH_ERROR_MESSAGES, publishErrorBody, parsePublishName } from "./publish-target";
 export { isPublisherHandle, isReservedPublisherHandle, reservedPublishers } from "./publisher-handle";
+
+export { resolveEditorAppearance } from "./editor-appearance";