@expo-harmony/config-plugins 55.0.10-harmony.1 → 55.0.10-harmony.3

package/build/generatedFiles.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRawfile = exports.withHarmonyGeneratedFiles = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("./errors");
+const files_1 = require("./files");
+const mods_1 = require("./mods");
+const ownership_1 = require("./ownership");
+const paths_1 = require("./paths");
+const withHarmonyGeneratedFiles = (config, options) => {
+    const { owner, files } = options;
+    if (!files || typeof files !== 'object' || Array.isArray(files)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', 'Generated files must be a path-to-descriptor map.');
+    }
+    const claims = (0, ownership_1.getHarmonyConfigPlugins)(config).find(plugin => plugin.owner === owner);
+    const paths = [...new Set([...(claims?.files ?? []), ...Object.keys(files)])];
+    config = (0, ownership_1.registerHarmonyConfigPlugin)(config, owner, { ...claims, files: paths });
+    return (0, mods_1.withHarmonyDangerousMod)(config, async (mod) => {
+        if (mod.modRequest.introspect)
+            return mod;
+        const writes = [];
+        for (const [relative, input] of Object.entries(files)) {
+            if (!input || typeof input !== 'object'
+                || Object.hasOwn(input, 'source') === Object.hasOwn(input, 'content')) {
+                throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${relative} must define exactly one of source or content.`);
+            }
+            const file = await (0, paths_1.resolveHarmonyPath)(mod.modRequest.platformProjectRoot, relative);
+            let content;
+            if (Object.hasOwn(input, 'source')) {
+                if (typeof input.source !== 'string' || !input.source) {
+                    throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${relative} source must be a non-empty path.`);
+                }
+                const source = node_path_1.default.resolve(mod.modRequest.projectRoot, input.source);
+                content = Uint8Array.from(await node_fs_1.default.promises.readFile(source));
+            }
+            else {
+                if (typeof input.content !== 'string' && !(input.content instanceof Uint8Array)) {
+                    throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${relative} content must be a string or Uint8Array.`);
+                }
+                content = input.content;
+            }
+            writes.push({ file, content });
+        }
+        for (const { file, content } of writes) {
+            await (0, files_1.atomicWrite)(file, content);
+            (0, mods_1.recordManagedFile)(mod, file, owner);
+        }
+        return mod;
+    });
+};
+exports.withHarmonyGeneratedFiles = withHarmonyGeneratedFiles;
+const withRawfile = (config, { owner, files }) => {
+    if (!files || typeof files !== 'object' || Array.isArray(files)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', 'Rawfiles must be a path-to-descriptor map.');
+    }
+    const prefix = 'entry/src/main/resources/rawfile/';
+    const output = {};
+    for (const [relative, input] of Object.entries(files)) {
+        if (!relative || relative.includes('\\') || relative.split('/').some(part => !part || part === '.' || part === '..')) {
+            throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_PATH_ESCAPE', `Invalid rawfile path: ${relative}`);
+        }
+        output[prefix + relative] = input;
+    }
+    return (0, exports.withHarmonyGeneratedFiles)(config, { owner, files: output });
+};
+exports.withRawfile = withRawfile;

package/build/index.d.ts

@@ -0,0 +1,27 @@
+export { defineExpoHarmonyConfig } from './config';
+export { createRunOncePlugin, withPlugins, withRunOnce, withStaticPlugin } from './composition';
+export type { HarmonyPluginReference, HarmonyStaticPlugin } from './composition';
+export { compileHarmonyModsAsync } from './compiler';
+export type { HarmonyCompileOptions } from './compiler';
+export { createHarmonyFileMod, withHarmonyJsonFile } from './customFiles';
+export type { HarmonyFileModOptions, HarmonyJsonFileOptions } from './customFiles';
+export type { ExpoConfigWithHarmony, ExpoHarmonyPlatform, ExpoKnownPlatform, HarmonyConfig, HarmonyDeviceType, HarmonyOrientation, HarmonyPermission, HarmonyPlatform, HarmonySkill, HarmonySkillUri, } from './config';
+export { HarmonyConfigPluginError } from './errors';
+export type { HarmonyConfigPluginErrorOptions } from './errors';
+export { atomicWrite, stableJson as stableHarmonyJson } from './files';
+export { normalizeHarmonyConfig } from './normalizeConfig';
+export type { HarmonyExpoConfig, NormalizedHarmonyConfig } from './normalizeConfig';
+export { HarmonyModNames as HARMONY_MOD_NAMES, recordManagedFile, withAppJson, withArkTSPackageProvider, withCMakeLists, withColors, withCppPackageProvider, withEntryAbility, withEntryBuildProfile, withEntryHvigor, withEntryOhPackage, withHarmonyAutolinking, withHarmonyBaseMods, withHarmonyDangerousMod, withHarmonyMod, withHarmonyResources, withHvigorConfig, withIndexPage, withMedia, withModuleJson, withProfiles, withProjectBuildProfile, withReactNativeConfig, withRootHvigor, withRootOhPackage, withStrings, withWorker, } from './mods';
+export type { HarmonyJson, HarmonyMediaDescriptor, HarmonyMediaMap, HarmonyModName, HarmonyResourceMap, } from './mods';
+export { registerHarmonyConfigPlugin } from './ownership';
+export type { HarmonyConfigPluginOwnership } from './ownership';
+export { HarmonyPaths } from './paths';
+export type { HarmonyManagedPaths, HarmonyPathsApi, HarmonyProjectPathCandidates, HarmonyProjectPaths, HarmonyResourcePaths, } from './paths';
+export type { HarmonyConfigPlugin, HarmonyModAction, HarmonyModConfig } from './pluginTypes';
+export * as HarmonyManifest from './manifest';
+export * as HarmonyResources from './resources';
+export type { HarmonyAbility, HarmonyExtensionAbility, HarmonyMetadata, HarmonyModule, HarmonyModuleJson } from './manifest';
+export type { HarmonyResourceFile, HarmonyResourceItem } from './resources';
+export { withHarmonyGeneratedFiles, withRawfile } from './generatedFiles';
+export type { HarmonyFileDescriptor, HarmonyFileMap, HarmonyGeneratedFilesOptions } from './generatedFiles';
+export { HarmonyPermissions, withHarmonyPermissions } from './permissions';

package/build/index.js

@@ -1,15 +1,57 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HarmonyPaths = exports.registerHarmonyConfigPlugin = exports.normalizeHarmonyConfigPlugins = exports.getHarmonyConfigPlugins = exports.withWorker = exports.withStrings = exports.withRootOhPackage = exports.withRootHvigor = exports.withReactNativeConfig = exports.withProjectBuildProfile = exports.withProfiles = exports.withNativeInputsStamp = exports.withModuleJson = exports.withMedia = exports.withIndexPage = exports.withHvigorConfig = exports.withHarmonyResources = exports.withHarmonyMod = exports.withHarmonyDangerousMod = exports.withHarmonyBaseMods = exports.withHarmonyAutolinking = exports.withEntryOhPackage = exports.withEntryHvigor = exports.withEntryBuildProfile = exports.withEntryAbility = exports.withCppPackageProvider = exports.withColors = exports.withCngManifest = exports.withCMakeLists = exports.withArkTSPackageProvider = exports.withAppJson = exports.recordManagedFile = exports.HARMONY_MOD_NAMES = exports.normalizeHarmonyConfig = exports.HarmonySdkVersions = exports.stableHarmonyJson = exports.atomicWrite = exports.HarmonyConfigPluginError = exports.defineExpoHarmonyConfig = void 0;
+exports.withHarmonyPermissions = exports.HarmonyPermissions = exports.withRawfile = exports.withHarmonyGeneratedFiles = exports.HarmonyResources = exports.HarmonyManifest = exports.HarmonyPaths = exports.registerHarmonyConfigPlugin = exports.withWorker = exports.withStrings = exports.withRootOhPackage = exports.withRootHvigor = exports.withReactNativeConfig = exports.withProjectBuildProfile = exports.withProfiles = exports.withModuleJson = exports.withMedia = exports.withIndexPage = exports.withHvigorConfig = exports.withHarmonyResources = exports.withHarmonyMod = exports.withHarmonyDangerousMod = exports.withHarmonyBaseMods = exports.withHarmonyAutolinking = exports.withEntryOhPackage = exports.withEntryHvigor = exports.withEntryBuildProfile = exports.withEntryAbility = exports.withCppPackageProvider = exports.withColors = exports.withCMakeLists = exports.withArkTSPackageProvider = exports.withAppJson = exports.recordManagedFile = exports.HARMONY_MOD_NAMES = exports.normalizeHarmonyConfig = exports.stableHarmonyJson = exports.atomicWrite = exports.HarmonyConfigPluginError = exports.withHarmonyJsonFile = exports.createHarmonyFileMod = exports.compileHarmonyModsAsync = exports.withStaticPlugin = exports.withRunOnce = exports.withPlugins = exports.createRunOncePlugin = exports.defineExpoHarmonyConfig = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "defineExpoHarmonyConfig", { enumerable: true, get: function () { return config_1.defineExpoHarmonyConfig; } });
+var composition_1 = require("./composition");
+Object.defineProperty(exports, "createRunOncePlugin", { enumerable: true, get: function () { return composition_1.createRunOncePlugin; } });
+Object.defineProperty(exports, "withPlugins", { enumerable: true, get: function () { return composition_1.withPlugins; } });
+Object.defineProperty(exports, "withRunOnce", { enumerable: true, get: function () { return composition_1.withRunOnce; } });
+Object.defineProperty(exports, "withStaticPlugin", { enumerable: true, get: function () { return composition_1.withStaticPlugin; } });
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileHarmonyModsAsync", { enumerable: true, get: function () { return compiler_1.compileHarmonyModsAsync; } });
+var customFiles_1 = require("./customFiles");
+Object.defineProperty(exports, "createHarmonyFileMod", { enumerable: true, get: function () { return customFiles_1.createHarmonyFileMod; } });
+Object.defineProperty(exports, "withHarmonyJsonFile", { enumerable: true, get: function () { return customFiles_1.withHarmonyJsonFile; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "HarmonyConfigPluginError", { enumerable: true, get: function () { return errors_1.HarmonyConfigPluginError; } });
 var files_1 = require("./files");
 Object.defineProperty(exports, "atomicWrite", { enumerable: true, get: function () { return files_1.atomicWrite; } });
 Object.defineProperty(exports, "stableHarmonyJson", { enumerable: true, get: function () { return files_1.stableJson; } });
 var normalizeConfig_1 = require("./normalizeConfig");
-Object.defineProperty(exports, "HarmonySdkVersions", { enumerable: true, get: function () { return normalizeConfig_1.HarmonySdkVersions; } });
 Object.defineProperty(exports, "normalizeHarmonyConfig", { enumerable: true, get: function () { return normalizeConfig_1.normalizeHarmonyConfig; } });
 var mods_1 = require("./mods");
 Object.defineProperty(exports, "HARMONY_MOD_NAMES", { enumerable: true, get: function () { return mods_1.HarmonyModNames; } });
@@ -17,7 +59,6 @@ Object.defineProperty(exports, "recordManagedFile", { enumerable: true, get: fun
 Object.defineProperty(exports, "withAppJson", { enumerable: true, get: function () { return mods_1.withAppJson; } });
 Object.defineProperty(exports, "withArkTSPackageProvider", { enumerable: true, get: function () { return mods_1.withArkTSPackageProvider; } });
 Object.defineProperty(exports, "withCMakeLists", { enumerable: true, get: function () { return mods_1.withCMakeLists; } });
-Object.defineProperty(exports, "withCngManifest", { enumerable: true, get: function () { return mods_1.withCngManifest; } });
 Object.defineProperty(exports, "withColors", { enumerable: true, get: function () { return mods_1.withColors; } });
 Object.defineProperty(exports, "withCppPackageProvider", { enumerable: true, get: function () { return mods_1.withCppPackageProvider; } });
 Object.defineProperty(exports, "withEntryAbility", { enumerable: true, get: function () { return mods_1.withEntryAbility; } });
@@ -33,7 +74,6 @@ Object.defineProperty(exports, "withHvigorConfig", { enumerable: true, get: func
 Object.defineProperty(exports, "withIndexPage", { enumerable: true, get: function () { return mods_1.withIndexPage; } });
 Object.defineProperty(exports, "withMedia", { enumerable: true, get: function () { return mods_1.withMedia; } });
 Object.defineProperty(exports, "withModuleJson", { enumerable: true, get: function () { return mods_1.withModuleJson; } });
-Object.defineProperty(exports, "withNativeInputsStamp", { enumerable: true, get: function () { return mods_1.withNativeInputsStamp; } });
 Object.defineProperty(exports, "withProfiles", { enumerable: true, get: function () { return mods_1.withProfiles; } });
 Object.defineProperty(exports, "withProjectBuildProfile", { enumerable: true, get: function () { return mods_1.withProjectBuildProfile; } });
 Object.defineProperty(exports, "withReactNativeConfig", { enumerable: true, get: function () { return mods_1.withReactNativeConfig; } });
@@ -42,8 +82,14 @@ Object.defineProperty(exports, "withRootOhPackage", { enumerable: true, get: fun
 Object.defineProperty(exports, "withStrings", { enumerable: true, get: function () { return mods_1.withStrings; } });
 Object.defineProperty(exports, "withWorker", { enumerable: true, get: function () { return mods_1.withWorker; } });
 var ownership_1 = require("./ownership");
-Object.defineProperty(exports, "getHarmonyConfigPlugins", { enumerable: true, get: function () { return ownership_1.getHarmonyConfigPlugins; } });
-Object.defineProperty(exports, "normalizeHarmonyConfigPlugins", { enumerable: true, get: function () { return ownership_1.normalizeHarmonyConfigPlugins; } });
 Object.defineProperty(exports, "registerHarmonyConfigPlugin", { enumerable: true, get: function () { return ownership_1.registerHarmonyConfigPlugin; } });
 var paths_1 = require("./paths");
 Object.defineProperty(exports, "HarmonyPaths", { enumerable: true, get: function () { return paths_1.HarmonyPaths; } });
+exports.HarmonyManifest = __importStar(require("./manifest"));
+exports.HarmonyResources = __importStar(require("./resources"));
+var generatedFiles_1 = require("./generatedFiles");
+Object.defineProperty(exports, "withHarmonyGeneratedFiles", { enumerable: true, get: function () { return generatedFiles_1.withHarmonyGeneratedFiles; } });
+Object.defineProperty(exports, "withRawfile", { enumerable: true, get: function () { return generatedFiles_1.withRawfile; } });
+var permissions_1 = require("./permissions");
+Object.defineProperty(exports, "HarmonyPermissions", { enumerable: true, get: function () { return permissions_1.HarmonyPermissions; } });
+Object.defineProperty(exports, "withHarmonyPermissions", { enumerable: true, get: function () { return permissions_1.withHarmonyPermissions; } });

package/build/internal.d.ts

@@ -0,0 +1,3 @@
+export { getHarmonyConfigPlugins, normalizeHarmonyConfigPlugins } from './ownership';
+export { withCngManifest, withNativeInputsStamp, withPreparation, withProjectPatch } from './mods';
+export { NativeInputsStampPath } from './paths';

package/build/internal.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeInputsStampPath = exports.withProjectPatch = exports.withPreparation = exports.withNativeInputsStamp = exports.withCngManifest = exports.normalizeHarmonyConfigPlugins = exports.getHarmonyConfigPlugins = void 0;
+var ownership_1 = require("./ownership");
+Object.defineProperty(exports, "getHarmonyConfigPlugins", { enumerable: true, get: function () { return ownership_1.getHarmonyConfigPlugins; } });
+Object.defineProperty(exports, "normalizeHarmonyConfigPlugins", { enumerable: true, get: function () { return ownership_1.normalizeHarmonyConfigPlugins; } });
+var mods_1 = require("./mods");
+Object.defineProperty(exports, "withCngManifest", { enumerable: true, get: function () { return mods_1.withCngManifest; } });
+Object.defineProperty(exports, "withNativeInputsStamp", { enumerable: true, get: function () { return mods_1.withNativeInputsStamp; } });
+Object.defineProperty(exports, "withPreparation", { enumerable: true, get: function () { return mods_1.withPreparation; } });
+Object.defineProperty(exports, "withProjectPatch", { enumerable: true, get: function () { return mods_1.withProjectPatch; } });
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "NativeInputsStampPath", { enumerable: true, get: function () { return paths_1.NativeInputsStampPath; } });

package/build/manifest.d.ts

@@ -0,0 +1,38 @@
+import type { HarmonyPermission, HarmonySkill } from './config';
+export interface HarmonyMetadata extends Record<string, unknown> {
+    name: string;
+    value?: string;
+    resource?: string;
+}
+export interface HarmonyAbility extends Record<string, unknown> {
+    name: string;
+    srcEntry?: string;
+    exported?: boolean;
+    skills?: HarmonySkill[];
+    backgroundModes?: string[];
+    metadata?: HarmonyMetadata[];
+}
+export interface HarmonyExtensionAbility extends HarmonyAbility {
+    type: string;
+}
+export interface HarmonyModule extends Record<string, unknown> {
+    name?: string;
+    mainElement?: string;
+    abilities?: HarmonyAbility[];
+    extensionAbilities?: HarmonyExtensionAbility[];
+    metadata?: HarmonyMetadata[];
+    requestPermissions?: HarmonyPermission[];
+    querySchemes?: string[];
+}
+export interface HarmonyModuleJson extends Record<string, unknown> {
+    module?: HarmonyModule;
+}
+export declare function getModuleOrThrow(manifest: HarmonyModuleJson): HarmonyModule;
+export declare function getMainAbilityOrThrow(manifest: HarmonyModuleJson, name?: string): HarmonyAbility;
+export declare function setMetadata(target: {
+    metadata?: HarmonyMetadata[];
+}, item: HarmonyMetadata): void;
+export declare function removeMetadata(target: {
+    metadata?: HarmonyMetadata[];
+}, name: string): void;
+export declare function ensureExtensionAbility(manifest: HarmonyModuleJson, ability: HarmonyExtensionAbility): void;

package/build/manifest.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModuleOrThrow = getModuleOrThrow;
+exports.getMainAbilityOrThrow = getMainAbilityOrThrow;
+exports.setMetadata = setMetadata;
+exports.removeMetadata = removeMetadata;
+exports.ensureExtensionAbility = ensureExtensionAbility;
+const errors_1 = require("./errors");
+const files_1 = require("./files");
+function getModuleOrThrow(manifest) {
+    const module = manifest.module;
+    if (!module || typeof module !== 'object' || Array.isArray(module)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'Harmony module.json5 must contain a module object.', { operation: 'edit-manifest' });
+    }
+    return module;
+}
+function getMainAbilityOrThrow(manifest, name) {
+    const module = getModuleOrThrow(manifest);
+    const abilities = module.abilities;
+    if (!Array.isArray(abilities)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'Harmony module.json5 must declare an abilities array.', { operation: 'edit-manifest' });
+    }
+    const selected = name ?? module.mainElement ?? abilities[0]?.name;
+    const matches = abilities.filter(ability => ability && typeof ability.name === 'string' && ability.name === selected);
+    if (matches.length !== 1) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', `Expected exactly one Harmony Ability '${selected ?? ''}', found ${matches.length}.`, { operation: 'edit-manifest' });
+    }
+    return matches[0];
+}
+function setMetadata(target, item) {
+    if (!item || typeof item.name !== 'string' || !item.name.trim()) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'Metadata must have a non-empty name.', { operation: 'edit-manifest' });
+    }
+    if (target.metadata !== undefined && !Array.isArray(target.metadata)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'metadata must be an array.', { operation: 'edit-manifest' });
+    }
+    const items = target.metadata ?? [];
+    const existing = items.find(value => value?.name === item.name);
+    target.metadata = [...items.filter(value => value?.name !== item.name), { ...existing, ...item }];
+}
+function removeMetadata(target, name) {
+    if (target.metadata !== undefined && !Array.isArray(target.metadata)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'metadata must be an array.', { operation: 'edit-manifest' });
+    }
+    if (target.metadata)
+        target.metadata = target.metadata.filter(item => item?.name !== name);
+}
+function ensureExtensionAbility(manifest, ability) {
+    if (!ability || typeof ability.name !== 'string' || !ability.name.trim()
+        || typeof ability.type !== 'string' || !ability.type.trim()) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'An extension Ability must have a non-empty name and type.', { operation: 'edit-manifest' });
+    }
+    const module = getModuleOrThrow(manifest);
+    if (module.extensionAbilities !== undefined && !Array.isArray(module.extensionAbilities)) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', 'module.extensionAbilities must be an array.', { operation: 'edit-manifest' });
+    }
+    const abilities = module.extensionAbilities ?? [];
+    const matches = abilities.filter(value => value?.name === ability.name);
+    if (matches.length > 1) {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', `Harmony module declares ${ability.name} more than once.`, { operation: 'edit-manifest' });
+    }
+    if (matches.length === 1) {
+        for (const [key, value] of Object.entries(ability)) {
+            if ((0, files_1.stableJson)(matches[0][key]) !== (0, files_1.stableJson)(value)) {
+                throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_MANIFEST_INVALID', `Harmony extension Ability '${ability.name}' has an incompatible ${key}.`, { operation: 'edit-manifest' });
+            }
+        }
+        return;
+    }
+    module.extensionAbilities = [...abilities, structuredClone(ability)];
+}

package/build/mods.d.ts

@@ -0,0 +1,57 @@
+import type { ExpoConfig } from '@expo/config-types';
+import type { ExpoConfigWithHarmony } from './config';
+import type { HarmonyModuleJson } from './manifest';
+import type { HarmonyConfigPlugin, HarmonyModAction } from './pluginTypes';
+import type { HarmonyResourceFile } from './resources';
+export type HarmonyModName = 'dangerous' | 'reactNativeConfig' | 'appJson' | 'projectBuildProfile' | 'rootOhPackage' | 'rootHvigor' | 'hvigorConfig' | 'entryBuildProfile' | 'entryOhPackage' | 'entryHvigor' | 'moduleJson' | 'strings' | 'colors' | 'media' | 'profiles' | 'entryAbility' | 'indexPage' | 'worker' | 'arktsPackageProvider' | 'cppPackageProvider' | 'cmakeLists' | 'autolinking';
+export type HarmonyJson = Record<string, unknown>;
+export type HarmonyResourceMap = Record<string, HarmonyResourceFile>;
+export type HarmonyMediaDescriptor = {
+    source: string;
+    content?: never;
+    replaceBase?: boolean;
+} | {
+    source?: never;
+    content: string | Uint8Array;
+    replaceBase?: boolean;
+};
+export type HarmonyMediaMap = Record<string, Record<string, HarmonyMediaDescriptor>>;
+interface ManagedConfig {
+    _internal?: ExpoConfig['_internal'];
+    modRequest: {
+        projectRoot: string;
+    };
+}
+export declare const HarmonyModNames: readonly HarmonyModName[];
+export declare function recordManagedFile(config: ManagedConfig, file: string, owner: string): void;
+export declare function withHarmonyBaseMods<Config extends ExpoConfigWithHarmony>(config: Config): Config;
+export declare function withHarmonyMod<T = unknown, Config extends ExpoConfigWithHarmony = ExpoConfigWithHarmony>(config: Config, tuple: [HarmonyModName, HarmonyModAction<T>]): Config;
+export declare function registerMod<T, Config extends ExpoConfigWithHarmony>(config: Config, name: string, action: HarmonyModAction<T>): Config;
+export declare const withReactNativeConfig: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withAppJson: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withProjectBuildProfile: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withRootOhPackage: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withRootHvigor: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withNativeInputsStamp: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withHvigorConfig: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withEntryBuildProfile: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withEntryOhPackage: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withEntryHvigor: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withModuleJson: HarmonyConfigPlugin<HarmonyModAction<HarmonyModuleJson>>;
+export declare const withStrings: HarmonyConfigPlugin<HarmonyModAction<HarmonyResourceMap>>;
+export declare const withColors: HarmonyConfigPlugin<HarmonyModAction<HarmonyResourceMap>>;
+export declare const withMedia: HarmonyConfigPlugin<HarmonyModAction<HarmonyMediaMap>>;
+export declare const withProfiles: HarmonyConfigPlugin<HarmonyModAction<HarmonyJson>>;
+export declare const withEntryAbility: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withIndexPage: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withWorker: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withArkTSPackageProvider: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withCppPackageProvider: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withCMakeLists: HarmonyConfigPlugin<HarmonyModAction<string>>;
+export declare const withHarmonyAutolinking: HarmonyConfigPlugin<HarmonyModAction<null>>;
+export declare const withCngManifest: HarmonyConfigPlugin<HarmonyModAction<null>>;
+export declare const withPreparation: HarmonyConfigPlugin<HarmonyModAction<null>>;
+export declare const withProjectPatch: HarmonyConfigPlugin<HarmonyModAction<null>>;
+export declare const withHarmonyDangerousMod: HarmonyConfigPlugin<HarmonyModAction<null>>;
+export declare const withHarmonyResources: HarmonyConfigPlugin<HarmonyModAction<unknown>>;
+export {};