{"_id":"@0xintuition/classifications","name":"@0xintuition/classifications","dist-tags":{"alpha":"0.1.0-alpha.0","latest":"0.1.0-alpha.0"},"versions":{"0.1.0-alpha.0":{"name":"@0xintuition/classifications","version":"0.1.0-alpha.0","description":"Canonical Intuition classification specs and atom data builders","private":false,"license":"MIT","type":"module","sideEffects":false,"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./package.json":"./package.json","./creation":{"types":"./dist/generated/creation/index.d.ts","import":"./dist/generated/creation/index.js"},"./creation/*":{"types":"./dist/generated/creation/*.d.ts","import":"./dist/generated/creation/*.js"},"./*":{"types":"./dist/generated/specs/*.d.ts","import":"./dist/generated/specs/*.js"}},"keywords":["intuition","classifications","json-ld","schema"],"repository":{"type":"git","url":"git+https://github.com/0xIntuition/packages.git","directory":"packages/classifications"},"bugs":{"url":"https://github.com/0xIntuition/packages/issues"},"homepage":"https://github.com/0xIntuition/packages/tree/main/packages/classifications#readme","publishConfig":{"access":"public","tag":"alpha"},"scripts":{"build":"node ../../scripts/clean-dist.mjs && tsc -p tsconfig.build.json && node ../../scripts/normalize-dist-imports.mjs","clean":"git clean -xdf .cache .turbo dist node_modules","creation-profiles:generate":"bun ../../scripts/generate-classification-creation-profiles.mjs","creation-profiles:check-generated":"node ../../scripts/check-classification-creation-profiles.mjs","dev":"tsc --watch","pack:dry-run":"bun run build && npm pack --ignore-scripts --dry-run --json","pack:release":"bun run build && node ../../scripts/pack-release.mjs","prepack":"bun run build","prepublishOnly":"bun run build && node ../../scripts/guard-direct-publish.mjs","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","ci":"biome check","lint":"biome lint","format":"biome format","check":"biome check","lint:write":"biome lint --write","format:write":"biome format --write","check:write":"biome check --write","check:unsafe:write":"biome check --write --unsafe"},"devDependencies":{"@0xintuition/predicates":"0.1.0-alpha.0","@0xintuition/schema-org":"0.1.0-alpha.0","typescript":"^5.9.3","vitest":"^4.0.16"},"_id":"@0xintuition/classifications@0.1.0-alpha.0","gitHead":"ddc3489f8fe6d70b089adb37f26b030be763538f","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-hExmqKtQiHBPvxBdW2Ed5FXCBS6xHYp9dwTzx6u8zAbZ4CqvzBHF9ScoVWAiZqU3Py3j4VEDsXdTR+oM5fbDfg==","shasum":"bd20fd34460c517c42bb4382231dd363bc917fe1","tarball":"https://registry.npmjs.org/@0xintuition/classifications/-/classifications-0.1.0-alpha.0.tgz","fileCount":249,"unpackedSize":1316394,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC9bJJrsM9//J9WnPPc4Hf+dWMxcTBoG+5bK78ETqGctgIgD14rDlJE1x0w8CKo7Ic/kUYMeze8vRvUu0OuMGynKLc="}]},"_npmUser":{"name":"jpbuilds","email":"jp@intuition.systems"},"directories":{},"maintainers":[{"name":"orbro","email":"wluedtke207@gmail.com"},{"name":"jojikun","email":"jojikun@intuition.systems"},{"name":"jpbuilds","email":"jp@intuition.systems"},{"name":"vitalsine","email":"vital@intuition.systems"},{"name":"intuition_kames","email":"kames@intuition.systems"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/classifications_0.1.0-alpha.0_1781558256980_0.6459545625737371"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-15T21:17:36.810Z","0.1.0-alpha.0":"2026-06-15T21:17:37.151Z","modified":"2026-06-15T21:17:37.468Z"},"maintainers":[{"name":"orbro","email":"wluedtke207@gmail.com"},{"name":"jojikun","email":"jojikun@intuition.systems"},{"name":"jpbuilds","email":"jp@intuition.systems"},{"name":"vitalsine","email":"vital@intuition.systems"},{"name":"intuition_kames","email":"kames@intuition.systems"}],"description":"Canonical Intuition classification specs and atom data builders","homepage":"https://github.com/0xIntuition/packages/tree/main/packages/classifications#readme","keywords":["intuition","classifications","json-ld","schema"],"repository":{"type":"git","url":"git+https://github.com/0xIntuition/packages.git","directory":"packages/classifications"},"bugs":{"url":"https://github.com/0xIntuition/packages/issues"},"license":"MIT","readme":"# @0xintuition/classifications\n\nCanonical classification specs and JSON-LD atom data builders for Intuition alpha packages.\n\nRuntime: ESM-only. This package does not publish CommonJS `require` entrypoints.\n\n## Install\n\n```bash\nbun add @0xintuition/classifications@alpha\n```\n\n## Usage\n\n```ts\nimport { buildAtomData, getClassification } from '@0xintuition/classifications'\n\nconst spec = getClassification('ethereum-account')\nconst atomData = buildAtomData('ethereum-account', {\n  address: '0x0000000000000000000000000000000000000001',\n})\n```\n\nEach classification separates recommended atom fields from recommended triple\nmetadata:\n\n```ts\nconst book = getClassification('book')\n\nbook?.schema\n// { context: 'https://schema.org/', type: 'Book' }\n\nbook?.fields.map((field) => field.schemaProperty)\n// ['name', 'author', 'isbn', 'sameAs']\n\nbook?.metadataPredicates\n// ['authoredBy', 'publisher', 'hasCategory', ...]\n```\n\n`schema` is a generic schema pointer. Today most public classifications point at\nschema.org, but the field is intentionally not named `schemaOrg` so other schema\nsources can be supported later. For schema.org-backed classifications,\n`schemaProperty` points at the canonical schema.org property name. It does not\ncopy inheritance or provenance into the classification; consumers can derive that\nfrom `@0xintuition/schema-org`.\n\n## Browser Creation UIs\n\nUse Creation Profiles for known frontend create flows. They are generated plain\ndata artifacts that compose the classification fields, schema property\nprovenance, metadata predicate matrix rows, and predicate IDs/labels without\nimporting the full schema.org registry at runtime:\n\n```ts\nimport { musicRecordingCreationProfile } from '@0xintuition/classifications/creation/music-recording'\n\nmusicRecordingCreationProfile.fields.map((field) => field.schema?.originType)\n// ['Thing', 'MusicRecording', 'MusicRecording', 'Thing']\n\nmusicRecordingCreationProfile.relationships.map(({ predicate }) => predicate.label)\n// ['by artist', 'in album', 'in playlist', 'has category', 'same as']\n```\n\nRoot registry helpers such as `getClassification(...)`,\n`getMetadataPredicateMatrixFor(...)`, and schema.org `getPropertiesFor(...)`\nremain the dynamic server/admin/explorer/build-time APIs. Prefer Creation\nProfiles in browser-hot paths when the create flow targets a known\nclassification.\n\nThe optional matrix layer adds object-target semantics for promoted metadata\npredicates without putting classification-specific relationships into\n`@0xintuition/predicates`:\n\n```ts\nimport { getMetadataPredicateRelation } from '@0xintuition/classifications'\n\ngetMetadataPredicateRelation('music-recording', 'inPlaylist')\n// {\n//   expectedObjects: [\n//     { kind: 'schema', context: 'https://schema.org/', type: 'MusicPlaylist' }\n//   ],\n//   schemaMappings: [\n//     { context: 'https://schema.org/', property: 'inPlaylist', match: 'exact' }\n//   ]\n// }\n```\n\nKnown classifications are also available as direct subpath imports:\n\n```ts\nimport { ethereumAccount } from '@0xintuition/classifications/ethereum-account'\n```\n\nEthereum and other Intuition-local classifications use immutable `https://schema.intuition.systems/v1/...` JSON-LD contexts and are gated on `schema.intuition.systems` resolving before publication.\n","readmeFilename":"README.md","_rev":"1-27ebf6eceb0fcb14b04e2eb14b6cae20"}