@ts-for-gir/lib/src/injections/shell.ts

Typescript .d.ts generator from GIR for gjs

import type { IntrospectedNamespace } from "../gir/namespace.ts";
import type { NSRegistry } from "../gir/registry.ts";
import { makeUnion, NullType, TypeIdentifier } from "../gir.ts";

const shellTemplate = (version: string) => ({
	namespace: "Shell",
	version,
	modifier(namespace: IntrospectedNamespace, _registry: NSRegistry) {
		// Get the GLSLEffect class which contains the add_glsl_snippet method
		const GLSLEffect = namespace.assertClass("GLSLEffect");

		// Find the add_glsl_snippet method
		const addGlslSnippet = GLSLEffect.members.find((m) => m.name === "add_glsl_snippet");

		// Change
		// ```ts
		// add_glsl_snippet(hook: SnippetHook | null, declarations: string, code: string, is_replace: boolean): void;
		// ```
		// to
		// ```ts
		// add_glsl_snippet(hook: SnippetHook | Cogl.SnippetHook | null, declarations: string, code: string, is_replace: boolean): void;
		// ```

		if (addGlslSnippet) {
			// Create a new parameter with updated type using copy()
			const updatedParameter = addGlslSnippet.parameters[0].copy({
				type: makeUnion(
					new TypeIdentifier("SnippetHook", "Shell"),
					new TypeIdentifier("SnippetHook", "Cogl"),
					NullType,
				),
			});

			// Replace the original parameter
			addGlslSnippet.parameters[0] = updatedParameter;
		}
	},
});

/** Shell 14 was introduced with GNOME 46 */
export const shell14 = shellTemplate("14");
/** Shell 15 was introduced with GNOME 47 */
export const shell15 = shellTemplate("15");
/** Shell 16 was introduced with GNOME 48 */
export const shell16 = shellTemplate("16");
/** Shell 17 was introduced with GNOME 49 */
export const shell17 = shellTemplate("17");
/** Shell 18 was introduced with GNOME 50 */
export const shell18 = shellTemplate("18");
// Possibly future versions, adjust if necessary
export const shell19 = shellTemplate("19");
export const shell20 = shellTemplate("20");