@mr.dj2u/library-registry 0.0.0

package/dist/types.d.ts

@@ -0,0 +1,169 @@
+export type LibraryItemKind = "component" | "animation" | "screen" | "flow" | "integration";
+export type LibrarySourceName = "mds" | "create-expo-app" | "create-expo-stack" | "nativewindui" | "swmansion";
+export type LibraryPlatform = "android" | "ios" | "web";
+export type LibraryStyling = "stylesheet" | "nativewind" | "nativewindui" | "uniwind" | "tamagui" | "restyle";
+export type LibraryNavigation = "expo-router" | "react-navigation";
+export type LibraryNavigationLayout = "stack" | "tabs" | "drawer+tabs";
+export type LibraryAppDirectory = "app" | "src/app" | "root" | "src";
+export type LibraryDependencyKind = "runtime" | "development";
+export type LibraryDependencyInstaller = "expo" | "package-manager";
+export type LibraryAssetEncoding = "utf8" | "binary";
+export type LibraryAssetRole = "source" | "route" | "support" | "static";
+export interface LibrarySource {
+    name: LibrarySourceName;
+    displayName: string;
+    version: string;
+    license: "MIT";
+    repository: string;
+    sourcePath?: string;
+}
+export interface LibraryExpoSdkCompatibility {
+    min?: number;
+    max?: number;
+}
+export interface LibraryCompatibility {
+    expoSdk?: LibraryExpoSdkCompatibility;
+    styling?: readonly LibraryStyling[];
+    navigation?: readonly LibraryNavigation[];
+    navigationLayout?: readonly LibraryNavigationLayout[];
+    platforms?: readonly LibraryPlatform[];
+    appDirectory?: readonly ("app" | "src/app")[];
+    aliases?: readonly string[];
+}
+export interface LibraryDependency {
+    name: string;
+    version: string;
+    kind: LibraryDependencyKind;
+    installer: LibraryDependencyInstaller;
+    platforms?: readonly LibraryPlatform[];
+}
+export interface LibraryAsset {
+    /** Package-relative path. Registry assets always live below `assets/`. */
+    path: string;
+    /** Project-relative path; supported tokens are documented by `LibraryProjectContext`. */
+    destination: string;
+    encoding: LibraryAssetEncoding;
+    role?: LibraryAssetRole;
+    /** Explicit content placeholders; callers replace these only when project context supplies a value. */
+    contentTokens?: readonly "__MDS_APP_NAME__"[];
+}
+export interface LibraryVariant {
+    id: string;
+    name: string;
+    description?: string;
+    compatibility?: LibraryCompatibility;
+    dependencies?: readonly LibraryDependency[];
+    composedItems?: readonly string[];
+    assets?: readonly LibraryAsset[];
+    integration?: readonly string[];
+}
+export interface LibraryIntegration {
+    summary: string;
+    instructions: readonly string[];
+    notes?: readonly string[];
+}
+export interface LibraryPreview {
+    description?: string;
+    assetPath?: string;
+    alt?: string;
+}
+export interface LibraryItem {
+    id: string;
+    name: string;
+    description: string;
+    kind: LibraryItemKind;
+    source: LibrarySource;
+    tags: readonly string[];
+    categories: readonly string[];
+    delivery: "source-copy";
+    compatibility: LibraryCompatibility;
+    dependencies: readonly LibraryDependency[];
+    composedItems: readonly string[];
+    relatedItems: readonly string[];
+    variants: readonly LibraryVariant[];
+    assets: readonly LibraryAsset[];
+    integration: LibraryIntegration;
+    preview?: LibraryPreview;
+}
+export interface LibraryItemSummary {
+    id: string;
+    name: string;
+    description: string;
+    kind: LibraryItemKind;
+    source: LibrarySource;
+    tags: readonly string[];
+    categories: readonly string[];
+    compatibility: LibraryCompatibility;
+    variants: readonly Pick<LibraryVariant, "id" | "name" | "description">[];
+}
+export interface LibraryProjectContext {
+    projectName?: string;
+    /** Expo SDK version such as `56`, `56.0.11`, `~56.0.11`, or `^56.0.11`. */
+    expoSdk?: string | number;
+    styling?: LibraryStyling;
+    /** Both discovered directory paths and MDS's legacy location labels are accepted. */
+    appDirectory?: LibraryAppDirectory;
+    navigation?: LibraryNavigation;
+    navigationLayout?: LibraryNavigationLayout;
+    platforms?: readonly LibraryPlatform[];
+    aliases?: Readonly<Record<string, string>>;
+    dependencies?: Readonly<Record<string, string>>;
+    /** Existing project-relative file paths. Used to surface preflight warnings. */
+    files?: readonly string[];
+    /** Defaults to `src/components`. Must be a safe project-relative path. */
+    componentsDirectory?: string;
+    /** Defaults to `src/features`. Must be a safe project-relative path. */
+    featuresDirectory?: string;
+}
+export interface LibraryFilter {
+    kind?: LibraryItemKind | readonly LibraryItemKind[];
+    source?: LibrarySourceName | readonly LibrarySourceName[];
+    tags?: readonly string[];
+    categories?: readonly string[];
+    compatibleWith?: LibraryProjectContext;
+}
+export interface LibraryResolveOptions {
+    variant?: string;
+}
+export type LibraryResolutionIssueSeverity = "info" | "warning" | "error";
+export type LibraryResolutionIssueCode = "unknown-item" | "unknown-variant" | "unsupported-expo-sdk" | "unsupported-styling" | "unsupported-navigation" | "unsupported-navigation-layout" | "unsupported-platform" | "unsupported-app-directory" | "missing-alias" | "missing-dependency" | "dependency-version-conflict" | "destination-collision" | "destination-exists" | "unsafe-destination";
+export interface LibraryResolutionIssue {
+    code: LibraryResolutionIssueCode;
+    severity: LibraryResolutionIssueSeverity;
+    message: string;
+    itemId: string;
+    path?: string;
+    dependency?: string;
+}
+export interface LibraryResolvedItem {
+    id: string;
+    variantId?: string;
+}
+export interface LibraryResolvedAsset extends LibraryAsset {
+    itemId: string;
+    variantId?: string;
+    /** Fully rendered, safe project-relative destination path. */
+    destination: string;
+}
+export interface LibraryResolution {
+    item: LibraryItem;
+    variant?: LibraryVariant;
+    compatible: boolean;
+    issues: LibraryResolutionIssue[];
+    /** Dependency-first, de-duplicated composition order. */
+    items: LibraryResolvedItem[];
+    assets: LibraryResolvedAsset[];
+    dependencies: LibraryDependency[];
+    integration: string[];
+}
+export interface LibraryCatalogValidationIssue {
+    code: "duplicate-id" | "invalid-id" | "invalid-asset-path" | "missing-asset" | "invalid-destination" | "unknown-composed-item" | "unknown-related-item" | "composition-cycle" | "duplicate-variant" | "invalid-variant-id" | "invalid-license" | "invalid-source" | "invalid-dependency";
+    message: string;
+    itemId?: string;
+    path?: string;
+}
+export interface LibraryCatalogValidationResult {
+    valid: boolean;
+    issues: LibraryCatalogValidationIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,6 @@
+import type { LibraryCatalogValidationResult, LibraryItem } from "./types.js";
+export declare function isSafeLibraryAssetPath(assetPath: string): boolean;
+export declare function isSafeLibraryDestination(destination: string): boolean;
+export declare function validateLibraryCatalog(items: readonly LibraryItem[]): LibraryCatalogValidationResult;
+export declare function assertValidLibraryCatalog(items: readonly LibraryItem[]): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,8BAA8B,EAC9B,WAAW,EACZ,MAAM,YAAY,CAAC;AAcpB,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAejE;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAsBrE;AAiCD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,8BAA8B,CAuIhC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAM7E"}

package/dist/validation.js

@@ -0,0 +1,209 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const ITEM_ID_PATTERN = /^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/;
+const VARIANT_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const DESTINATION_TOKENS = [
+    "{{appDir}}",
+    "{{componentsDir}}",
+    "{{featuresDir}}",
+];
+export function isSafeLibraryAssetPath(assetPath) {
+    if (!assetPath.startsWith("assets/") ||
+        assetPath.includes("\\") ||
+        assetPath.includes("\0")) {
+        return false;
+    }
+    if (path.posix.isAbsolute(assetPath) || /^[A-Za-z]:/.test(assetPath)) {
+        return false;
+    }
+    const segments = assetPath.split("/");
+    return segments.every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+export function isSafeLibraryDestination(destination) {
+    if (!destination ||
+        destination.includes("\\") ||
+        destination.includes("\0")) {
+        return false;
+    }
+    let rendered = destination;
+    for (const token of DESTINATION_TOKENS) {
+        rendered = rendered.split(token).join("registry-root");
+    }
+    if (/\{\{[^{}]+\}\}/.test(rendered)) {
+        return false;
+    }
+    if (path.posix.isAbsolute(rendered) || /^[A-Za-z]:/.test(rendered)) {
+        return false;
+    }
+    const segments = rendered.split("/");
+    return segments.every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+function validateAsset(item, value, issues) {
+    if (!isSafeLibraryAssetPath(value.path)) {
+        issues.push({
+            code: "invalid-asset-path",
+            itemId: item.id,
+            path: value.path,
+            message: `Asset path must remain below assets/: ${value.path}`,
+        });
+    }
+    else if (!existsSync(path.resolve(PACKAGE_ROOT, value.path))) {
+        issues.push({
+            code: "missing-asset",
+            itemId: item.id,
+            path: value.path,
+            message: `Bundled asset does not exist: ${value.path}`,
+        });
+    }
+    if (!isSafeLibraryDestination(value.destination)) {
+        issues.push({
+            code: "invalid-destination",
+            itemId: item.id,
+            path: value.destination,
+            message: `Destination must be a safe project-relative path: ${value.destination}`,
+        });
+    }
+}
+export function validateLibraryCatalog(items) {
+    const issues = [];
+    const byId = new Map();
+    for (const item of items) {
+        if (!ITEM_ID_PATTERN.test(item.id)) {
+            issues.push({
+                code: "invalid-id",
+                itemId: item.id,
+                message: `Invalid item id: ${item.id}`,
+            });
+        }
+        if (byId.has(item.id)) {
+            issues.push({
+                code: "duplicate-id",
+                itemId: item.id,
+                message: `Duplicate item id: ${item.id}`,
+            });
+        }
+        else {
+            byId.set(item.id, item);
+        }
+        if (item.source.license !== "MIT") {
+            issues.push({
+                code: "invalid-license",
+                itemId: item.id,
+                message: `${item.id} is not approved for source-copy redistribution.`,
+            });
+        }
+        if (!item.source.version.trim() ||
+            !item.source.repository.startsWith("https://") ||
+            !item.source.displayName.trim()) {
+            issues.push({
+                code: "invalid-source",
+                itemId: item.id,
+                message: `${item.id} must declare complete source provenance.`,
+            });
+        }
+        for (const dependency of item.dependencies) {
+            if (!dependency.name.trim() || !dependency.version.trim()) {
+                issues.push({
+                    code: "invalid-dependency",
+                    itemId: item.id,
+                    message: `${item.id} contains an incomplete dependency declaration.`,
+                });
+            }
+        }
+        for (const value of item.assets) {
+            validateAsset(item, value, issues);
+        }
+        const variantIds = new Set();
+        for (const variant of item.variants) {
+            if (!VARIANT_ID_PATTERN.test(variant.id)) {
+                issues.push({
+                    code: "invalid-variant-id",
+                    itemId: item.id,
+                    message: `Invalid variant id ${variant.id} on ${item.id}.`,
+                });
+            }
+            if (variantIds.has(variant.id)) {
+                issues.push({
+                    code: "duplicate-variant",
+                    itemId: item.id,
+                    message: `Duplicate variant ${variant.id} on ${item.id}.`,
+                });
+            }
+            variantIds.add(variant.id);
+            for (const dependency of variant.dependencies ?? []) {
+                if (!dependency.name.trim() || !dependency.version.trim()) {
+                    issues.push({
+                        code: "invalid-dependency",
+                        itemId: item.id,
+                        message: `${item.id}/${variant.id} contains an incomplete dependency declaration.`,
+                    });
+                }
+            }
+            for (const value of variant.assets ?? []) {
+                validateAsset(item, value, issues);
+            }
+        }
+    }
+    for (const item of items) {
+        for (const relatedId of item.relatedItems) {
+            if (!byId.has(relatedId)) {
+                issues.push({
+                    code: "unknown-related-item",
+                    itemId: item.id,
+                    message: `${item.id} references unknown related item ${relatedId}.`,
+                });
+            }
+        }
+        for (const composedId of [
+            ...item.composedItems,
+            ...item.variants.flatMap((variant) => variant.composedItems ?? []),
+        ]) {
+            if (!byId.has(composedId)) {
+                issues.push({
+                    code: "unknown-composed-item",
+                    itemId: item.id,
+                    message: `${item.id} composes unknown item ${composedId}.`,
+                });
+            }
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const findCycle = (itemId) => {
+        if (visiting.has(itemId)) {
+            issues.push({
+                code: "composition-cycle",
+                itemId,
+                message: `Composition cycle includes ${itemId}.`,
+            });
+            return;
+        }
+        if (visited.has(itemId))
+            return;
+        const item = byId.get(itemId);
+        if (!item)
+            return;
+        visiting.add(itemId);
+        const composedIds = [
+            ...item.composedItems,
+            ...item.variants.flatMap((variant) => variant.composedItems ?? []),
+        ];
+        for (const composedId of composedIds)
+            findCycle(composedId);
+        visiting.delete(itemId);
+        visited.add(itemId);
+    };
+    for (const item of items)
+        findCycle(item.id);
+    return { valid: issues.length === 0, issues };
+}
+export function assertValidLibraryCatalog(items) {
+    const result = validateLibraryCatalog(items);
+    if (!result.valid) {
+        const detail = result.issues.map((issue) => issue.message).join("\n");
+        throw new Error(`Invalid MDS Library catalog:\n${detail}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@mr.dj2u/library-registry",
+  "version": "0.0.0",
+  "description": "Typed source-copy registry for reusable Expo components, screens, flows, and integrations",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DavidJGrimsley/mrdj-dev-suite.git",
+    "directory": "packages/library-registry"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "THIRD_PARTY_NOTICES.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "test": "vitest run --passWithNoTests",
+    "prepack": "node ../../scripts/verify-publish-manifest.mjs .",
+    "dev": "tsc --watch",
+    "clean": "node -e \"const fs=require('node:fs'); for (const p of ['dist','tsconfig.tsbuildinfo']) fs.rmSync(p,{recursive:true,force:true});\""
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.9.0"
+  },
+  "keywords": [
+    "expo",
+    "react-native",
+    "components",
+    "registry",
+    "templates"
+  ],
+  "author": "DJ",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}