@qwik-custom-elements/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dmitry A. Efimenko
+
+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,82 @@
+# @qwik-custom-elements/core
+
+Deterministic generation orchestration for Qwik custom-element wrappers.
+
+## Install
+
+```
+npm install @qwik-custom-elements/core
+```
+
+## Quickstart
+
+Create a `qwik-custom-elements.config.json` at your project root:
+
+```json
+{
+  "projects": [
+    {
+      "id": "my-lib",
+      "adapter": "stencil",
+      "adapterPackage": "@qwik-custom-elements/adapter-stencil",
+      "source": {
+        "type": "PACKAGE_NAME",
+        "packageName": "my-stencil-lib"
+      },
+      "outDir": "./src/generated/my-lib"
+    }
+  ]
+}
+```
+
+Then run the generator:
+
+```
+npx qwik-custom-elements
+```
+
+Generated Qwik wrapper files are written to the configured `outDir`. Re-run after upgrading the component library to regenerate.
+
+## Support Policy
+
+This package follows semantic versioning. See [COMPATIBILITY.md](../../COMPATIBILITY.md) for the tested combinations of core, adapters, Qwik, and Node.js.
+
+Breaking changes always include an explicit `BREAKING` section in the release notes and require an update to `COMPATIBILITY.md` before merging.
+
+## Ownership Boundary
+
+`@qwik-custom-elements/core` owns the adapter-agnostic parts of generation:
+
+- config loading and validation
+- source discovery and path-safety checks
+- CEM parsing into typed component metadata
+- runtime-resolution orchestration and SSR capability coordination
+- write planning and execution orchestration
+- CLI entrypoints, summaries, and deterministic diagnostics
+
+`@qwik-custom-elements/core` does not own framework-specific generated output shape.
+
+In particular, core must not decide generated wrapper structure, generated barrel structure, runtime helper file shape, file extensions, or fallback wrapper generation based on adapter identity. Those responsibilities belong to adapters.
+
+## Current Exports
+
+This package currently exports:
+
+- CLI helpers: `parseCliArgs`, `runCli`
+- config APIs: `loadGeneratorConfig`, `validateGeneratorConfig`, `ConfigValidationError`
+- generation APIs: `generateFromConfig`, `GenerationError`
+- public types for config, generation results, planned writes, and run summaries
+
+## Adapter Contract Direction
+
+Core is responsible for producing one authoritative parsed component-metadata model and passing that metadata into adapter generation hooks.
+
+Adapters are responsible for returning the generated file set for their frameworks.
+
+## Documentation Expectations
+
+Changes that alter core or adapter ownership boundaries should be reflected in:
+
+- `docs/SYSTEM/decisions.md`
+- `docs/SYSTEM/findings-log.md`
+- the package README files for any affected packages

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1 @@
+export {};