SPB Git

Repository Public License

Formats.swift 20.4 KB 263 lines swift

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
Files main
Menu

Theme