@_linked/cli 1.11.1 → 1.12.0

package/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## 1.12.0
+
+### Minor Changes
+
+- [#77](https://github.com/linked-cm/cli/pull/77) [`38cf9a7`](https://github.com/linked-cm/cli/commit/38cf9a77dbeab632e617846a51d75c41a6f6edda) Thanks [@flyon](https://github.com/flyon)! - Add `linked create-app <name> --template react-native`, which scaffolds a Linked React Native monorepo.
+
+  The template ships in the CLI as `defaults/app-react-native` and needs no git clone. It generates an npm
+  workspaces monorepo:
+
+  - `apps/mobile`: an Expo SDK 57 / React Native 0.86 / React 19.2 app, with its Metro and Jest configuration
+    already set up for `@_linked/*`, and render defaults that replace `@_linked/react`'s `<svg>` loader and error
+    elements. Tests cover shape registration and those defaults.
+  - `packages/<prefix>-shapes`: a Linked shapes package, consumed as TypeScript source.
+  - `services/api`: a backend stub.
+
+  The app's identity is stamped into named places only: the shapes package name, the monorepo name, and
+  `app.json` `name`, `slug` and the reverse-domain `ios.bundleIdentifier`. The `${…}` substitution the web template
+  uses is not applied, so template literals in the sources stay intact. Dependencies install with npm. `ios/` is
+  generated by `expo run:ios` and is not committed. `--template web` stays the default and is unchanged.
+
+  Before writing anything, the React Native path checks that `--app-prefix` matches `^[a-z][a-z0-9-]*$` (it becomes
+  a directory, an npm package name, a bundle-ID label and part of a Jest pattern) and refuses a target folder that
+  exists and is not empty. A failed `npm install` keeps the files but fails the command, and `create-app` exits
+  non-zero whenever it fails. The template pins `expo-dev-client` and `@react-native/jest-preset` explicitly, so it
+  does not depend on npm auto-installing peers.
+
+  Also fixes `linked create-package` when the CLI is installed from npm. npm honoured the template's nested
+  `.npmignore` when packing the CLI, so `defaults/package/src` was missing from the published tarball and new
+  packages had no `src/`. Yarn-packed builds were unaffected. The template now ships the file as
+  `npmignore.template`, and `create-package` renames it back. `.gitignore` files in templates get the same
+  treatment.
+
+### Patch Changes
+
+- [#77](https://github.com/linked-cm/cli/pull/77) [`32791fd`](https://github.com/linked-cm/cli/commit/32791fd80b3c2b8849a35dfa4483785b601cc8b2) Thanks [@flyon](https://github.com/flyon)! - Publish only what the CLI needs at runtime: a `files` allowlist (`lib`, `defaults`, README, CHANGELOG, LICENSE) keeps test fixtures, Playwright `test-results/` and `package-lock.json` out of the tarball.
+
+  Fix `linked create-package` failing at its final step. With Yarn 2+ the new package was installed with Plug'n'Play (no `node_modules`), so `npm exec linked build` could not find the binary. Scaffolded packages now get `nodeLinker: node-modules` under Yarn 2+, the initial build runs through the CLI that is already executing, and a failed install or build sets a non-zero exit code.
+
+## 1.11.2
+
+### Patch Changes
+
+- [#74](https://github.com/linked-cm/cli/pull/74) [`b6969b1`](https://github.com/linked-cm/cli/commit/b6969b174a7e0c571a318aff7b69c601d97f3e41) Thanks [@flyon](https://github.com/flyon)! - Make `linked create-package` produce a package that builds.
+
+  Four things stopped it, none of which the scaffolded output survived:
+
+  - The final step ran `npm exec lincd build`. `lincd` is the **old** CLI's binary, and its
+    compiled output imports `lincd/lib/esm/utils/LinkedFileStorage.js`, which the current
+    workspace does not ship. The result was `Could not install dependencies` and no build.
+    It now runs `linked build`.
+  - The template's `src/package.ts` destructured `linkedComponent` from `linkedPackage()`.
+    That is not part of core's `LinkedPackageObject` — component binding lives in
+    `@_linked/react` — so every new package failed to compile on its own boilerplate.
+  - The ontology template imported `NamedNode` from bare `@_linked/core`. The symbol no
+    longer exists there, and the bare specifier cannot resolve under the template's
+    `moduleResolution: "node"` anyway. It now uses `NodeReferenceValue`, matching how the
+    framework's own ontologies are written.
+  - `src/index.ts` had `import './types'` with no extension, which the CLI's own import check
+    rejects.
+
+  Verified by scaffolding a package and building it: ESM, CJS, dual-package output, import
+  check and dependency check all pass with no edits.
+
 ## 1.11.1
 
 ### Patch Changes

package/README.md

@@ -125,6 +125,54 @@ Conventions:
 - The backend dispatcher is registry-free (dynamic `await import(entry.store)`). The frontend hardcodes each `new StoreClass(config)` because webpack can't bundle dynamic imports of arbitrary npm specifiers.
 - Each store class accepts a single config-object constructor argument — `new FusekiStore({ endpoint, credentials? })`, `new BackendAPIStore({ name?, id? })`.
 
+### `linked create-app --template react-native`
+
+`linked create-app <name> --template react-native` (with the usual `--app-name`, `--app-prefix`, `--app-domain`,
+`--skip-install`) copies `defaults/app-react-native/` instead of cloning the web template. The result is an npm
+workspaces monorepo for Expo SDK 57 / React Native 0.86 / React 19.2:
+
+```
+<name>/
+  package.json              workspaces (enumerated) + overrides pinning @_linked/react's react to 19.2.3
+  .gitignore                node_modules/, packages/*, !packages/<prefix>-shapes/
+  apps/mobile/              Expo app: app.json, App.tsx, index.ts, metro.config.js, jest config in package.json
+    .gitignore              includes /ios and /android
+    src/shell/linkedDefaults.tsx   React Native loader/error defaults for @_linked/react
+    __tests__/              shapes.test.ts, linkedDefaults.test.tsx
+  packages/<prefix>-shapes/ Linked shapes package, TypeScript source, extensionless imports, no build step
+  services/api/             backend stub
+```
+
+What the scaffold does:
+
+- Refuses, before writing anything, a prefix that does not match `^[a-z][a-z0-9-]*$`, and a target folder that
+  exists and is not empty.
+- Renames `gitignore.template` files to `.gitignore`. npm strips real `.gitignore` files from the CLI tarball.
+- Renames `packages/app-shapes` to `packages/<prefix>-shapes`, and replaces the literal `app-shapes` token in
+  every text file.
+- Sets the root `name` to `<hyphen-name>-monorepo`, and `app.json` `expo.name`, `expo.slug` and
+  `expo.ios.bundleIdentifier`. The bundle ID is the reversed domain plus the prefix, e.g.
+  `com.formaestudios.formae`.
+- Never runs the `${…}` placeholder substitution, so template literals in the sources are left alone.
+- Installs with `npm install` (never Yarn) unless `--skip-install` is given. If the install fails, the files
+  stay and the command exits non-zero; run `npm install` in the folder to retry.
+
+`ios/` (and `android/`) are **generated, not committed**: `npx expo run:ios` (or `npx expo prebuild`) creates
+them from `app.json`, and `apps/mobile/.gitignore` ignores them.
+
+Quick commands in the generated app:
+
+```bash
+npm ls react                                    # exactly one react@19.2.3
+npm test -w apps/mobile                         # Jest: shape registration + render defaults
+cd apps/mobile && npx expo export --platform ios --output-dir /tmp/export   # Metro bundle check
+cd apps/mobile && npx expo run:ios              # build the dev client and run on the iOS Simulator
+```
+
+Tests for this template in this repo: `yarn test:unit` covers the scaffold offline. It scaffolds the fixture in
+`tests/fixtures/app-react-native-min` and the real template. `npm run test:template` builds nothing itself. It
+runs the built CLI with install, then the three checks above. It needs network and takes several minutes.
+
 ## Repository
 
 `linked-cm/cli` on GitHub. License: MPL-2.0.

package/defaults/app-react-native/README.md

@@ -0,0 +1,56 @@
+# Linked React Native monorepo
+
+An npm-workspaces monorepo for a [Linked](https://github.com/linked-cm) app on Expo SDK 57 / React Native 0.86 /
+React 19.2.
+
+```
+apps/mobile/          Expo app (continuous native generation: ios/ is generated, not committed)
+  src/shell/          app shell, including the React Native render defaults for @_linked/react
+  __tests__/          shape registration and render-default tests
+packages/app-shapes/  Linked shapes package, consumed as TypeScript source (no build step)
+services/api/         backend stub
+```
+
+## Run
+
+```bash
+npm install
+npm test -w apps/mobile          # Jest
+cd apps/mobile && npx expo run:ios   # generates ios/, builds a development build with expo-dev-client, starts Metro
+```
+
+`expo-dev-client` is a dependency of `apps/mobile`, so `expo run:ios` produces a custom dev client (not Expo Go),
+which is what native modules need.
+
+Requires Node `^22.13 || >=24`. iOS builds need macOS 26.2+ and Xcode 26.4+ with the iOS platform component
+installed.
+
+## Quick checks
+
+| Command | What it proves |
+|---|---|
+| `npm ls react` (root) | exactly one React 19.2.3 in the tree |
+| `npm test -w apps/mobile` | shapes register at runtime; Linked components render React Native elements while loading and on error |
+| `cd apps/mobile && npx expo export --platform ios --output-dir /tmp/export` | Metro resolves `@_linked/*` (including subpaths) and the workspace packages |
+
+## React Native specifics
+
+- **One React.** `@_linked/react` still declares a React 18 peer, so the root `package.json` `overrides` pins its
+  `react` to 19.2.3. Remove the override once the peer range is widened upstream. Do not use
+  `--legacy-peer-deps`: it would hide a duplicate React.
+- **Workspaces are enumerated**, never globbed, so foreign repositories checked out under `packages/` are not
+  adopted. `.gitignore` uses `packages/*` plus a negation per workspace package (`packages/` cannot be negated).
+- **Metro** (`apps/mobile/metro.config.js`) watches the workspace root and searches both `node_modules`
+  directories. It deliberately does **not** set `disableHierarchicalLookup`, which breaks npm's nested
+  dependencies (e.g. `expo-asset` under `expo`). `unstable_conditionNames` covers `require()` of `@_linked/*`
+  subpaths.
+- **Jest** maps `@_linked/*` to its ESM build with a scoped `moduleNameMapper`. A global
+  `customExportConditions` would break `@babel/runtime`. Add every workspace package to
+  `transformIgnorePatterns`.
+- **Render defaults.** `@_linked/react`'s built-in loader and error elements are `<svg>`, which crash on React
+  Native. `apps/mobile/src/shell/linkedDefaults.tsx` replaces them app-wide and must be the first import of
+  `App.tsx`. `__tests__/linkedDefaults.test.tsx` fails if the defaults are not applied.
+- **Shapes package imports are extensionless** (`./shapes/Example`, not `./shapes/Example.js`): Metro does not
+  map `.js` specifiers to `.ts` source. For the same reason the package is never built with `linked build`,
+  whose import check rejects extensionless imports.
+- **Decorators** work with the stock `babel-preset-expo`; no extra Babel plugin is needed.

package/defaults/app-react-native/apps/mobile/App.tsx

@@ -0,0 +1,26 @@
+// Must stay the first import: replaces @_linked/react's <svg> loader and error defaults app-wide.
+import './src/shell/linkedDefaults';
+
+import { StyleSheet, Text, View } from 'react-native';
+import { getShapeClass } from '@_linked/core/utils/ShapeClass';
+import { Example } from 'app-shapes';
+
+export default function App() {
+  const registered = getShapeClass(Example.shape.id) === Example;
+  return (
+    <View style={styles.container}>
+      {/* @linkedShape adds static packageName at runtime; it is not on the class type. */}
+      <Text>{(Example as any).packageName}</Text>
+      <Text>{registered ? 'shapes registered' : 'shapes not registered'}</Text>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#fff',
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+});

package/defaults/app-react-native/apps/mobile/__tests__/linkedDefaults.test.tsx

@@ -0,0 +1,65 @@
+// Asserts the cause of the React Native crash in @_linked/react's default loader and error
+// elements: they render DOM host elements (<svg>), which have no native view config.
+// Removing the import below must make both tests fail with Received: ["svg", ...].
+import '../src/shell/linkedDefaults';
+
+import { act, render, screen } from '@testing-library/react-native';
+import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';
+import { setQueryDispatch } from '@_linked/core/queries/queryDispatch';
+import { linkedComponent } from '@_linked/react';
+import { Text } from 'react-native';
+import { Example } from 'app-shapes';
+
+type Mode = 'loading' | 'error';
+let mode: Mode = 'loading';
+
+// A stub store: the query never settles while loading, and rejects in error mode.
+const stubStore: any = {
+  selectQuery: () =>
+    mode === 'loading' ? new Promise(() => {}) : Promise.reject(new Error('stub store: query failed')),
+  askQuery: async () => false,
+  createQuery: async () => ({}),
+  updateQuery: async () => ({}),
+  deleteQuery: async () => ({}),
+};
+LinkedStorage.setDefaultDataset(stubStore);
+setQueryDispatch(stubStore);
+
+const ExampleLabel = linkedComponent(Example.select((s) => s.label), ({ label }: any) => (
+  <Text>{label}</Text>
+));
+
+type Node = { type: string; children: (Node | string)[] | null };
+
+function lowercaseHostTypes(tree: Node | Node[] | null): string[] {
+  const found: string[] = [];
+  const visit = (node: Node | string | null) => {
+    if (!node || typeof node === 'string') return;
+    if (/^[a-z]/.test(node.type)) found.push(node.type);
+    node.children?.forEach(visit);
+  };
+  (Array.isArray(tree) ? tree : [tree]).forEach(visit);
+  return found;
+}
+
+const flush = () => new Promise((resolve) => setTimeout(resolve, 0));
+
+describe('Linked render defaults on React Native', () => {
+  test('a loading component renders only React Native elements', async () => {
+    mode = 'loading';
+    await render(<ExampleLabel of={{ id: 'urn:example:1' }} />);
+
+    expect(lowercaseHostTypes(screen.toJSON() as any)).toEqual([]);
+    expect(screen.getByTestId('linked-loader')).toBeTruthy();
+  });
+
+  test('a failed component renders only React Native elements', async () => {
+    mode = 'error';
+    await render(<ExampleLabel of={{ id: 'urn:example:1' }} />);
+    // Let the rejected query settle and the component re-render into its error state.
+    await act(flush);
+
+    expect(lowercaseHostTypes(screen.toJSON() as any)).toEqual([]);
+    expect(screen.getByTestId('linked-error')).toBeTruthy();
+  });
+});

package/defaults/app-react-native/apps/mobile/__tests__/shapes.test.ts

@@ -0,0 +1,27 @@
+import { Shape } from '@_linked/core/shapes/Shape';
+import { getShapeClass } from '@_linked/core/utils/ShapeClass';
+import { Example } from 'app-shapes';
+
+// A @linkedShape-decorated class gains static packageName, targetClass and shape;
+// shape.id is the key into the global shape registry.
+describe('shapes package', () => {
+  test('exports the shape class', () => {
+    expect(typeof Example).toBe('function');
+  });
+
+  test('the shape class extends Shape', () => {
+    expect(Example.prototype instanceof Shape).toBe(true);
+  });
+
+  test('the shape belongs to the shapes package', () => {
+    expect((Example as any).packageName).toBe('app-shapes');
+  });
+
+  test('the shape is registered at runtime', () => {
+    expect(getShapeClass((Example as any).shape.id)).toBe(Example);
+  });
+
+  test('the decorated properties are registered', () => {
+    expect([...(Example as any).shape.propertyShapes].length).toBeGreaterThan(0);
+  });
+});

package/defaults/app-react-native/apps/mobile/app.json

@@ -0,0 +1,14 @@
+{
+  "expo": {
+    "name": "App",
+    "slug": "app",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "userInterfaceStyle": "light",
+    "platforms": ["ios"],
+    "ios": {
+      "supportsTablet": true,
+      "bundleIdentifier": "com.example.app"
+    }
+  }
+}

package/defaults/app-react-native/apps/mobile/gitignore.template

@@ -0,0 +1,41 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+# generated native folders
+/ios
+/android

package/defaults/app-react-native/apps/mobile/index.ts

@@ -0,0 +1,8 @@
+import { registerRootComponent } from 'expo';
+
+import App from './App';
+
+// registerRootComponent calls AppRegistry.registerComponent('main', () => App);
+// It also ensures that whether you load the app in Expo Go or in a native build,
+// the environment is set up appropriately
+registerRootComponent(App);

package/defaults/app-react-native/apps/mobile/metro.config.js

@@ -0,0 +1,17 @@
+const { getDefaultConfig } = require('expo/metro-config');
+const path = require('path');
+
+const projectRoot = __dirname;
+const workspaceRoot = path.resolve(projectRoot, '../..');
+const config = getDefaultConfig(projectRoot);
+
+config.watchFolders = [workspaceRoot];
+config.resolver.nodeModulesPaths = [
+  path.resolve(projectRoot, 'node_modules'),
+  path.resolve(workspaceRoot, 'node_modules'),
+];
+// Covers the require() path into @_linked/* subpaths. Do not add disableHierarchicalLookup:
+// it breaks npm workspaces, which nest some dependencies (e.g. expo-asset under expo).
+config.resolver.unstable_conditionNames = ['react-native', 'import', 'require'];
+
+module.exports = config;

package/defaults/app-react-native/apps/mobile/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "mobile",
+  "version": "1.0.0",
+  "private": true,
+  "main": "index.ts",
+  "scripts": {
+    "start": "expo start",
+    "ios": "expo run:ios",
+    "android": "expo run:android",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@_linked/core": "2.18.0",
+    "@_linked/react": "1.4.2",
+    "app-shapes": "*",
+    "expo": "57.0.22",
+    "expo-dev-client": "57.0.19",
+    "react": "19.2.3",
+    "react-native": "0.86.3"
+  },
+  "devDependencies": {
+    "@react-native/jest-preset": "0.86.3",
+    "@testing-library/react-native": "14.0.1",
+    "@types/jest": "29.5.14",
+    "@types/react": "19.2.18",
+    "jest": "29.7.0",
+    "jest-expo": "57.0.5",
+    "test-renderer": "1.2.0",
+    "typescript": "6.0.3"
+  },
+  "jest": {
+    "preset": "jest-expo",
+    "transformIgnorePatterns": [
+      "node_modules/(?!((jest-)?react-native|@react-native(-community)?|expo(nent)?|@expo(nent)?/.*|@expo-google-fonts/.*|react-navigation|@react-navigation/.*|@unimodules/.*|unimodules|sentry-expo|native-base|react-native-svg|@_linked/.*|app-shapes))"
+    ],
+    "moduleNameMapper": {
+      "^@_linked/([^/]+)$": "<rootDir>/../../node_modules/@_linked/$1/lib/esm/index.js",
+      "^@_linked/([^/]+)/(.*)$": "<rootDir>/../../node_modules/@_linked/$1/lib/esm/$2.js"
+    }
+  }
+}

package/defaults/app-react-native/apps/mobile/src/shell/linkedDefaults.tsx

@@ -0,0 +1,10 @@
+// @_linked/react's built-in loader and error elements render <svg>, which crashes on React Native
+// ("View config getter callback for component 'svg'"). Replace them app-wide. App.tsx imports this
+// module first. Delete it once @_linked/react ships React Native defaults.
+import { LinkedComponentDefaults } from '@_linked/react';
+import { ActivityIndicator, Text } from 'react-native';
+
+LinkedComponentDefaults.loader = <ActivityIndicator testID="linked-loader" />;
+LinkedComponentDefaults.errorElement = (
+  <Text testID="linked-error" accessibilityRole="alert">Failed to load</Text>
+);

package/defaults/app-react-native/apps/mobile/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "experimentalDecorators": true,
+    "types": ["jest"]
+  }
+}

package/defaults/app-react-native/gitignore.template

@@ -0,0 +1,6 @@
+node_modules/
+# Workspace packages are enumerated; `packages/*` (not `packages/`) so the negation below works.
+packages/*
+!packages/app-shapes/
+.expo/
+dist/

package/defaults/app-react-native/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "app-monorepo",
+  "private": true,
+  "workspaces": [
+    "apps/mobile",
+    "services/api",
+    "packages/app-shapes"
+  ],
+  "overrides": {
+    "@_linked/react": {
+      "react": "19.2.3"
+    }
+  }
+}

package/defaults/app-react-native/packages/app-shapes/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "app-shapes",
+  "version": "0.0.0",
+  "private": true,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "dependencies": {
+    "@_linked/core": "2.18.0"
+  }
+}

package/defaults/app-react-native/packages/app-shapes/src/index.ts

@@ -0,0 +1,2 @@
+import './package';
+export * from './shapes/Example';

package/defaults/app-react-native/packages/app-shapes/src/package.ts

@@ -0,0 +1,10 @@
+import {linkedPackage} from '@_linked/core/utils/Package';
+
+export const {
+  linkedShape,
+  registerPackageExport,
+  registerPackageModule,
+  packageExports,
+  packageName,
+  getPackageShape,
+} = linkedPackage('app-shapes');

package/defaults/app-react-native/packages/app-shapes/src/shapes/Example.ts

@@ -0,0 +1,17 @@
+import {Shape} from '@_linked/core/shapes/Shape';
+import {literalProperty} from '@_linked/core/shapes/SHACL';
+import {createNameSpace} from '@_linked/core/utils/NameSpace';
+// Extensionless on purpose: Metro does not map `.js` specifiers to `.ts` source.
+import {linkedShape} from '../package';
+
+const ns = createNameSpace('https://example.com/app/');
+
+@linkedShape
+export class Example extends Shape {
+  static targetClass = ns('Example');
+
+  @literalProperty({path: ns('label'), maxCount: 1})
+  get label(): string {
+    return '';
+  }
+}

package/defaults/app-react-native/packages/app-shapes/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "experimentalDecorators": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}

package/defaults/app-react-native/services/api/README.md

@@ -0,0 +1,4 @@
+# api
+
+Placeholder for the backend service. It is a workspace so the monorepo layout is stable; the server, its
+storage configuration and its dependency on the shapes package are added when the backend is built.

package/defaults/app-react-native/services/api/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "api",
+  "private": true,
+  "version": "0.0.0"
+}

package/defaults/package/npmignore.template

@@ -0,0 +1,6 @@
+**/node_modules
+src
+.idea
+Gruntfile.js
+tsconfig.json
+tsconfig-es5.json

package/defaults/package/src/backend.ts

@@ -0,0 +1,5 @@
+// Register this package's shapes on the backend boot path so they materialize into app-data.
+import './shapes/index.js';
+
+//export all your providers from this package here
+//Format: export * from './shapes/SomeShapeProvider.js';

package/defaults/package/src/data/example-ontology.json

@@ -0,0 +1,10 @@
+{
+  "@context": {
+    "dc": "http://purl.org/dc/elements/1.1/",
+    "owl": "http://www.w3.org/2002/07/owl#",
+    "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
+    "${hyphen_name}": "${uri_base}"
+  },
+  "@graph": []
+}

package/defaults/package/src/data/example-ontology.json.d.ts

@@ -0,0 +1 @@
+export var json: string;

package/defaults/package/src/index.ts

@@ -0,0 +1,8 @@
+import './types.js';
+import './ontologies/${hyphen_name}.js';
+
+//SHAPES FIRST — all shapes register via the barrel
+import './shapes/index.js';
+
+//THEN COMPONENTS
+// import './components/YourComponent';

package/defaults/package/src/ontologies/example-ontology.ts

@@ -0,0 +1,42 @@
+import type {NodeReferenceValue} from '@_linked/core/utils/NodeReference';
+import {createNameSpace} from '@_linked/core/utils/NameSpace';
+import {linkedOntology} from '../package.js';
+//import all the exports of this file as one variable called _this (we need this at the end)
+import * as _this from './${hyphen_name}.js';
+
+/**
+ * Load the data of this ontology into memory, thus adding the properties of the entities of this ontology to the local graph.
+ */
+export var loadData = () => {
+  if (typeof module !== 'undefined' && typeof exports !== 'undefined') {
+    // CommonJS import
+    return import('../data/${hyphen_name}.json');
+  } else {
+    // ESM import
+    //@ts-ignore
+    return import('../data/${hyphen_name}.json',{ with: { type: "json" } }).then((data) => data.defauilt);
+  }
+};
+
+/**
+ * The namespace of this ontology, which can be used to create NamedNodes with IRIs not listed in this file
+ */
+export var ns = createNameSpace('${uri_base}');
+
+/**
+ * A reference to the ontology itself.
+ */
+export var _self: NodeReferenceValue = ns('');
+
+//Every class and property of this ontology, each exported as a node reference.
+// export var ExampleClass: NodeReferenceValue = ns('ExampleClass');
+// export var exampleProperty: NodeReferenceValue = ns('exampleProperty');
+
+//An extra grouping object so all the entities can be accessed from the prefix/name
+export const ${camel_name} = {
+  // ExampleClass,
+  // exampleProperty,
+};
+
+//Registers this ontology to LINCD.JS, so that data loading can be automated amongst other things
+linkedOntology(_this, ns, '${hyphen_name}', loadData, '../data/${hyphen_name}.json');

package/defaults/package/src/package.ts

@@ -0,0 +1,16 @@
+import {linkedPackage} from '@_linked/core/utils/Package';
+
+// `linkedComponent` is deliberately not destructured here: it is not part of core's
+// `LinkedPackageObject`. Component binding lives in `@_linked/react` — import
+// `linkedComponent` from `@_linked/react/utils/LinkedComponent` in a package that needs it,
+// so a package with no UI does not depend on React to declare its shapes.
+export const {
+  linkedShape,
+  linkedUtil,
+  linkedOntology,
+  registerPackageExport,
+  packageExports,
+  packageName,
+  getPackageShape
+
+} = linkedPackage('${package_name}');