@vyriy/package 0.1.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vyriy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @vyriy/package
+
+Helpers for reading and caching `package.json` in Vyriy projects.
+
+## Purpose
+
+This package provides a small helper for reading the project `package.json`.
+
+The file is read lazily:
+
+- the first call reads and parses `package.json`
+- the parsed result is cached
+- all next calls return the cached object
+
+## Install
+
+With npm:
+
+```bash
+npm install @vyriy/package
+```
+
+With Yarn:
+
+```bash
+yarn add @vyriy/package
+```
+
+## Usage
+
+```ts
+import { getPackage } from '@vyriy/package';
+
+const package = getPackage();
+
+console.log(package.name);
+console.log(package.version);
+```
+
+You can also narrow the fields you need:
+
+```ts
+import { getPackage } from '@vyriy/package';
+
+const { name, scripts } = getPackage();
+
+console.log(name);
+console.log(scripts?.build);
+```
+
+## API
+
+`getPackage()`
+
+- reads the root `package.json` file on first access
+- caches the parsed object
+- returns the cached `Package` object on later calls
+
+## Exported Types
+
+- `Package`

package/index.d.ts

@@ -0,0 +1,2 @@
+export * from './package.js';
+export type * from './types.js';

package/index.js

@@ -0,0 +1 @@
+export * from './package.js';

package/package.d.ts

@@ -0,0 +1,2 @@
+import type { GetPackage } from './types.js';
+export declare const getPackage: GetPackage;

package/package.js

@@ -0,0 +1,9 @@
+import { readFileSync } from 'node:fs';
+import { path } from '@vyriy/path';
+let packageJson;
+export const getPackage = () => {
+    if (!packageJson) {
+        packageJson = JSON.parse(readFileSync(path('package.json'), 'utf-8'));
+    }
+    return packageJson;
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@vyriy/package",
+  "version": "0.1.9",
+  "description": "Shared package.json helpers for Vyriy projects",
+  "type": "module",
+  "main": "./index.js",
+  "dependencies": {
+    "@vyriy/path": "0.1.9"
+  },
+  "license": "MIT",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./index": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./index.js": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./package": {
+      "types": "./package.d.ts",
+      "import": "./package.js",
+      "default": "./package.js"
+    },
+    "./package.js": {
+      "types": "./package.d.ts",
+      "import": "./package.js",
+      "default": "./package.js"
+    }
+  }
+}

package/types.d.ts

@@ -0,0 +1,19 @@
+export type Package = {
+    name: string;
+    version: string;
+    description: string;
+    private?: boolean;
+    type?: string;
+    main?: string;
+    types?: string;
+    packageManager?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    exports?: Record<string, unknown>;
+    engines?: Record<string, string>;
+    workspaces?: string[];
+    [key: string]: unknown;
+};
+export type GetPackage = () => Package;