Libraries

MyExpansion/
├── lib/
│   └── greeting-kit/
│       ├── lib.ts          export const libId = 'greeter'
│       └── shout.ts
└── src/
    └── pages/Page.tsx      import greeter from 'greeter'

import { shout } from './shout'

export const libId = 'greeter'

export function greet(who: string) {
  return shout(`hello ${who}`)
}

export default { greet }

import greeter from 'greeter'
import { shout } from 'greeter/shout'

​

Rules

• A folder under lib/ is a library when it contains lib.ts, lib.tsx, lib.js or lib.jsx.
• Its name is whatever that file exports as libId. Without one, the folder name is used, so lib/helpers/lib.ts is import x from 'helpers'.
• libId is read from your source without running it, so it must be a plain string literal.
• Names are letters, digits, _ and -.
• Other files in the library are reachable by subpath: greeter/shout, greeter/nested/thing.
• Two libraries cannot share a name, and a lib/ folder without an entry file is an error. Both are reported when the expansion loads, naming the folder.

​

What they are, and are not

​

Editor support