Repository Public License
1// ORIX Convert — Packages/ORIXConvertCore/Sources/ConvertCore/Formats.swift2// Description: Format identity and the format catalog. A catalog entry only describes a format (names, extensions,3// signatures). It does NOT mean the format is supported: support exists only where an engine declares a4// ConversionPath whose tests pass (see FormatRegistry).5// Author: Simon-Pierre Boucher — contact@spboucher.ai6import Foundation78/// Stable identifier of a file format, e.g. `png`, `docx`, `geojson`.9public struct FormatID: Hashable, Codable, Sendable, RawRepresentable, ExpressibleByStringLiteral, CustomStringConvertible, Comparable {10 public let rawValue: String11 public init(rawValue: String) { self.rawValue = rawValue.lowercased() }12 public init(_ raw: String) { self.init(rawValue: raw) }13 public init(stringLiteral value: String) { self.init(rawValue: value) }14 public var description: String { rawValue }15 public static func < (a: FormatID, b: FormatID) -> Bool { a.rawValue < b.rawValue }16}1718public enum FormatCategory: String, Codable, Sendable, CaseIterable {19 case image, vector, video, audio, document, pdf, spreadsheet, data, presentation, archive20 case model3D, font, subtitle, ebook, geospatial, scientific, other21}2223/// Intrinsic properties of a format, used for planning and for honest warnings.24public struct FormatTraits: OptionSet, Codable, Sendable, Hashable {25 public let rawValue: Int26 public init(rawValue: Int) { self.rawValue = rawValue }27 /// The format's usual encodings discard information (JPEG, MP3…).28 public static let lossy = FormatTraits(rawValue: 1 << 0)29 public static let alpha = FormatTraits(rawValue: 1 << 1)30 public static let animation = FormatTraits(rawValue: 1 << 2)31 public static let multiPage = FormatTraits(rawValue: 1 << 3)32 public static let metadata = FormatTraits(rawValue: 1 << 4)33 public static let hdr = FormatTraits(rawValue: 1 << 5)34 public static let vector = FormatTraits(rawValue: 1 << 6)35 public static let container = FormatTraits(rawValue: 1 << 7)36 public static let text = FormatTraits(rawValue: 1 << 8)37 /// The output is a directory rather than a single file.38 public static let directory = FormatTraits(rawValue: 1 << 9)39 public static let multiSheet = FormatTraits(rawValue: 1 << 10)40 public static let styled = FormatTraits(rawValue: 1 << 11)41}4243public struct FileFormat: Sendable, Hashable, Codable, Identifiable {44 public let id: FormatID45 /// Human name, English (localized by the app through its string catalog).46 public let name: String47 public let category: FormatCategory48 /// Lower-case extensions without a dot; the first one is used for output files.49 public let extensions: [String]50 public let uti: String?51 public let mime: String?52 public let traits: FormatTraits5354 public init(_ id: FormatID, _ name: String, _ category: FormatCategory, _ extensions: [String], uti: String? = nil, mime: String? = nil, traits: FormatTraits = []) {55 self.id = id; self.name = name; self.category = category; self.extensions = extensions56 self.uti = uti; self.mime = mime; self.traits = traits57 }5859 public var preferredExtension: String { extensions.first ?? id.rawValue }60}6162public extension FormatID {63 // Images64 static let png: FormatID = "png", jpeg: FormatID = "jpeg", heic: FormatID = "heic", heif: FormatID = "heif"65 static let webp: FormatID = "webp", avif: FormatID = "avif", tiff: FormatID = "tiff", bmp: FormatID = "bmp"66 static let gif: FormatID = "gif", apng: FormatID = "apng", ico: FormatID = "ico", icns: FormatID = "icns"67 static let psd: FormatID = "psd", raw: FormatID = "raw", dng: FormatID = "dng", exr: FormatID = "exr"68 static let hdr: FormatID = "hdr", tga: FormatID = "tga", ppm: FormatID = "ppm", pgm: FormatID = "pgm", pbm: FormatID = "pbm"69 static let jp2: FormatID = "jp2", jxl: FormatID = "jxl"70 // Vector71 static let svg: FormatID = "svg"72 // PDF73 static let pdf: FormatID = "pdf"74 // Video75 static let mp4: FormatID = "mp4", mov: FormatID = "mov", mkv: FormatID = "mkv", avi: FormatID = "avi", webm: FormatID = "webm"76 static let m4v: FormatID = "m4v", mpeg: FormatID = "mpeg", ts: FormatID = "ts", mts: FormatID = "mts"77 static let flv: FormatID = "flv", wmv: FormatID = "wmv"78 // Audio79 static let mp3: FormatID = "mp3", wav: FormatID = "wav", flac: FormatID = "flac", aac: FormatID = "aac", m4a: FormatID = "m4a"80 static let aiff: FormatID = "aiff", alac: FormatID = "alac", ogg: FormatID = "ogg", opus: FormatID = "opus", wma: FormatID = "wma"81 static let midi: FormatID = "midi", caf: FormatID = "caf"82 // Documents83 static let docx: FormatID = "docx", doc: FormatID = "doc", rtf: FormatID = "rtf", txt: FormatID = "txt", markdown: FormatID = "markdown"84 static let html: FormatID = "html", odt: FormatID = "odt", latex: FormatID = "latex", pages: FormatID = "pages", rst: FormatID = "rst"85 // Ebook86 static let epub: FormatID = "epub"87 // Spreadsheet & data88 static let xlsx: FormatID = "xlsx", xls: FormatID = "xls", ods: FormatID = "ods", csv: FormatID = "csv", tsv: FormatID = "tsv"89 static let json: FormatID = "json", jsonl: FormatID = "jsonl", parquet: FormatID = "parquet", arrow: FormatID = "arrow"90 static let sqlite: FormatID = "sqlite", duckdb: FormatID = "duckdb", xml: FormatID = "xml", yaml: FormatID = "yaml", toml: FormatID = "toml"91 static let plist: FormatID = "plist"92 // Presentations93 static let pptx: FormatID = "pptx", ppt: FormatID = "ppt", odp: FormatID = "odp", keynote: FormatID = "keynote"94 // Archives95 static let zip: FormatID = "zip", sevenZip: FormatID = "7z", rar: FormatID = "rar", tar: FormatID = "tar", gz: FormatID = "gz"96 static let bz2: FormatID = "bz2", xz: FormatID = "xz", zst: FormatID = "zst", tgz: FormatID = "tgz", tbz2: FormatID = "tbz2"97 static let txz: FormatID = "txz", tzst: FormatID = "tzst"98 // 3D99 static let obj: FormatID = "obj", stl: FormatID = "stl", ply: FormatID = "ply", gltf: FormatID = "gltf", glb: FormatID = "glb"100 static let fbx: FormatID = "fbx", usd: FormatID = "usd", usda: FormatID = "usda", usdc: FormatID = "usdc", usdz: FormatID = "usdz"101 static let dae: FormatID = "dae", threeMF: FormatID = "3mf"102 // Fonts103 static let ttf: FormatID = "ttf", otf: FormatID = "otf", woff: FormatID = "woff", woff2: FormatID = "woff2"104 // Subtitles105 static let srt: FormatID = "srt", vtt: FormatID = "vtt", ass: FormatID = "ass", ssa: FormatID = "ssa", sub: FormatID = "sub"106 // Geospatial107 static let geojson: FormatID = "geojson", kml: FormatID = "kml", gpx: FormatID = "gpx", shapefile: FormatID = "shp", geopackage: FormatID = "gpkg"108 static let kmz: FormatID = "kmz"109 // Scientific110 static let hdf5: FormatID = "hdf5", netcdf: FormatID = "netcdf"111 /// Pseudo-format: the output is a folder (archive extraction, page/slide/frame export, image extraction).112 static let folder: FormatID = "folder"113}114115/// Descriptions of every format ORIX Convert knows how to name and detect.116public enum FormatCatalog {117 public static let all: [FileFormat] = [118 // Images119 .init(.png, "PNG", .image, ["png"], uti: "public.png", mime: "image/png", traits: [.alpha, .metadata]),120 .init(.jpeg, "JPEG", .image, ["jpg", "jpeg", "jpe"], uti: "public.jpeg", mime: "image/jpeg", traits: [.lossy, .metadata]),121 .init(.heic, "HEIC", .image, ["heic"], uti: "public.heic", mime: "image/heic", traits: [.lossy, .alpha, .metadata, .hdr]),122 .init(.heif, "HEIF", .image, ["heif"], uti: "public.heif", mime: "image/heif", traits: [.lossy, .alpha, .metadata, .hdr]),123 .init(.webp, "WebP", .image, ["webp"], uti: "org.webmproject.webp", mime: "image/webp", traits: [.alpha, .animation, .metadata]),124 .init(.avif, "AVIF", .image, ["avif"], uti: "public.avif", mime: "image/avif", traits: [.lossy, .alpha, .metadata, .hdr]),125 .init(.tiff, "TIFF", .image, ["tiff", "tif"], uti: "public.tiff", mime: "image/tiff", traits: [.alpha, .metadata, .multiPage]),126 .init(.bmp, "BMP", .image, ["bmp"], uti: "com.microsoft.bmp", mime: "image/bmp"),127 .init(.gif, "GIF", .image, ["gif"], uti: "com.compuserve.gif", mime: "image/gif", traits: [.alpha, .animation]),128 .init(.apng, "Animated PNG", .image, ["apng"], uti: "public.png", mime: "image/apng", traits: [.alpha, .animation]),129 .init(.ico, "Windows Icon", .image, ["ico"], uti: "com.microsoft.ico", mime: "image/vnd.microsoft.icon", traits: [.alpha]),130 .init(.icns, "Apple Icon", .image, ["icns"], uti: "com.apple.icns", traits: [.alpha]),131 .init(.psd, "Photoshop", .image, ["psd"], uti: "com.adobe.photoshop-image", mime: "image/vnd.adobe.photoshop", traits: [.alpha]),132 .init(.raw, "Camera RAW", .image, ["cr2", "cr3", "nef", "arw", "raf", "orf", "rw2", "pef", "srw", "raw"], uti: "public.camera-raw-image", traits: [.metadata, .hdr]),133 .init(.dng, "Digital Negative", .image, ["dng"], uti: "com.adobe.raw-image", traits: [.metadata, .hdr]),134 .init(.exr, "OpenEXR", .image, ["exr"], uti: "com.ilm.openexr-image", traits: [.alpha, .hdr]),135 .init(.hdr, "Radiance HDR", .image, ["hdr"], uti: "public.radiance", traits: [.hdr]),136 .init(.tga, "Targa", .image, ["tga"], uti: "com.truevision.tga-image", traits: [.alpha]),137 .init(.ppm, "Portable Pixmap", .image, ["ppm"], mime: "image/x-portable-pixmap"),138 .init(.pgm, "Portable Graymap", .image, ["pgm"], mime: "image/x-portable-graymap"),139 .init(.pbm, "Portable Bitmap", .image, ["pbm"], mime: "image/x-portable-bitmap"),140 .init(.jp2, "JPEG 2000", .image, ["jp2", "j2k"], uti: "public.jpeg-2000", mime: "image/jp2", traits: [.alpha]),141 .init(.jxl, "JPEG XL", .image, ["jxl"], uti: "public.jpeg-xl", mime: "image/jxl", traits: [.alpha, .hdr]),142 .init(.svg, "SVG", .vector, ["svg"], uti: "public.svg-image", mime: "image/svg+xml", traits: [.vector, .alpha, .text]),143 .init(.pdf, "PDF", .pdf, ["pdf"], uti: "com.adobe.pdf", mime: "application/pdf", traits: [.vector, .multiPage, .metadata]),144 // Video145 .init(.mp4, "MP4", .video, ["mp4"], uti: "public.mpeg-4", mime: "video/mp4", traits: [.container, .metadata]),146 .init(.mov, "QuickTime Movie", .video, ["mov", "qt"], uti: "com.apple.quicktime-movie", mime: "video/quicktime", traits: [.container, .metadata]),147 .init(.mkv, "Matroska", .video, ["mkv"], mime: "video/x-matroska", traits: [.container, .metadata]),148 .init(.avi, "AVI", .video, ["avi"], uti: "public.avi", mime: "video/x-msvideo", traits: [.container]),149 .init(.webm, "WebM", .video, ["webm"], mime: "video/webm", traits: [.container]),150 .init(.m4v, "M4V", .video, ["m4v"], uti: "com.apple.m4v-video", mime: "video/x-m4v", traits: [.container, .metadata]),151 .init(.mpeg, "MPEG Program Stream", .video, ["mpg", "mpeg"], uti: "public.mpeg", mime: "video/mpeg", traits: [.container]),152 .init(.ts, "MPEG Transport Stream", .video, ["ts"], mime: "video/mp2t", traits: [.container]),153 .init(.mts, "AVCHD", .video, ["mts", "m2ts"], traits: [.container]),154 .init(.flv, "Flash Video", .video, ["flv"], mime: "video/x-flv", traits: [.container]),155 .init(.wmv, "Windows Media Video", .video, ["wmv", "asf"], mime: "video/x-ms-wmv", traits: [.container]),156 // Audio157 .init(.mp3, "MP3", .audio, ["mp3"], uti: "public.mp3", mime: "audio/mpeg", traits: [.lossy, .metadata]),158 .init(.wav, "WAV", .audio, ["wav", "wave"], uti: "com.microsoft.waveform-audio", mime: "audio/wav"),159 .init(.flac, "FLAC", .audio, ["flac"], uti: "org.xiph.flac", mime: "audio/flac", traits: [.metadata]),160 .init(.aac, "AAC (ADTS)", .audio, ["aac"], uti: "public.aac-audio", mime: "audio/aac", traits: [.lossy]),161 .init(.m4a, "M4A (AAC)", .audio, ["m4a"], uti: "com.apple.m4a-audio", mime: "audio/mp4", traits: [.lossy, .metadata]),162 .init(.alac, "Apple Lossless (M4A)", .audio, ["m4a"], uti: "com.apple.m4a-audio", mime: "audio/mp4", traits: [.metadata]),163 .init(.aiff, "AIFF", .audio, ["aiff", "aif"], uti: "public.aiff-audio", mime: "audio/aiff"),164 .init(.ogg, "Ogg Vorbis", .audio, ["ogg", "oga"], mime: "audio/ogg", traits: [.lossy, .metadata]),165 .init(.opus, "Opus", .audio, ["opus"], mime: "audio/opus", traits: [.lossy, .metadata]),166 .init(.wma, "Windows Media Audio", .audio, ["wma"], mime: "audio/x-ms-wma", traits: [.lossy]),167 .init(.midi, "MIDI", .audio, ["mid", "midi"], uti: "public.midi-audio", mime: "audio/midi"),168 .init(.caf, "Core Audio Format", .audio, ["caf"], uti: "com.apple.coreaudio-format"),169 // Documents170 .init(.docx, "Word (DOCX)", .document, ["docx"], uti: "org.openxmlformats.wordprocessingml.document", traits: [.styled, .metadata]),171 .init(.doc, "Word 97–2004 (DOC)", .document, ["doc"], uti: "com.microsoft.word.doc", traits: [.styled]),172 .init(.rtf, "Rich Text", .document, ["rtf"], uti: "public.rtf", mime: "application/rtf", traits: [.styled, .text]),173 .init(.txt, "Plain Text", .document, ["txt", "text"], uti: "public.plain-text", mime: "text/plain", traits: [.text]),174 .init(.markdown, "Markdown", .document, ["md", "markdown"], uti: "net.daringfireball.markdown", mime: "text/markdown", traits: [.text]),175 .init(.html, "HTML", .document, ["html", "htm"], uti: "public.html", mime: "text/html", traits: [.styled, .text]),176 .init(.odt, "OpenDocument Text", .document, ["odt"], uti: "org.oasis-open.opendocument.text", traits: [.styled, .metadata]),177 .init(.latex, "LaTeX", .document, ["tex", "latex"], uti: "org.tug.tex", traits: [.text]),178 .init(.rst, "reStructuredText", .document, ["rst"], traits: [.text]),179 .init(.pages, "Pages", .document, ["pages"], uti: "com.apple.iwork.pages.sffpages", traits: [.styled]),180 .init(.epub, "EPUB", .ebook, ["epub"], uti: "org.idpf.epub-container", mime: "application/epub+zip", traits: [.styled, .metadata]),181 // Spreadsheet & data182 .init(.xlsx, "Excel (XLSX)", .spreadsheet, ["xlsx"], uti: "org.openxmlformats.spreadsheetml.sheet", traits: [.multiSheet, .styled]),183 .init(.xls, "Excel 97–2004 (XLS)", .spreadsheet, ["xls"], uti: "com.microsoft.excel.xls", traits: [.multiSheet, .styled]),184 .init(.ods, "OpenDocument Spreadsheet", .spreadsheet, ["ods"], uti: "org.oasis-open.opendocument.spreadsheet", traits: [.multiSheet, .styled]),185 .init(.csv, "CSV", .data, ["csv"], uti: "public.comma-separated-values-text", mime: "text/csv", traits: [.text]),186 .init(.tsv, "TSV", .data, ["tsv", "tab"], uti: "public.tab-separated-values-text", mime: "text/tab-separated-values", traits: [.text]),187 .init(.json, "JSON", .data, ["json"], uti: "public.json", mime: "application/json", traits: [.text]),188 .init(.jsonl, "JSON Lines", .data, ["jsonl", "ndjson"], mime: "application/x-ndjson", traits: [.text]),189 .init(.parquet, "Parquet", .data, ["parquet"]),190 .init(.arrow, "Arrow IPC", .data, ["arrow", "feather"]),191 .init(.sqlite, "SQLite", .data, ["sqlite", "sqlite3", "db"], traits: [.multiSheet]),192 .init(.duckdb, "DuckDB", .data, ["duckdb"], traits: [.multiSheet]),193 .init(.xml, "XML", .data, ["xml"], uti: "public.xml", mime: "application/xml", traits: [.text]),194 .init(.yaml, "YAML", .data, ["yaml", "yml"], uti: "public.yaml", mime: "application/yaml", traits: [.text]),195 .init(.toml, "TOML", .data, ["toml"], mime: "application/toml", traits: [.text]),196 .init(.plist, "Property List", .data, ["plist"], uti: "com.apple.property-list"),197 // Presentations198 .init(.pptx, "PowerPoint (PPTX)", .presentation, ["pptx"], uti: "org.openxmlformats.presentationml.presentation", traits: [.multiPage, .styled]),199 .init(.ppt, "PowerPoint 97–2004 (PPT)", .presentation, ["ppt"], uti: "com.microsoft.powerpoint.ppt", traits: [.multiPage, .styled]),200 .init(.odp, "OpenDocument Presentation", .presentation, ["odp"], uti: "org.oasis-open.opendocument.presentation", traits: [.multiPage, .styled]),201 .init(.keynote, "Keynote", .presentation, ["key"], uti: "com.apple.iwork.keynote.sffkey", traits: [.multiPage, .styled]),202 // Archives203 .init(.zip, "ZIP", .archive, ["zip"], uti: "public.zip-archive", mime: "application/zip", traits: [.container]),204 .init(.sevenZip, "7-Zip", .archive, ["7z"], uti: "org.7-zip.7-zip-archive", mime: "application/x-7z-compressed", traits: [.container]),205 .init(.rar, "RAR", .archive, ["rar"], uti: "com.rarlab.rar-archive", mime: "application/vnd.rar", traits: [.container]),206 .init(.tar, "TAR", .archive, ["tar"], uti: "public.tar-archive", mime: "application/x-tar", traits: [.container]),207 .init(.gz, "Gzip", .archive, ["gz"], uti: "org.gnu.gnu-zip-archive", mime: "application/gzip"),208 .init(.bz2, "Bzip2", .archive, ["bz2"], uti: "public.bzip2-archive", mime: "application/x-bzip2"),209 .init(.xz, "XZ", .archive, ["xz"], uti: "org.tukaani.xz-archive", mime: "application/x-xz"),210 .init(.zst, "Zstandard", .archive, ["zst"], mime: "application/zstd"),211 .init(.tgz, "TAR + Gzip", .archive, ["tgz", "tar.gz"], uti: "org.gnu.gnu-zip-tar-archive", traits: [.container]),212 .init(.tbz2, "TAR + Bzip2", .archive, ["tbz2", "tbz", "tar.bz2"], traits: [.container]),213 .init(.txz, "TAR + XZ", .archive, ["txz", "tar.xz"], traits: [.container]),214 .init(.tzst, "TAR + Zstandard", .archive, ["tzst", "tar.zst"], traits: [.container]),215 // 3D216 .init(.obj, "Wavefront OBJ", .model3D, ["obj"], uti: "public.geometry-definition-format", traits: [.text]),217 .init(.stl, "STL", .model3D, ["stl"], uti: "public.standard-tesselated-geometry-format"),218 .init(.ply, "PLY", .model3D, ["ply"], uti: "public.polygon-file-format"),219 .init(.gltf, "glTF", .model3D, ["gltf"], mime: "model/gltf+json", traits: [.text]),220 .init(.glb, "glTF Binary", .model3D, ["glb"], mime: "model/gltf-binary"),221 .init(.fbx, "FBX", .model3D, ["fbx"]),222 .init(.usd, "USD", .model3D, ["usd"], uti: "com.pixar.universal-scene-description"),223 .init(.usda, "USD (ASCII)", .model3D, ["usda"], traits: [.text]),224 .init(.usdc, "USD (Crate)", .model3D, ["usdc"]),225 .init(.usdz, "USDZ", .model3D, ["usdz"], uti: "com.pixar.universal-scene-description-mobile"),226 .init(.dae, "COLLADA", .model3D, ["dae"], uti: "org.khronos.collada.digital-asset-exchange", traits: [.text]),227 .init(.threeMF, "3MF", .model3D, ["3mf"], mime: "model/3mf"),228 // Fonts229 .init(.ttf, "TrueType Font", .font, ["ttf"], uti: "public.truetype-ttf-font", mime: "font/ttf"),230 .init(.otf, "OpenType Font", .font, ["otf"], uti: "public.opentype-font", mime: "font/otf"),231 .init(.woff, "WOFF", .font, ["woff"], uti: "org.w3.woff", mime: "font/woff"),232 .init(.woff2, "WOFF2", .font, ["woff2"], uti: "org.w3.woff2", mime: "font/woff2"),233 // Subtitles234 .init(.srt, "SubRip", .subtitle, ["srt"], traits: [.text]),235 .init(.vtt, "WebVTT", .subtitle, ["vtt"], mime: "text/vtt", traits: [.text]),236 .init(.ass, "Advanced SubStation Alpha", .subtitle, ["ass"], traits: [.text, .styled]),237 .init(.ssa, "SubStation Alpha", .subtitle, ["ssa"], traits: [.text, .styled]),238 .init(.sub, "MicroDVD", .subtitle, ["sub"], traits: [.text]),239 // Geospatial240 .init(.geojson, "GeoJSON", .geospatial, ["geojson"], uti: "public.geojson", mime: "application/geo+json", traits: [.text]),241 .init(.kml, "KML", .geospatial, ["kml"], mime: "application/vnd.google-earth.kml+xml", traits: [.text]),242 .init(.kmz, "KMZ", .geospatial, ["kmz"], mime: "application/vnd.google-earth.kmz", traits: [.container]),243 .init(.gpx, "GPX", .geospatial, ["gpx"], uti: "com.topografix.gpx", mime: "application/gpx+xml", traits: [.text]),244 .init(.shapefile, "Shapefile", .geospatial, ["shp"]),245 .init(.geopackage, "GeoPackage", .geospatial, ["gpkg"]),246 // Scientific247 .init(.hdf5, "HDF5", .scientific, ["h5", "hdf5", "hdf"]),248 .init(.netcdf, "NetCDF", .scientific, ["nc", "nc4", "cdf"]),249 // Pseudo250 .init(.folder, "Folder", .other, [], uti: "public.folder", traits: [.directory]),251 ]252253 private static let index: [FormatID: FileFormat] = Dictionary(uniqueKeysWithValues: all.map { ($0.id, $0) })254255 public static func format(_ id: FormatID) -> FileFormat? { index[id] }256257 /// Formats whose extension list contains `ext` (several formats can share an extension, e.g. `m4a`).258 public static func formats(forExtension ext: String) -> [FileFormat] {259 let e = ext.lowercased()260 return all.filter { $0.extensions.contains(e) }261 }262}263