summaryrefslogtreecommitdiff
path: root/examples/js
diff options
context:
space:
mode:
Diffstat (limited to 'examples/js')
-rw-r--r--examples/js/.gitignore1
-rw-r--r--examples/js/applauncher/README.md5
-rw-r--r--examples/js/applauncher/app.ts9
-rw-r--r--examples/js/applauncher/style.scss1
-rw-r--r--examples/js/applauncher/widget/Applauncher.scss59
-rw-r--r--examples/js/applauncher/widget/Applauncher.tsx87
-rw-r--r--examples/js/media-player/README.md5
-rw-r--r--examples/js/media-player/app.ts11
-rw-r--r--examples/js/media-player/style.scss1
-rw-r--r--examples/js/media-player/widget/MediaPlayer.scss56
-rw-r--r--examples/js/media-player/widget/MediaPlayer.tsx94
-rw-r--r--examples/js/notifications/README.md5
-rw-r--r--examples/js/notifications/app.ts9
-rw-r--r--examples/js/notifications/notifications/Notification.scss125
-rw-r--r--examples/js/notifications/notifications/Notification.tsx107
-rw-r--r--examples/js/notifications/notifications/NotificationPopups.tsx105
-rw-r--r--examples/js/notifications/style.scss1
-rw-r--r--examples/js/simple-bar/.gitignore2
18 files changed, 681 insertions, 2 deletions
diff --git a/examples/js/.gitignore b/examples/js/.gitignore
index 261d669..d53b85b 100644
--- a/examples/js/.gitignore
+++ b/examples/js/.gitignore
@@ -2,5 +2,6 @@
tsconfig.json
env.d.ts
dist/
+node_modules/
package.json
package-lock.json
diff --git a/examples/js/applauncher/README.md b/examples/js/applauncher/README.md
new file mode 100644
index 0000000..682adf1
--- /dev/null
+++ b/examples/js/applauncher/README.md
@@ -0,0 +1,5 @@
+# Applauncher
+
+![launcher](https://github.com/user-attachments/assets/2695e3bb-dff4-478a-b392-279fe638bfd3)
+
+Using [Apps](https://aylur.github.io/astal/guide/libraries/apps).
diff --git a/examples/js/applauncher/app.ts b/examples/js/applauncher/app.ts
new file mode 100644
index 0000000..d6c9e1c
--- /dev/null
+++ b/examples/js/applauncher/app.ts
@@ -0,0 +1,9 @@
+import { App } from "astal/gtk3"
+import style from "./style.scss"
+import Applauncher from "./widget/Applauncher"
+
+App.start({
+ instanceName: "launcher",
+ css: style,
+ main: Applauncher,
+})
diff --git a/examples/js/applauncher/style.scss b/examples/js/applauncher/style.scss
new file mode 100644
index 0000000..ba13eed
--- /dev/null
+++ b/examples/js/applauncher/style.scss
@@ -0,0 +1 @@
+@use "./widget/Applauncher.scss"
diff --git a/examples/js/applauncher/widget/Applauncher.scss b/examples/js/applauncher/widget/Applauncher.scss
new file mode 100644
index 0000000..ae2453d
--- /dev/null
+++ b/examples/js/applauncher/widget/Applauncher.scss
@@ -0,0 +1,59 @@
+@use "sass:string";
+
+@function gtkalpha($c, $a) {
+ @return string.unquote("alpha(#{$c},#{$a})");
+}
+
+// https://gitlab.gnome.org/GNOME/gtk/-/blob/gtk-3-24/gtk/theme/Adwaita/_colors-public.scss
+$fg-color: #{"@theme_fg_color"};
+$bg-color: #{"@theme_bg_color"};
+
+window#launcher {
+ all: unset;
+
+ box.Applauncher {
+ background-color: $bg-color;
+ border-radius: 11px;
+ margin: 1rem;
+ padding: .8rem;
+ box-shadow: 2px 3px 8px 0 gtkalpha(black, .4);
+
+ entry {
+ margin-bottom: .8rem;
+ }
+
+ button {
+ min-width: 0;
+ min-height: 0;
+ padding: .5rem;
+
+ icon {
+ font-size: 3em;
+ margin-right: .3rem;
+ }
+
+ label.name {
+ font-weight: bold;
+ font-size: 1.1em
+ }
+
+ label.description {
+ color: gtkalpha($fg-color, .8);
+ }
+ }
+
+ box.not-found {
+ padding: 1rem;
+
+ icon {
+ font-size: 6em;
+ color: gtkalpha($fg-color, .7);
+ }
+
+ label {
+ color: gtkalpha($fg-color, .9);
+ font-size: 1.2em;
+ }
+ }
+ }
+}
diff --git a/examples/js/applauncher/widget/Applauncher.tsx b/examples/js/applauncher/widget/Applauncher.tsx
new file mode 100644
index 0000000..c7bac68
--- /dev/null
+++ b/examples/js/applauncher/widget/Applauncher.tsx
@@ -0,0 +1,87 @@
+import Apps from "gi://AstalApps"
+import { App, Astal, Gdk, Gtk } from "astal/gtk3"
+import { Variable } from "astal"
+
+const MAX_ITEMS = 8
+
+function hide() {
+ App.get_window("launcher")!.hide()
+}
+
+function AppButton({ app }: { app: Apps.Application }) {
+ return <button
+ className="AppButton"
+ onClicked={() => { hide(); app.launch() }}>
+ <box>
+ <icon icon={app.iconName} />
+ <box valign={Gtk.Align.CENTER} vertical>
+ <label
+ className="name"
+ truncate
+ xalign={0}
+ label={app.name}
+ />
+ {app.description && <label
+ className="description"
+ wrap
+ xalign={0}
+ label={app.description}
+ />}
+ </box>
+ </box>
+ </button>
+}
+
+export default function Applauncher() {
+ const { CENTER } = Gtk.Align
+ const apps = new Apps.Apps()
+
+ const text = Variable("")
+ const list = text(text => apps.fuzzy_query(text).slice(0, MAX_ITEMS))
+ const onEnter = () => {
+ apps.fuzzy_query(text.get())?.[0].launch()
+ hide()
+ }
+
+ return <window
+ name="launcher"
+ anchor={Astal.WindowAnchor.TOP | Astal.WindowAnchor.BOTTOM}
+ exclusivity={Astal.Exclusivity.IGNORE}
+ keymode={Astal.Keymode.ON_DEMAND}
+ application={App}
+ onShow={() => text.set("")}
+ onKeyPressEvent={function (self, event: Gdk.Event) {
+ if (event.get_keyval()[1] === Gdk.KEY_Escape)
+ self.hide()
+ }}>
+ <box>
+ <eventbox widthRequest={4000} expand onClick={hide} />
+ <box hexpand={false} vertical>
+ <eventbox heightRequest={100} onClick={hide} />
+ <box widthRequest={500} className="Applauncher" vertical>
+ <entry
+ placeholderText="Search"
+ text={text()}
+ onChanged={self => text.set(self.text)}
+ onActivate={onEnter}
+ />
+ <box spacing={6} vertical>
+ {list.as(list => list.map(app => (
+ <AppButton app={app} />
+ )))}
+ </box>
+ <box
+ halign={CENTER}
+ className="not-found"
+ vertical
+ visible={list.as(l => l.length === 0)}>
+ <icon icon="system-search-symbolic" />
+ <label label="No match found" />
+ </box>
+ </box>
+ <eventbox expand onClick={hide} />
+ </box>
+ <eventbox widthRequest={4000} expand onClick={hide} />
+ </box>
+ </window>
+}
diff --git a/examples/js/media-player/README.md b/examples/js/media-player/README.md
new file mode 100644
index 0000000..4e3d237
--- /dev/null
+++ b/examples/js/media-player/README.md
@@ -0,0 +1,5 @@
+# Media Player
+
+![mpris](https://github.com/user-attachments/assets/891e9706-74db-4505-bd83-c3628d7b4fd0)
+
+Using [Mpris](https://aylur.github.io/astal/guide/libraries/mpris).
diff --git a/examples/js/media-player/app.ts b/examples/js/media-player/app.ts
new file mode 100644
index 0000000..5b7558a
--- /dev/null
+++ b/examples/js/media-player/app.ts
@@ -0,0 +1,11 @@
+import { App, Widget } from "astal/gtk3"
+import style from "./style.scss"
+import MprisPlayers from "./widget/MediaPlayer"
+
+App.start({
+ instanceName: "players",
+ css: style,
+ main: () => {
+ new Widget.Window({}, MprisPlayers())
+ }
+})
diff --git a/examples/js/media-player/style.scss b/examples/js/media-player/style.scss
new file mode 100644
index 0000000..2e2f625
--- /dev/null
+++ b/examples/js/media-player/style.scss
@@ -0,0 +1 @@
+@use "./widget/MediaPlayer.scss";
diff --git a/examples/js/media-player/widget/MediaPlayer.scss b/examples/js/media-player/widget/MediaPlayer.scss
new file mode 100644
index 0000000..e1597c2
--- /dev/null
+++ b/examples/js/media-player/widget/MediaPlayer.scss
@@ -0,0 +1,56 @@
+// https://gitlab.gnome.org/GNOME/gtk/-/blob/gtk-3-24/gtk/theme/Adwaita/_colors-public.scss
+$fg-color: #{"@theme_fg_color"};
+$bg-color: #{"@theme_bg_color"};
+
+window {
+ all: unset;
+}
+
+box.MediaPlayer {
+ padding: .6rem;
+ background-color: $bg-color;
+
+ box.cover-art {
+ min-width: 120px;
+ min-height: 120px;
+ border-radius: 9px;
+ margin-right: .6rem;
+ background-size: contain;
+ background-position: center;
+ }
+
+ box.title {
+ label {
+ font-weight: bold;
+ font-size: 1.1em;
+ }
+ }
+
+ scale {
+ padding: 0;
+ margin: .4rem 0;
+
+ trough {
+ min-height: 8px;
+ }
+
+ highlight {
+ background-color: $fg-color;
+ }
+
+ slider {
+ all: unset;
+ }
+ }
+
+ centerbox.actions {
+ min-width: 220px;
+
+ button {
+ min-width: 0;
+ min-height: 0;
+ padding: .4rem;
+ margin: 0 .2rem;
+ }
+ }
+}
diff --git a/examples/js/media-player/widget/MediaPlayer.tsx b/examples/js/media-player/widget/MediaPlayer.tsx
new file mode 100644
index 0000000..06c7e77
--- /dev/null
+++ b/examples/js/media-player/widget/MediaPlayer.tsx
@@ -0,0 +1,94 @@
+import { Astal, Gtk } from "astal/gtk3"
+import Mpris from "gi://AstalMpris"
+import { bind } from "astal"
+
+function lengthStr(length: number) {
+ const min = Math.floor(length / 60)
+ const sec = Math.floor(length % 60)
+ const sec0 = sec < 10 ? "0" : ""
+ return `${min}:${sec0}${sec}`
+}
+
+
+function MediaPlayer({ player }: { player: Mpris.Player }) {
+ const { START, END } = Gtk.Align
+
+ const title = bind(player, "title").as(t =>
+ t || "Unknown Track")
+
+ const artist = bind(player, "artist").as(a =>
+ a || "Unknown Artist")
+
+ const coverArt = bind(player, "coverArt").as(c =>
+ `background-image: url('${c}')`)
+
+ const playerIcon = bind(player, "entry").as(e =>
+ Astal.Icon.lookup_icon(e) ? e : "audio-x-generic-symbolic")
+
+ const position = bind(player, "position").as(p => player.length > 0
+ ? p / player.length : 0)
+
+ const playIcon = bind(player, "playbackStatus").as(s =>
+ s === Mpris.PlaybackStatus.PLAYING
+ ? "media-playback-pause-symbolic"
+ : "media-playback-start-symbolic"
+ )
+
+ return <box className="MediaPlayer">
+ <box className="cover-art" css={coverArt} />
+ <box vertical>
+ <box className="title">
+ <label truncate hexpand halign={START} label={title} />
+ <icon icon={playerIcon} />
+ </box>
+ <label halign={START} valign={START} vexpand wrap label={artist} />
+ <slider
+ visible={bind(player, "length").as(l => l > 0)}
+ onDragged={({ value }) => player.position = value * player.length}
+ value={position}
+ />
+ <centerbox className="actions">
+ <label
+ hexpand
+ className="position"
+ halign={START}
+ visible={bind(player, "length").as(l => l > 0)}
+ label={bind(player, "position").as(lengthStr)}
+ />
+ <box>
+ <button
+ onClicked={() => player.previous()}
+ visible={bind(player, "canGoPrevious")}>
+ <icon icon="media-skip-backward-symbolic" />
+ </button>
+ <button
+ onClicked={() => player.play_pause()}
+ visible={bind(player, "canControl")}>
+ <icon icon={playIcon} />
+ </button>
+ <button
+ onClicked={() => player.next()}
+ visible={bind(player, "canGoNext")}>
+ <icon icon="media-skip-forward-symbolic" />
+ </button>
+ </box>
+ <label
+ className="length"
+ hexpand
+ halign={END}
+ visible={bind(player, "length").as(l => l > 0)}
+ label={bind(player, "length").as(l => l > 0 ? lengthStr(l) : "0:00")}
+ />
+ </centerbox>
+ </box>
+ </box>
+}
+
+export default function MprisPlayers() {
+ const mpris = Mpris.get_default()
+ return <box vertical>
+ {bind(mpris, "players").as(arr => arr.map(player => (
+ <MediaPlayer player={player} />
+ )))}
+ </box>
+}
diff --git a/examples/js/notifications/README.md b/examples/js/notifications/README.md
new file mode 100644
index 0000000..60dad60
--- /dev/null
+++ b/examples/js/notifications/README.md
@@ -0,0 +1,5 @@
+# Notifications Popups
+
+![notifs](https://github.com/user-attachments/assets/0df0eddc-5c74-4af0-a694-48dc8ec6bb44)
+
+A replacement for dunst and other daemons using [Notifd](https://aylur.github.io/astal/guide/libraries/notifd).
diff --git a/examples/js/notifications/app.ts b/examples/js/notifications/app.ts
new file mode 100644
index 0000000..ed53292
--- /dev/null
+++ b/examples/js/notifications/app.ts
@@ -0,0 +1,9 @@
+import { App } from "astal/gtk3"
+import style from "./style.scss"
+import NotificationPopups from "./notifications/NotificationPopups"
+
+App.start({
+ instanceName: "notifications",
+ css: style,
+ main: () => App.get_monitors().map(NotificationPopups),
+})
diff --git a/examples/js/notifications/notifications/Notification.scss b/examples/js/notifications/notifications/Notification.scss
new file mode 100644
index 0000000..a32f08b
--- /dev/null
+++ b/examples/js/notifications/notifications/Notification.scss
@@ -0,0 +1,125 @@
+@use "sass:string";
+
+@function gtkalpha($c, $a) {
+ @return string.unquote("alpha(#{$c},#{$a})");
+}
+
+// https://gitlab.gnome.org/GNOME/gtk/-/blob/gtk-3-24/gtk/theme/Adwaita/_colors-public.scss
+$fg-color: #{"@theme_fg_color"};
+$bg-color: #{"@theme_bg_color"};
+$error: red;
+
+window.NotificationPopups {
+ all: unset;
+}
+
+eventbox.Notification {
+
+ &:first-child>box {
+ margin-top: 1rem;
+ }
+
+ &:last-child>box {
+ margin-bottom: 1rem;
+ }
+
+ // eventboxes can not take margins so we style its inner box instead
+ >box {
+ min-width: 400px;
+ border-radius: 13px;
+ background-color: $bg-color;
+ margin: .5rem 1rem .5rem 1rem;
+ box-shadow: 2px 3px 8px 0 gtkalpha(black, .4);
+ border: 1pt solid gtkalpha($fg-color, .03);
+ }
+
+ &.critical>box {
+ border: 1pt solid gtkalpha($error, .4);
+
+ .header {
+
+ .app-name {
+ color: gtkalpha($error, .8);
+
+ }
+
+ .app-icon {
+ color: gtkalpha($error, .6);
+ }
+ }
+ }
+
+ .header {
+ padding: .5rem;
+ color: gtkalpha($fg-color, 0.5);
+
+ .app-icon {
+ margin: 0 .4rem;
+ }
+
+ .app-name {
+ margin-right: .3rem;
+ font-weight: bold;
+
+ &:first-child {
+ margin-left: .4rem;
+ }
+ }
+
+ .time {
+ margin: 0 .4rem;
+ }
+
+ button {
+ padding: .2rem;
+ min-width: 0;
+ min-height: 0;
+ }
+ }
+
+ separator {
+ margin: 0 .4rem;
+ background-color: gtkalpha($fg-color, .1);
+ }
+
+ .content {
+ margin: 1rem;
+ margin-top: .5rem;
+
+ .summary {
+ font-size: 1.2em;
+ color: $fg-color;
+ }
+
+ .body {
+ color: gtkalpha($fg-color, 0.8);
+ }
+
+ .image {
+ border: 1px solid gtkalpha($fg-color, .02);
+ margin-right: .5rem;
+ border-radius: 9px;
+ min-width: 100px;
+ min-height: 100px;
+ background-size: cover;
+ background-position: center;
+ }
+ }
+
+ .actions {
+ margin: 1rem;
+ margin-top: 0;
+
+ button {
+ margin: 0 .3rem;
+
+ &:first-child {
+ margin-left: 0;
+ }
+
+ &:last-child {
+ margin-right: 0;
+ }
+ }
+ }
+}
diff --git a/examples/js/notifications/notifications/Notification.tsx b/examples/js/notifications/notifications/Notification.tsx
new file mode 100644
index 0000000..5149d5b
--- /dev/null
+++ b/examples/js/notifications/notifications/Notification.tsx
@@ -0,0 +1,107 @@
+import { GLib } from "astal"
+import { Gtk, Astal } from "astal/gtk3"
+import { type EventBox } from "astal/gtk3/widget"
+import Notifd from "gi://AstalNotifd"
+
+const isIcon = (icon: string) =>
+ !!Astal.Icon.lookup_icon(icon)
+
+const fileExists = (path: string) =>
+ GLib.file_test(path, GLib.FileTest.EXISTS)
+
+const time = (time: number, format = "%H:%M") => GLib.DateTime
+ .new_from_unix_local(time)
+ .format(format)!
+
+const urgency = (n: Notifd.Notification) => {
+ const { LOW, NORMAL, CRITICAL } = Notifd.Urgency
+ // match operator when?
+ switch (n.urgency) {
+ case LOW: return "low"
+ case CRITICAL: return "critical"
+ case NORMAL:
+ default: return "normal"
+ }
+}
+
+type Props = {
+ setup(self: EventBox): void
+ onHoverLost(self: EventBox): void
+ notification: Notifd.Notification
+}
+
+export default function Notification(props: Props) {
+ const { notification: n, onHoverLost, setup } = props
+ const { START, CENTER, END } = Gtk.Align
+
+ return <eventbox
+ className={`Notification ${urgency(n)}`}
+ setup={setup}
+ onHoverLost={onHoverLost}>
+ <box vertical>
+ <box className="header">
+ {(n.appIcon || n.desktopEntry) && <icon
+ className="app-icon"
+ visible={Boolean(n.appIcon || n.desktopEntry)}
+ icon={n.appIcon || n.desktopEntry}
+ />}
+ <label
+ className="app-name"
+ halign={START}
+ truncate
+ label={n.appName || "Unknown"}
+ />
+ <label
+ className="time"
+ hexpand
+ halign={END}
+ label={time(n.time)}
+ />
+ <button onClicked={() => n.dismiss()}>
+ <icon icon="window-close-symbolic" />
+ </button>
+ </box>
+ <Gtk.Separator visible />
+ <box className="content">
+ {n.image && fileExists(n.image) && <box
+ valign={START}
+ className="image"
+ css={`background-image: url('${n.image}')`}
+ />}
+ {n.image && isIcon(n.image) && <box
+ expand={false}
+ valign={START}
+ className="icon-image">
+ <icon icon={n.image} expand halign={CENTER} valign={CENTER} />
+ </box>}
+ <box vertical>
+ <label
+ className="summary"
+ halign={START}
+ xalign={0}
+ label={n.summary}
+ truncate
+ />
+ {n.body && <label
+ className="body"
+ wrap
+ useMarkup
+ halign={START}
+ xalign={0}
+ justifyFill
+ label={n.body}
+ />}
+ </box>
+ </box>
+ {n.get_actions().length > 0 && <box className="actions">
+ {n.get_actions().map(({ label, id }) => (
+ <button
+ hexpand
+ onClicked={() => n.invoke(id)}>
+ <label label={label} halign={CENTER} hexpand />
+ </button>
+ ))}
+ </box>}
+ </box>
+ </eventbox>
+}
diff --git a/examples/js/notifications/notifications/NotificationPopups.tsx b/examples/js/notifications/notifications/NotificationPopups.tsx
new file mode 100644
index 0000000..a8088c9
--- /dev/null
+++ b/examples/js/notifications/notifications/NotificationPopups.tsx
@@ -0,0 +1,105 @@
+import { Astal, Gtk, Gdk } from "astal/gtk3"
+import Notifd from "gi://AstalNotifd"
+import Notification from "./Notification"
+import { type Subscribable } from "astal/binding"
+import { GLib, Variable, bind, timeout } from "astal"
+
+// see comment below in constructor
+const TIMEOUT_DELAY = 5000
+
+// The purpose if this class is to replace Variable<Array<Widget>>
+// with a Map<number, Widget> type in order to track notification widgets
+// by their id, while making it conviniently bindable as an array
+class NotifiationMap implements Subscribable {
+ // the underlying map to keep track of id widget pairs
+ private map: Map<number, Gtk.Widget> = new Map()
+
+ // it makes sense to use a Variable under the hood and use its
+ // reactivity implementation instead of keeping track of subscribers ourselves
+ private var: Variable<Array<Gtk.Widget>> = Variable([])
+
+ // notify subscribers to rerender when state changes
+ private notifiy() {
+ this.var.set([...this.map.values()].reverse())
+ }
+
+ private constructor() {
+ const notifd = Notifd.get_default()
+
+ /**
+ * uncomment this if you want to
+ * ignore timeout by senders and enforce our own timeout
+ * note that if the notification has any actions
+ * they might not work, since the sender already treats them as resolved
+ */
+ // notifd.ignoreTimeout = true
+
+ notifd.connect("notified", (_, id) => {
+ this.set(id, Notification({
+ notification: notifd.get_notification(id)!,
+
+ // once hovering over the notification is done
+ // destroy the widget without calling notification.dismiss()
+ // so that it acts as a "popup" and we can still display it
+ // in a notification center like widget
+ // but clicking on the close button will close it
+ onHoverLost: () => this.delete(id),
+
+ // notifd by default does not close notifications
+ // until user input or the timeout specified by sender
+ // which we set to ignore above
+ setup: () => timeout(TIMEOUT_DELAY, () => {
+ /**
+ * uncomment this if you want to "hide" the notifications
+ * after TIMEOUT_DELAY
+ */
+ // this.delete(id)
+ })
+ }))
+ })
+
+ // notifications can be closed by the outside before
+ // any user input, which have to be handled too
+ notifd.connect("resolved", (_, id) => {
+ this.delete(id)
+ })
+ }
+
+ private set(key: number, value: Gtk.Widget) {
+ // in case of replacecment destroy previous widget
+ this.map.get(key)?.destroy()
+ this.map.set(key, value)
+ this.notifiy()
+ }
+
+ private delete(key: number) {
+ this.map.get(key)?.destroy()
+ this.map.delete(key)
+ this.notifiy()
+ }
+
+ // needed by the Subscribable interface
+ get() {
+ return this.var.get()
+ }
+
+ // needed by the Subscribable interface
+ subscribe(callback: (list: Array<Gtk.Widget>) => void) {
+ return this.var.subscribe(callback)
+ }
+}
+
+export default function NotificationPopups(gdkmonitor: Gdk.Monitor) {
+ const { TOP, RIGHT } = Astal.WindowAnchor
+ const notifs = new NotifiationMap()
+
+ return <window
+ className="NotificationPopups"
+ gdkmonitor={gdkmonitor}
+ exclusivity={Astal.Exclusivity.EXCLUSIVE}
+ anchor={TOP | RIGHT}>
+ <box vertical>
+ {bind(notifs)}
+ </box>
+ </window>
+}
diff --git a/examples/js/notifications/style.scss b/examples/js/notifications/style.scss
new file mode 100644
index 0000000..7ef0168
--- /dev/null
+++ b/examples/js/notifications/style.scss
@@ -0,0 +1 @@
+@use "./notifications/Notification.scss";
diff --git a/examples/js/simple-bar/.gitignore b/examples/js/simple-bar/.gitignore
deleted file mode 100644
index 6850183..0000000
--- a/examples/js/simple-bar/.gitignore
+++ /dev/null
@@ -1,2 +0,0 @@
-@girs/
-node_modules/ \ No newline at end of file