{"ref":"artifact:mpah-enum-value-help","page":"/artifacts/mpah-enum-value-help","json":"/artifacts/mpah-enum-value-help.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"mpah-enum-value-help","name":"@mpah/enum-value-help","artifact_type":"cds-plugin","ecosystem":"cap","domain":"ui-and-frontend-bridge","origin_ring":"independent","description":{"one_line":"A CAP plugin that generates value help for enum fields from an @enumValueHelp annotation, serving the enum's values from one generated entity instead of hand-written OData annotations.","short":"CAP plugin generating value help for enum fields from an annotation","what_it_solves":"An enum in a CDS model compiles to a set of allowed values and nothing else: a Fiori elements field bound to one renders as a free-text input until somebody writes a @Common.ValueList pointing at an entity that holds those values. This plugin writes that annotation instead. During model loading it scans for fields marked @enumValueHelp, creates a single EnumValueHelpView entity, exposes it to the services that contain an annotated entity, and serves the enum's values from it by entity and field; @enumValueHelpFixedValues adds @Common.ValueListWithFixedValues as well, which is what makes the control a dropdown rather than a search popup. It stops at values the CDS type already declares — an enum whose texts live in a database table or a translation bundle is not what it reads."},"links":{"npm":"https://www.npmjs.com/package/@mpah/enum-value-help","repo":"https://github.com/mpah/enum-value-help"},"identity":{"author":"Maksim Pahlberg","license":"Apache-2.0"},"compat":{"runtimes":["node"],"cds_range":">=8"},"type_properties":{"distribution":{"value":["npm"],"sources":[{"url":"https://github.com/mpah/enum-value-help","title":"@mpah/enum-value-help — README","checked":"2026-10-18","quote":"npm install @mpah/enum-value-help"}]}},"provenance":{"discovered_via":[{"source":"source:discover","channel":"npm"}],"first_seen":"2026-09-18"},"provides":[{"capability":"capability:fiori-annotations","what_it_does":"Injects the Fiori value-help vocabulary for enum fields: @Common.ValueList on each field marked @enumValueHelp, pointing at a generated EnumValueHelpView that serves the enum's own values, and @Common.ValueListWithFixedValues in addition where the field is marked @enumValueHelpFixedValues.","sources":[{"url":"https://github.com/mpah/enum-value-help","title":"mpah/enum-value-help — README","checked":"2026-09-18","quote":"Automatically adds @Common.ValueList annotations pointing to the EnumValueHelpView"},{"url":"https://registry.npmjs.org/@mpah%2Fenum-value-help","title":"@mpah/enum-value-help — npm registry record","checked":"2026-09-18","quote":"CAP CDS plugin that automatically generates value help functionality for enum fields in your CDS models"}]}],"drafted_with_ai":true,"maintainers":["actor:mpah"],"contributors":["actor:mpah"]},"effective_normative_relations":[{"instrument":"instrument:sap-developer-license-3-2-cap","relation":"use-constrained-by","sections":["1","2","3"],"applies_when":"A cds-plugin is used with SAP CAP materials, or an artifact is explicitly identified as a CAP plugin or application.","note":"This is inherited applicability, not a licence verdict about the artifact itself. Review the agreement for the actual materials and use; an explicit artifact relationship to another revision takes precedence.","scope":{"kind":"artifact"},"sources":[{"url":"https://cap.cloud.sap/resources/license/developer-license-3_2_CAP.txt","title":"SAP Developer License Agreement 3.2 CAP","checked":"2026-09-16","quote":"documentation, plug-ins, templates, scripts and sample code, libraries, software development kits"}],"inherited_from":"cap-plugins-and-applications","relevant_capabilities":["agent-systems-access","async-processing","data-import-export","database-connectors","deployment","destinations","llm-integration","mcp-servers","plugin-authoring","replication","retrieval-augmented-generation","rfc-connectivity"]}],"readings":{"liveness":[{"label":"Maintenance","tier":"poor","evidence":"15 months since release"},{"label":"Continuity","tier":"fair","evidence":"one contributor, personally owned"},{"label":"Repository","tier":"fair","evidence":"pushed 2025-07, not archived"}],"compatibility":[{"label":"Declared for","tier":"good","evidence":">=8 — includes cds 10 and 9"},{"label":"Survived majors","tier":"poor","evidence":"no release since @sap/cds 10 shipped (July 2026)"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"poor","evidence":"none found in the tree"},{"label":"Docs","tier":"fair","evidence":"README 3 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":5,"unit":"installs/week"},{"value":1,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","latest_version":"1.0.0","majors":{"1":{"version":"1.0.0","date":"2025-07-26"}},"license":"Apache-2.0","first_release":"2025-07-26","last_release":"2025-07-26","releases":1,"cadence_days":null,"maintainers":1,"repository":"git+https://github.com/mpah/enum-value-help.git","repository_directory":null,"peer_cds":">=8","dependencies":0,"node_engine":">=18.0.0","test_script":false,"types":false,"downloads_weekly":5,"downloads_monthly":25,"stars":1,"forks":0,"open_issues":0,"archived":false,"pushed_at":"2025-07-26","license_spdx":"Apache-2.0","org_owned":false,"default_branch":"main","created_at":"2025-07-26T20:53:57Z","open_prs":0,"tree_truncated":false,"test_files":0,"workflows":0,"other_ci":false,"readme_bytes":2782,"docs_files":0,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2025-07-26","last_commit":"2025-07-26","commits":4,"contributors":1,"readme_path":"README.md","readme_sha":"ff02aba7bae44c8fedeb7d65db9a6e9f199ac534","months_since_release":15,"dormant":true,"repo_read":"2026-10-26"},"release_notes":{"license":"Apache-2.0","quotable":true,"versions":[{"version":"1.0.0","date":"2025-07-26"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:mpah","name":"Maksim Pahlberg","json":"/actors/mpah.json"}],"contributors":[{"ref":"actor:mpah","name":"Maksim Pahlberg","json":"/actors/mpah.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}